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

Instalacja i szybki start agenta Hermes dla programistów

Page content

Hermes Agent to samodzielnie hostowany, agnostyczny względem modelu asystent AI, który działa na lokalnym komputerze lub tanim VPS, komunikuje się przez interfejs terminala i komunikatora oraz z czasem doskonali swoje działanie, zamieniając powtarzalne zadania w ponownie wykorzystywane umiejętności.

Swoim działaniem jest bardzo podobny do [OpenClaw](https://www.glukhov.org/pl/ai-systems/openclaw/ “Przypadek badawczy dotyczący OpenClaw — systemu asystenta AI hostowanego lokalnie, który integruje lokalne LLM, wyszukiwanie, pamięć, routing i obserwowalność w spójną infrastrukturę lokalną.), innego stosu asystenta hostowanego lokalnie, opartego na narzędziach, pamięci i kontroli lokalnej. Wielu deweloperów trafiło do Hermes po tym, jak Anthropic zablokowała dostęp do subskrypcji Claude dla OpenClaw w kwietniu 2026 roku — timeline wzrostu i upadku OpenClaw wyjaśnia, dlaczego Hermes stał się naturalnym miejscem docelowym dla użytkowników, którzy chcieli trwałej, samodzielnie hostowanej automatyzacji bez zależności od dostawcy.

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

W przypadku kompromisów wdrożeniowych i wyborów środowiska uruchomieniowego, Hosting LLM w 2026 roku: Infrastruktura lokalna, samodzielnie hostowana i chmurowa w porównaniu dostarcza mapę hostingową, podczas gdy Wydajność LLM w 2026 roku: Benchmarki, wąskie gardła i optymalizacja omawia stronę przepustowości i opóźnienia po uruchomieniu Hermes. Dla kompaktowej mapy poleceń powłoki (hermes gateway, hermes memory, hermes doctor, skróty slash i więcej), użyj Ściągacz CLI Hermes Agent.

peronal-ai-assistant on laptop

Moja stronnicza opinia: Hermes jest najciekawszy, gdy traktuje się go jako infrastrukturę, a nie jako zakładkę, którą okazjonalnie otwiera się. Gdy działa jako usługa i ma stabilny katalog domowy, Twoje prompty zaczynają wyglądać mniej jak „czat”, a bardziej jak „operacje”.

Czym jest Hermes Agent i dlaczego to ważne

Hermes Agent to agent AI open-source stworzony przez Nous Research. Został zaprojektowany do ciągłego działania, używania narzędzi (terminal, pliki, web i więcej) oraz poprawy swojego zachowania w czasie dzięki systemowi umiejętności i pamięci.

Warto wyjaśnić dwa wybory projektowe, ponieważ kształtują one wszystko inne w tym przewodniku.

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

Po drugie, Hermes wyostrza granicę 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.

Koszty i licencjonowanie są odświeżająco nudne. Sam Hermes Agent jest darmowym oprogramowaniem na licencji MIT. Jeśli używasz modeli hostowanych, bieżący koszt to to, co pobiera Twój dostawca. Jeśli uruchamiasz modele lokalnie, 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 przydatnym odniesieniem do tego, dlaczego rozliczanie 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 ją celowo prostą.

Instalacja Hermes na Linuksie

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 swoją 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 stanu gotowego do pierwszej rozmowy.

Uwagi dotyczące Windows i Android

Natywny Windows nie jest wspierany. Dokumentacja zaleca WSL2 i uruchamianie Hermes wewnątrz niego.

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

Szybki start

Najszybsze pierwsze uruchomienie to dosłownie tylko hermes, ale sensowny szybki start oznacza dwie dodatkowe decyzje: którego dostawcy modeli użyć i które narzędzia należy włączyć.

Wybierz dostawcę i model

Hermes eksponuje 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 przez główne obszary konfiguracji

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

hermes model
hermes tools
hermes

W kontekście tego, co jest naprawdę obsługiwane, oficjalny Szybki Start wymienia zakres dostawców i wskazuje również, że Hermes działa z API kompatybilnymi z OpenAI. To ma znaczenie, ponieważ obejmuje zarówno usługi hostowane, jak i punkty końcowe hostowane samodzielnie.

Zweryfikuj wykonywanie narzędzi wczesnie

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

W praktyce, mały prompt „testu dymnego” wykonuje dwie zadania: sprawdza narzędzie terminala i waliduje prompty uprawnień.

Przykładowy prompt:

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

Jeśli Hermes nie może uruchomić narzędzia terminala, przejdź do Rozwiązywania problemów. Nieprawidłowa konfiguracja backendu terminala jest jednym z najczęstszych przyczyn, a naprawa jest zwykle oczywista, gdy spojrzysz na konfigurację.

Konfiguracja skalująca się

Hermes nagradza tych, którzy rozumieją, gdzie przechowuje stan i jak rozwiązuje konfigurację. To też stąd pochodzą wiele problemów typu „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.

Ma to znaczenie z dwóch powodów.

Rozwiązywanie problemów staje się mechaniczne, ponieważ wiesz dokładnie, gdzie szukać.
Kopie zapasowe stają się proste, ponieważ jeden katalog zawiera większość stanu agenta, który Cię interesuje.

Priorytet konfiguracji i wykręcanie sekretów z config.yaml

Hermes rozwiązuje konfigurację z kolejnością priorytetów. Na górze są nadpisania 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ż podstawianie zmiennych środowiskowych wewnątrz config.yaml poprzez składnię ${VAR_NAME}. Jest to przydatne, gdy chcesz trzymać pewne wartości w środowisku, wciąż odwołując się do nich w strukturalnej konfiguracji.

Sandomik i backends wykonawcze

Hermes obsługuje wiele backendów terminalowych, które definiują, gdzie faktycznie uruchamiane są polecenia powłoki. Przewodnik konfiguracyjny wymienia local, docker, ssh, modal, daytona i singularity.

Subiektywny, ale nie ewangeliczny sposób myślenia o tym:

local jest najszybszy i najprostszy, ale nie jest izolowany
docker to pragmatyczna warstwa bezpieczeństwa i powtarzalności
ssh to czysty sposób oddzielenia urządzenia czatu od maszyny obliczeniowej
modal i daytona pasują do przepływów „serverless, ale wystarczająco trwałych”
singularity to opcja przyjazna HPC

Minimalny przykład backendu 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ż utwardzanie bezpieczeństwa dla backendu Docker, takie jak usuwanie możliwości i wyłączanie eskalacji przywilejów.

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 zaproponować zapisanie podejścia jako umiejętności 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 do głębszego przywołania. Dokumentacja pamięci wymienia wiele wtyczek dostawców, a przewodnik dostawców pamięci dokumentuje interaktywny przepływ konfiguracji. Dla pełnego technicznego rozkładu tego, jak działa architektura pamięci — zamrożone migawki, limity znaków, osiem zewnętrznych dostawców i filozofia za pamięcią ograniczoną — zobacz System Pamięci Hermes Agent: Jak 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 gateway.

Dla głębszego spojrzenia na to, które umiejętności dobrze działają w produkcji według roli — inżynierów, badaczy, operatorów i przepływów wykonawczych — zobacz Umiejętności Asystenta AI Hermes dla Prawdziwych Ustawień Produkcyjnych. Gdy jesteś gotowy do tworzenia lub debugowania plików SKILL.md samych — metadanych YAML, poziomów progresywnego ujawniania, warunkowej widoczności i instalacji hub — użyj Tworzenie Umiejętności Hermes Agent — Struktura SKILL.md i Najlepsze Praktyki.

Typowy przepływ pracy

Jeśli traktujesz Hermes jako agenta, którego będziesz utrzymywać, przepływ pracy zaczyna wyglądać jak inżynieria usług.

Stabilna baza

Baza, która tenduje do niepsucia się:

Zainstaluj i uruchom pierwszą rozmowę w CLI.
Wybierz dostawcę i model za pomocą hermes model, a następnie potwierdź koszty.
Skonfiguruj zestawy narzędzi i zdecyduj, czy wykonanie terminala jest lokalne czy w sandomiku.
Wprowadź szybką zmianę w SOUL.md dopiero po pewnym czasie używania domyślnej. Zmiany tożsamości mają większe znaczenie, niż ludzie oczekują, ponieważ jest to „slot 1” w systemowym prompcie.

Codzienne użycie, które się kumuluje

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

W praktyce, przydatna kadencja to:

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

Bramka komunikacyjna dla dostępu 24/7

Bramka 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 przez hermes gateway setup, a bramka może działać na pierwszym planie lub jako usługa użytkownika. Dokumentacja CLI opisuje podkomendy bramki takie jak run, install, start, stop, status i restart.

Dla wieloagentowych kolejek i kontrolowanego harmonogramu, zobacz Kanban w Hermes Agent dla Samodzielnie Hostowanych Przepływów LLM, który omawia limity dystrybutora, łańcuchy zależności i batchingu opartego na cron.

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

Aktualizacje bez dramatów

Aktualizacje Hermes to komenda pierwszej klasy. Przewodnik aktualizacyjny dokumentuje hermes update, kontrole migracji konfiguracji i małą rutinę walidacji 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ę uruchomieniową.

Szybkie polecenia triażowe

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

hermes doctor dla interaktywnej diagnostyki
hermes status dla szybkiego przeglądu
hermes dump dla udostępnialnego, czerwonego 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 powtarzających się problemów i ich napraw, 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 remediacji, 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 przez 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żywania hermes model do wyboru ważnego identyfikatora i pokazuje nadpisania konfiguracji i sesji.

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

Problemy z backendem terminala i bramką

Jeśli polecenia terminala zawiodą natychmiastowo, przewodnik konfiguracyjny zawiera sekcję „częste problemy z backendem terminala” i wskazuje typowe przyczyny dla każdego backendu, w tym brakujący Docker i brakujące zmienne SSH. Wskazuje również, że cofnięcie się do lokalnego jest ważnym krokiem debugowania, gdy konfiguracja sandomiku jest w kwestii.

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