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

Hermes Agent to samodzielnie hostowany, agnostyczny względem modelu asystent AI, który działa na lokalnym komputerze lub tanim VPS, współpracuje przez interfejs terminala i wiadomości oraz z czasem udoskonala swoje działanie, przekształcając powtarzalne zadania 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 — systemu samodzielnie hostowanego asystenta AI, który integruje lokalne LLM, wyszukiwanie, pamięć, routing i observability w spójną infrastrukturę lokalną.), innego stosu asystentów hostowanych samodzielnie, zbudowanego wokół narzędzi, pamięci i kontroli lokalnej. Wielu deweloperów trafiło do Hermes po tym, jak Anthropic zablokowała dostęp OpenClaw do subskrypcji Claude w kwietniu 2026 roku — oś czasu wzrostu i upadku OpenClaw wyjaśnia, dlaczego Hermes pojawił się jako naturalne miejsce docelowe dla użytkowników, którzy chcieli utrzymać trwałą, samodzielnie hostowaną automatyzację bez zależności od dostawcy.

Jeśli chcesz poznać szerszy obraz asystentów hostowanych samodzielnie, wyszukiwania i infrastruktury lokalnej wokół Hermes, to przegląd systemów AI łączy te tematy z tymi samymi problemami, które Hermes próbuje rozwiązać. Dla pięciowarstwowego modelu asystenta — LLM, pamięć, narzędzia, routing i observability — z Hermes i OpenClaw jako implementacjami referencyjnymi, zobacz Architekturę Asystenta AI. Dla konkretnych danych adopcji — gwiazdki GitHub, dzienny wolumen tokenów OpenRouter, liczba pobrań PyPI, historia CVE i sentyment społeczności Reddit — OpenClaw vs Hermes Agent: Gwiazdki, Pobrania i Użycie 2026 śledzi, jak Hermes porównuje się do 19 alternatyw w każdym mierzalnym sygnale.

Dla kompromisów wdrożeniowych i wyborów środowiska uruchomieniowego, Hosting LLM w 2026: Infrastruktura Lokalna, Samodzielnie Hostowana i Chmurowa Porównana dostarcza mapę hostingu, podczas gdy Wydajność LLM w 2026: Benchmarki, Butelkowe Gardła i Optymalizacja omawia stronę przepustowości i opóźnień po uruchomieniu Hermes. Jeśli regularnie kierujesz Hermes do Qwen lub Gemma na lokalnych środowiskach uruchomieniowych, takich jak Ollama, skonsoliduj ustawienia temperatury i penalizacji dla wieloetapowego użycia narzędzi z Parametrami wnioskowania Agentic LLM dla Qwen i Gemma. Dla zwartej mapy poleceń powłoki (hermes gateway, hermes memory, hermes doctor, skróty slash i więcej), użyj Cheat Sheet CLI Hermes Agent. Jeśli Twoim głównym punktem wejścia są wiadomości na urządzeniach mobilnych, użyj Sterowania Głosowego Hermes z Telefonu dla stosu głosowego i konfiguracji specyficznej dla platformy.

Moja stronnicza opinia: Hermes jest najbardziej interesujący, gdy traktowany 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 agencja AI o otwartym kodzie źródłowym stworzona przez Nous Research. Jest zaprojektowana do działania ciągłego, używania narzędzi (terminal, pliki, web i więcej) oraz ulepszania swojego własnego 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 przypisany do jednego dostawcy modeli. Oficjalny przepływ konfiguracji obsługuje wielu dostawców i dowolny punkt końcowy zgodny z OpenAI, a przełączanie odbywa się poprzez komendę hermes model, a nie poprzez edycję kodu.

Po drugie, Hermes wyciąga twardą linię między “konwersacją” 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. To tam mieszka bezpieczeństwo, powtarzalność i rozwiązywanie problemów.

Koszty i licencjonowanie są odświeżająco nudne. Sam Hermes Agent to darmowe oprogramowanie na licencji MIT. Jeśli używasz modeli hostowanych, bieżący koszt to to, co Twój dostawca pobiera. Jeśli uruchamiasz modele lokalnie, możesz całkowicie uniknąć opłat za API.

Jeśli Twoja konfiguracja Hermes używa Claude poprzez zewnętrzne warstwy narzędziowe, ta zmiana subskrypcji Anthropic jest przydatnym odniesieniem, dlaczego opłaty oparte na API są 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 swoją powłokę i uruchom CLI.

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

Instalator to nie tylko cienka nakładka. Zgodnie z przewodnikiem instalacyjnym, konfiguruje on zależności, repozytorium, wirtualne środowisko i komendę hermes, a następnie doprowadza Cię do pierwszego stanu gotowego do czatu.

Uwagi dotyczące Windows i Android

Natywny Windows nie jest wspierany. 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ć 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 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 interakcyjnego kreatora w głównych obszarach konfiguracji

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

hermes model
hermes tools
hermes

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

Zweryfikuj wykonywanie narzędzi wczesnie

Zanim wytworzysz 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 wypróbowania.

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

Przykładowy prompt:

Pokaż moje 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 jedną z najczęstszych przyczyn, a rozwiązanie jest zwykle oczywiste, 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 pod ~/.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.

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

Priorytety konfiguracji i utrzymywanie 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 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 poprzez składnię ${VAR_NAME}. Jest to przydatne, gdy chcesz utrzymać pewne wartości w środowisku, wciąż odwołując się do nich w strukturalnej konfiguracji.

Sándbox i środowiska wykonawcze

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

Opiniowana, ale nie ewangelicka myśl na ten temat:

• local jest najszybszy i najprostszy, ale nie jest izolowany
• docker to pragmatyczna warstwa bezpieczeństwa i powtarzalności
• ssh to czysty sposób na oddzielenie urządzenia czatowego od masziny obliczeniowej
• modal i daytona pasują do przepływów pracy “serwerless, 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ż wzmocnienie 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 składania wartości.

Umiejętności to pamięć proceduralna. Hermes może tworzyć, aktualizować i usuwać swoje własne umiejętności i może zaoferować 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 pod ~/.hermes, a Hermes może również używać zewnętrznych dostawców pamięci dla 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łnej technicznej analizy, 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 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 pracy wykonawczych — zobacz Umiejętności Asystenta AI Hermes dla Rzeczywistych Konfiguracji Produkcyjnych. Gdy jesteś gotowy do autorstwa lub debugowania plików SKILL.md — metadanych YAML, poziomów ujawniania progresywnego, warunkowej widoczności i instalacji hub — użyj Autorstwa 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 zwykle nie psuje się:

1. Zainstaluj i uruchom pierwszy czat w CLI.
2. Wybierz dostawcę i model z hermes model, a następnie potwierdź koszty.
3. Skonfiguruj zestawy narzędzi i zdecyduj, czy wykonanie terminala jest lokalne czy zasobnicowane.
4. Wnieś szybką zmianę do SOUL.md dopiero po tym, jak użyjesz domyślnej przez chwilę. Zmiany tożsamości mają większe znaczenie, niż ludzie oczekują, ponieważ to “slot 1” w systemowym prompcie.

Codzienne użycie, które się kumuluje

Hermes ma interfejs terminala, a nie web UI, i jest zaprojektowany dla długich sesji z komendami 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 stanie się za duży
• pozwól Hermesowi przekształcić powtarzalne rutyny w umiejętności
• utrzymuj mentalną granicę między “pytaj” a “działaj”, 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 przez 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. Jeśli chcesz, aby ten model bramy działał na dedykowanym serwerze, podczas łączenia się z oddzielnego klienta pulpitu, użyj Konfiguracji Serwera Headless i Zdalnego Pulpitu Hermes Agent.

Dla wieloagentowych backlogów 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 batching oparty na cron.

Bezpieczeństwo dla 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 komenda pierwszego rzutu. 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 komendy triażu

Referencja 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, zredagowanego podsumowania konfiguracji

Dla logów, hermes logs ogonuje pliki przechowywane pod ~/.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 rozwiązań, w tym problemy z wersją Pythona, uv nie znaleziony 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 powszechne haczyki: 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 nadpisania konfiguracji i sesji.

Ograniczenia szybkości i problemy z długością kontekstu są również omówione. 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 terminala i bramą

Jeśli polecenia terminala zawodzą natychmiastowo, przewodnik konfiguracji zawiera sekcję “częste problemy z backendem terminala” i wskazuje typowe przyczyny dla każdego backendu, w tym Docker nie uruchomiony i brakujące zmienne SSH. Wskazuje również, że powrót do lokalnego jest ważnym ruchem debugowania, gdy konfiguracja sandbox jest w pytaniu.

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

Referencje

• Strona Główna Hermes Agent
• System Pamięci Hermes Agent: Jak Działa Trwała Pamięć AI
• Umiejętności Asystenta AI Hermes dla Rzeczywistych Konfiguracji Produkcyjnych