Asystent AI Hermes – instalacja, konfiguracja, przepływ pracy i rozwiązywanie problemów

Hermes Agent to samodzielnie hostowany, niezależny od modelu asystent AI, który działa na lokalnym komputerze lub tangu VPS, współpracuje przez interfejsy terminalowe i komunikacyjne oraz z czasem się ulepsza, przekształcając powtarzalne zadania w wielokrotnego użytku umiejętności.

Jego funkcjonalność jest bardzo podobna do OpenClaw, kolejnego samodzielnie hostowanego stosu asystenta opartego na narzędziach, pamięci i lokalnej kontroli. Wielu programistów znalazło drogę do Hermes po tym, jak Anthropic zablokował dostęp do subskrypcji Claude dla OpenClaw w kwietniu 2026 roku – oś czasu wzrostu i upadku OpenClaw wyjaśnia, dlaczego Hermes stał się naturalnym miejscem docelowym dla użytkowników chcących utrzymywać trwałą, samodzielnie hostowaną automatyzację bez zależności od dostawcy.

Jeśli chcesz uzyskać szerszy obraz samodzielnie hostowanych asystentów, odzyskiwania danych i lokalnej infrastruktury wokół Hermes, ten przegląd systemów AI łączy te tematy z tymi samymi problemami, które Hermes próbuje rozwiązać.

Dla kompromisów wdrożeniowych i wyborów środowiska wykonawczego, Hosting LLM w 2026: Lokalne, samodzielne i chmurowe porównanie infrastruktury dostarcza mapę hostingową, podczas gdy Wydajność LLM w 2026: Testy porównawcze, wąskie gardła i optymalizacja omawia stronę przepustowości i opóźnień, gdy Hermes już działa.

Moja stronnicza opinia: Hermes jest najbardziej interesujący, gdy traktowany jako infrastruktura, a nie karta, którą okazjonalnie otwierasz. Gdy działa jako usługa i ma stabilny katalog domowy, Twoje polecenia zaczynają mniej przypominać „czat”, a bardziej „operacje".

Czym jest Hermes Agent i dlaczego to ważne

Hermes Agent to otwartoźródłowy agent AI stworzony przez Nous Research. Jest zaprojektowany do trwałego działania, używania narzędzi (terminal, pliki, web i więcej) oraz ulepszania swojego zachowania z czasem dzięki systemowi umiejętności i pamięci.

Dwa wybory projektowe warto wyraźnie zaznaczyć, ponieważ kształtują one wszystko inne w tym przewodniku.

Po pierwsze, Hermes nie jest przypisany do jednego dostawcy modelu. Oficjalny przepływ konfiguracji obsługuje wielu dostawców i dowolny punkt końcowy zgodny z OpenAI, a przełączanie odbywa się za pomocą polecenia hermes model, a nie poprzez edycję kodu.

Po drugie, Hermes rysuje wyraźną linię między „rozmową” a „wykonaniem". Agent może rozmawiać przez cały dzień, ale gdy potrzebuje działać, robi to poprzez wyraźne narzędzia i konfigurowalne środowisko wykonawcze. Tam mieszka bezpieczeństwo, powtarzalność i rozwiązywanie problemów.

Koszt i licencjonowanie są świeżo nudne. Sam Hermes Agent jest darmowym oprogramowaniem na licencji MIT. Jeśli używasz hostowanych modeli, bieżący koszt to to, co pobiera Twój dostawca. Jeśli uruchamiasz lokalne modele, możesz całkowicie uniknąć opłat za API.

Jeśli Twoje ustawienia Hermes używają Claude poprzez zewnętrzne warstw narzędzi, ta zmiana subskrypcji Anthropic jest użytecznym odniesieniem do tego, dlaczego rozliczenie oparte na API jest teraz oczekiwaną ścieżką.

Instalacja Hermes Agent

Hermes ma szybką ścieżkę instalacji dla Linux, macOS i WSL2. Oficjalna dokumentacja utrzymuje to celowo proste.

Instalacja Hermes na Linux

sudo apt-get update
sudo apt-get upgrade
sudo apt-get curl git
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Po instalacji przeładuj powłokę i uruchom CLI.

source ~/.bashrc   # lub source ~/.zshrc
hermes

Instalator to nie tylko cienka nakładka. Zgodnie z przewodnikiem instalacyjnym, ustawia on zależności, repozytorium, wirtualne środowisko oraz polecenie hermes, doprowadzając Cię do pierwszego stanu gotowego do czatu.

Uwagi dotyczące Windows i Android

Natywny Windows nie jest obsługiwany. Dokumentacja zaleca WSL2 i uruchamianie Hermes w jego wnętrzu.

Dla Androida, Hermes obsługuje ścieżkę instalacji Termux. Jest zaprojektowany tak, aby wykrywać Termux i dostosowywać ustawienia zależności i środowiska w odpowiedni sposób.

Szybki start

Najszybsze pierwsze uruchomienie to dosłownie tylko hermes, ale sensowny szybki start oznacza dwie dodatkowe decyzje: który dostawca modelu ma być użyty i które narzędzia powinny być włączone.

Wybierz dostawcę i model

Hermes udostępnia trzy uzupełniające się punkty wejścia:

• hermes model do wyboru dostawcy i domyślnego modelu
• hermes tools do włączania lub wyłączania zestawów narzędzi
• hermes setup do uruchomienia interaktywnego kreatora w głównych obszarach konfiguracji

Minimalny przepływ wygląda następująco:

hermes model
hermes tools
hermes

W kwestii tego, co jest faktycznie obsługiwane, oficjalny Szybki Start wymienia gamę dostawców i wskazuje również, że Hermes działa z API zgodnymi z OpenAI. To ma znaczenie, ponieważ obejmuje to zarówno usługi hostowane, jak i lokalne punkty końcowe.

Zweryfikuj wczesne wykonywanie narzędzi

Zanim stworzysz nawyki wokół Hermes, warto zweryfikować, że użycie narzędzi działa w Twoim środowisku. Szybki Start wyraźnie sugeruje użycie terminala jako pierwszej funkcji do przetestowania.

W praktyce, mały „test dymny" spełnia dwie funkcje: sprawdza narzędzie terminalowe i waliduje monity uprawnień.

Przykładowy prompt:

Pokaż użycie dysku i pięć największych katalogów.

Jeśli Hermes nie może uruchomić narzędzia terminalowego, przejdź do Rozwiązywania problemów. Nieprawidłowa konfiguracja środowiska terminalowego jest jedną z najczęstszych przyczyn, a rozwiązanie jest zwykle oczywiste, gdy spojrzysz na konfigurację.

Konfiguracja skalująca się

Hermes nagradza ludzi, którzy rozumieją, gdzie przechowuje stan i jak rozwiązuje konfigurację. To również miejsce, skąd pochodzą wiele problemów „działało wczoraj".

Gdzie mieszka konfiguracja i stan

Hermes przechowuje swoje ustawienia i stan w ~/.hermes. Oficjalny przewodnik konfiguracji dokumentuje układ, w tym config.yaml dla ustawień, .env dla sekretów, auth.json dla danych logowania OAuth, SOUL.md dla tożsamości oraz foldery dla pamięci, umiejętności, cron, sesji i logów.

To ma znaczenie z dwóch powodów.

• Debugowanie staje się mechaniczne, ponieważ wiesz dokładnie, gdzie szukać.
• Backupy stają się proste, ponieważ jeden katalog zawiera większość stanu agenta, który Cię interesuje.

Priorytet konfiguracji i utrzymanie sekretów poza config.yaml

Hermes rozwiązuje konfigurację z określonym porządkiem priorytetów. Na szczycie są nadpisanie CLI, następnie config.yaml, następnie .env, z wbudowanymi wartościami domyślnymi na dole.

Miłym szczegółem jest to, że hermes config set kieruje wartości do odpowiedniego pliku: klucze API do .env i niesecretowe ustawienia do config.yaml.

hermes config set model openrouter/meta-llama/llama-3.1-70b-instruct
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxx

Hermes obsługuje również podstawienie zmiennych środowiskowych wewnątrz config.yaml za pomocą składni ${VAR_NAME}. Jest to użyteczne, gdy chcesz utrzymać pewne wartości w środowisku, nadal odnosząc się do nich w strukturalnej konfiguracji.

Piaskownica i środowiska wykonawcze

Hermes obsługuje wiele środowisk terminalowych, które definiują, gdzie faktycznie uruchamiają się polecenia powłoki. Przewodnik konfiguracji wymienia lokalne, docker, ssh, modal, daytona i singularity.

Obiektywny, ale nie ewangelizujący sposób myślenia o tym to:

• local jest najszybszy i najprostszy, ale nie jest izolowany
• docker jest pragmatyczną warstwą bezpieczeństwa i powtarzalności
• ssh jest czystym sposobem oddzielenia urządzenia czatu od komputera
• modal i daytona pasują do przepływów pracy „serverless, ale wystarczająco trwałe"
• singularity jest opcją przyjazną dla HPC

Minimalny przykład środowiska Docker:

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_volumes:
    - "/home/user/projects:/workspace/projects"
  docker_forward_env:
    - "GITHUB_TOKEN"

Dokumentacja opisuje również zabezpieczanie środowiska Docker, takie jak usuwanie możliwości i wyłączanie eskalacji uprawnień.

Umiejętności, pamięć i profile

Hermes ma dwa powiązane mechanizmy akumulacji wartości.

Umiejętności to pamięć proceduralna. Hermes może tworzyć, aktualizować i usuwać własne umiejętności oraz może zaproponować zapisanie podejścia jako umiejętność po zakończeniu złożonego zadania.

Wbudowana pamięć jest przechowywana jako pliki takie jak MEMORY.md i USER.md w ~/.hermes, a Hermes może również używać zewnętrznych dostawców pamięci dla głębszego odzyskiwania. Dokumentacja pamięci wymienia wiele wtyczek dostawców, a przewodnik dostawców pamięci dokumentuje interaktywny przepływ konfiguracji. Pełne techniczne omówienie tego, jak działa architektura pamięci — zamrożone migawki, limity znaków, osiem zewnętrznych dostawców i filozofia za ograniczoną pamięcią — zobacz System pamięci Hermes Agent: Jak naprawdę działa trwała pamięć AI.

Jeśli chcesz wielu niezależnych agentów na tej samej maszynie, profile Hermes zapewniają izolację. Każdy profil otrzymuje własny katalog z własną konfiguracją, sekretami, pamięciami, sesjami, umiejętnościami, zadaniami cron i stanem bramki.

Dla głębszego spojrzenia na to, które umiejętności dobrze działają w produkcji według roli — inżynierowie, badacze, operatorzy i przepływy wykonawcze — zobacz Umiejętności asystenta AI Hermes dla prawdziwych ustawień produkcyjnych.

Typowy przepływ pracy

Jeśli traktujesz Hermesa jako agenta, którego będziesz utrzymywać, przepływ pracy zaczyna przypominać inżynierię usług.

Stabilna baza

Baza, która nie ulega zepsuciu, to:

1. Zainstaluj i uruchom pierwszy czat w CLI.
2. Wybierz dostawcę i model za pomocą hermes model, a następnie potwierdź koszty.
3. Skonfiguruj zestawy narzędzi i zdecyduj, czy wykonanie terminala jest lokalne czy w piaskownicy.
4. Wnieś szybkie zmiany w SOUL.md dopiero po tym, jak przez jakiś czas użyjesz domyślnego. Zmiany tożsamości mają większe znaczenie, niż ludzie oczekują, ponieważ jest to „slot 1" w systemowym promptcie.

Codzienne użycie akumulujące się

Hermes ma interfejs terminalowy, a nie webowy, i jest zaprojektowany dla długich sesji z poleceniami slash, sesjami do wznowienia i strumieniowaniem wyników narzędzi.

W praktyce, użyteczny rytm to:

• uruchamiaj pracę w nazwanej sesji dla projektu
• kompresuj kontekst, gdy staje się on zbyt duży
• pozwól Hermesowi przekształcić powtarzalne rutyny w umiejętności
• utrzymuj umysłową granicę między „pytaniem" a „działaniem", aby wykonanie narzędzi pozostawało audytowalne

Brama komunikacyjna dla dostępu 24/7

Brama komunikacyjna to element, który sprawia, że Hermes czuje się jak asystent, a nie aplikacja terminalowa. Dokumentacja opisuje ją jako pojedynczy proces, który łączy się z wieloma platformami, obsługuje sesje, uruchamia zadania cron i dostarcza wiadomości.

Konfiguracja jest wywoływana za pomocą hermes gateway setup, a brama może działać na pierwszym planie lub jako usługa użytkownika. Referencja CLI dokumentuje podkomendy bramki takie jak run, install, start, stop, status i restart.

Bezpieczeństwo dla bota używającego narzędzi ma znaczenie. Dokumentacja bramki opisuje listy dozwolonych platform i przepływ parowania DM, który wydaj jednorazowe kody parowania i wymaga zatwierdzenia za pomocą hermes pairing approve.

Aktualizacje bez dramatów

Aktualizacje Hermes to komenda pierwszego rzutu. Przewodnik aktualizacyjny dokumentuje hermes update, kontrole migracji konfiguracji i małą rutinę walidacyjną po aktualizacji, w tym hermes doctor i hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Rozwiązywanie problemów i diagnostyka

Większość awarii Hermes nie jest tajemnicza. Wyglądają tajemniczo, ponieważ ludzie sprawdzają tylko warstwę modelu i ignorują warstwę środowiska wykonawczego.

Szybkie komendy triażowe

Referencja CLI wyraźnie pozycjonuje trzy komendy jako rdzeniową pętlę:

• hermes doctor dla interaktywnej diagnostyki
• hermes status dla szybkiego przeglądu
• hermes dump dla udostępnialnego, zredagowanego podsumowania ustawień

Dla logów, hermes logs wyświetla pliki przechowywane w ~/.hermes/logs.

hermes doctor --fix
hermes status
hermes dump --show-keys
hermes logs errors -f

Częste awarie instalacji

FAQ i przewodnik rozwiązywania problemów wymienia kilka nawracających problemów i ich rozwiązania, w tym problemy z wersją Pythona, brakujące uv i problemy z uprawnieniami spowodowane mieszaniem instalacji sudo z instalacjami użytkownika.

Jeśli napotkasz te błędy, dokumentacja dostarcza konkretnych kroków naprawczych, takich jak aktualizacja Pythona, instalacja uv i ponowna instalacja Hermes bez sudo.

Problemy z dostawcami i modelami

Gdy klucze API nie działają, FAQ zaleca sprawdzenie konfiguracji, ponowne uruchomienie hermes model lub ustawienie klucza bezpośrednio za pomocą hermes config set. Wskazuje również na powszechną pułapkę: klucze są specyficzne dla dostawcy.

Dla problemów „model nie znaleziony", FAQ odsyła do użycia hermes model do wyboru prawidłowego identyfikatora i pokazuje zarówno nadpisanie konfiguracji, jak i sesji.

Ograniczenia przepustowości i problemy z długością kontekstu są również omawiane. FAQ sugeruje oczekiwanie na błędy 429, przełączanie dostawców lub modeli oraz redukcję presji kontekstu poprzez kompresję lub nową sesję.

Problemy z środowiskiem terminalowym i bramką

Jeśli polecenia terminalowe zawodzą natychmiastowo, przewodnik konfiguracji zawiera sekcję „częste problemy z środowiskiem terminalowym" i wskazuje typowe przyczyny dla każdego środowiska, w tym brak uruchomionego Docker i brakujące zmienne SSH. Wspomina również, że powrót do lokalnego jest ważnym krokiem debugowania, gdy konfiguracja piaskownicy jest kwestionowana.

Dla problemów z bramką, przewodnik komunikacyjny podkreśla listy dozwolone i parowanie jako bezpieczne domyślne wartości, co oznacza, że wiele incydentów „bot jest cicho" to w rzeczywistości autoryzacja wykonująca swoją pracę.

Referencje

• Strona główna Hermes Agent
• System pamięci Hermes Agent: Jak naprawdę działa trwała pamięć AI
• Umiejętności asystenta AI Hermes dla prawdziwych ustawień produkcyjnych