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, działa poprzez interfejsy terminala i wiadomości oraz ulepszanie się z czasem poprzez przekształcanie powtarzalnych zadań w wielokrotnego użytku umiejętności.

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

Jeśli chcesz zobaczyć szerszy obraz samodzielnie hostowanych asystentów, odzyskiwania danych i lokalnej infrastruktury wokół Hermes, [to przegląd systemów AI](https://www.glukhov.org/pl/ai-systems/ “Buduj samodzielnie hostowane systemy AI z OpenClaw, Hermes, RAG i lokalną infrastrukturą LLM. Naucz się orkiestrować asystentów z pamięcią, odzyskiwaniem, routingiem i obserwowalnością.) łą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: Infrastruktura Lokalna, Samodzielnie Hostowana i Chmurna w Porównaniu dostarcza mapę hostingową, podczas gdy [Wydajność LLM w 2026: Testy Porównawcze, Butelkowe Gardła i Optymalizacja](https://www.glukhov.org/pl/llm-performance/ “Praktyczna inżynieria wydajności LLM: przepustowość vs opóźnienie, limity VRAM, równoległe żądania, alokacja pamięci i testy porównawcze w różnych środowiskach uruchomieniowych i sprzęcie.) omawia kwestie przepustowości i opóźnień, gdy Hermes już działa. Dla kompaktowej mapy poleceń powłoki (hermes gateway, hermes memory, hermes doctor, skróty slash i więcej), użyj Ściągi CLI Hermes Agent. Jeśli głównym punktem wejścia jest komunikacja na urządzeniach mobilnych, użyj Sterowania Głosowego Hermes z Telefonu stosu głosowego i konfiguracji specyficznej dla platformy.

peronal-ai-assistant on laptop

Moja uprzedzona opinia: Hermes jest najbardziej interesujący, gdy traktowany jest jako infrastruktura, a nie jako karta, którą okazjonalnie otwierasz. 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 o otwartym kodzie źródłowym stworzony przez Nous Research. Został zaprojektowany do ciągłego działania, używania narzędzi (terminal, pliki, sieć i więcej) oraz ulepszania swojego zachowania z czasem dzięki systemowi umiejętności i pamięci.

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

Po pierwsze, Hermes nie jest związany z jednym dostawcą modeli. Oficjalny przepływ konfiguracji obsługuje wielu dostawców i każdy punkt końcowy zgodny z OpenAI, a przełączanie odbywa się za pomocą polecenia hermes model, a nie edycji 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 jawne 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 hostowanych modeli, 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 Twoja konfiguracja Hermes używa Claude przez zewnętrzne warstw narzędzi, ta zmiana w subskrypcji Anthropic jest użytecznym 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 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 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 i polecenie hermes, doprowadzając Cię do stanu gotowego do pierwszej rozmowy.

Uwagi dotyczące Windows i Android

Natywny Windows nie jest obsługiwany. 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ć konfigurację 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óry dostawca modeli do użycia i które narzędzia powinny być włączone.

Wybierz dostawcę i model

Hermes oferuje 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 interakcyjnego kreatora w głównych obszarach konfiguracji

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

hermes model
hermes tools
hermes

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

Zweryfikuj wykonywanie narzędzi wczesne

Zanim wytworzysz nawyki wokół Hermes, warto zweryfikować, że użycie narzędzi działa w Twoim środowisku. Szybki Start wprost sugeruje użycie terminala jako pierwszej funkcji do wypróbowania.

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 terminalowego, przejdź do Rozwiązywania Problemów. Nieprawidłowa konfiguracja backendu terminalowego jest jednym z najczęstszych powodów, a naprawa jest zwykle oczywista, gdy spojrzysz na konfigurację.

Konfiguracja, która skaluje się

Hermes nagradza tych, 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 katalogu ~/.hermes. Oficjalny przewodnik konfiguracji dokumentuje układ, w tym config.yaml dla ustawień, .env dla sekretów, auth.json dla poświadczeń 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ć.
Kopie zapasowe stają się proste, ponieważ jeden katalog zawiera większość stanu agenta, który Cię obchodzi.

Priorytet konfiguracji i trzymanie sekretów poza 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, a ustawienia niebędące sekretami 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 przydatne, gdy chcesz trzymać pewne wartości w środowisku, nadal odwołując się do nich w strukturalnej konfiguracji.

Piaskownica i środowiska wykonawcze

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

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

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 komputera obliczeniowego
modal i daytona pasują do przepływów pracy “serverless, ale wystarczająco trwałych”
singularity to opcja przyjazna dla 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ż zacieranie bezpieczeństwa dla backendu Docker, takie jak usuwanie możliwości i wyłączanie eskalacji uprawnień.

Umiejętności, pamięć i profile

Hermes ma dwa powiązane mechanizmy do 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ści po ukończeniu złożonego zadania.

Wbudowana pamięć jest przechowywana jako pliki takie jak MEMORY.md i USER.md w katalogu ~/.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. Aby uzyskać pełną analizę techniczną 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 Działa Trwała Pamięć AI.

Jeśli chcesz wielu niezależnych agentów na tym samym komputerze, profile Hermes zapewniają izolację. Każdy profil ma własny katalog z własną konfiguracją, sekretami, pamięciami, sesjami, umiejętnościami, zadaniami cron i stanem bramy.

Aby uzyskać głębsze spojrzenie na to, które umiejętności dobrze działają w produkcji według roli — inżynierowie, badacze, operatorzy i przepływy pracy wykonawcze — zobacz Umiejętności Asystenta AI Hermes dla Rzeczywistych Konfiguracji Produkcyjnych. Gdy jesteś gotowy do tworzenia lub debugowania plików SKILL.md — metadane YAML, poziomy ujawniania progresywnego, widoczność warunkową i instalacje hub — użyj Tworzenie Umiejętności Hermes Agent — Struktura SKILL.md i Najlepsze Praktyki.

Typowy przepływ pracy

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

Stabilna baza

Baza, która tendencja do niepsucia się, to:

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 terminalowe jest lokalne, czy w piaskownicy.
Wprowadź szybką zmianę w SOUL.md dopiero po tym, jak użyjesz domyślnej przez jakiś czas. Zmiany tożsamości mają większe znaczenie, niż ludzie oczekują, ponieważ jest to “slot 1” w systemowym prompcie.

Codzienna eksploatacja, która się accumuluje

Hermes ma interfejs terminalowy, a nie webowy, i jest zaprojektowany do długich sesji z poleceniami slash, sesjami wznowialnymi i strumieniowaniem wyjścia narzędzi.

W praktyce, użyteczne tempo to:

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

Brama wiadomości dla dostępu 24/7

Brama wiadomości 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 bramy, takie jak run, install, start, stop, status i restart.

Dla kolejek wieloagentowych i kontrolowanego harmonogramowania zobacz Kanban w Hermes Agent dla Przepływów Pracy Samodzielnie Hostowanych LLM, który omawia limity dyspozytora, łańcuchy zależności i partię opartą na cron.

Bezpieczeństwo bota używającego narzędzi ma znaczenie. Dokumentacja bramy 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 dramatu

Aktualizacje Hermes to polecenie pierwszej klasy. Przewodnik aktualizacji dokumentuje hermes update, kontrole migracji konfiguracji i małą rutynę 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ę środowiska uruchomieniowego.

Szybkie polecenia triażowe

Referencja CLI wprost pozycjonuje trzy polecenia jako rdzeniową pętlę:

hermes doctor do interakcyjnej diagnostyki
hermes status do szybkiego przeglądu
hermes dump do udostępnialnego, zredagowanego podsumowania konfiguracji

Dla logów, hermes logs wypisuje 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 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 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życia hermes model do wyboru ważnego identyfikatora i pokazuje zarówno nadpisania konfiguracji, jak i sesyjne.

Ograniczenia szybkoś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 kontekstowej poprzez kompresję lub nową sesję.

Problemy z backendem terminalowym i bramą

Jeśli polecenia terminalowe odpadają natychmiastowo, przewodnik konfiguracji zawiera sekcję “częste problemy z backendem terminalowym” i wskazuje typowe przyczyny dla każdego backendu, w tym nieuruchomiony Docker i brakujące zmienne SSH. Wskazuje również, że cofnięcie się do lokalnego jest ważnym ruchem debugowania, gdy konfiguracja piaskownicy jest kwestionowana.

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