Hermes Agent: kompendium praktyka (2026)

W skrócie: Hermes Agent to samodoskonalący się agent AI typu open source od Nous Research. Działa jako CLI oraz wieloplatformowy gateway komunikacyjny, przechowuje na dysku trwałą tożsamość i pamięć, gromadzi skille doskonalące się w miarę używania oraz współpracuje z dowolnym dostawcą LLM zgodnym z OpenAI — Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Qwen Cloud, Hugging Face, Google, xAI/SuperGrok lub własnym, samodzielnie hostowanym endpointem.¹²¹⁹ Od wersji v0.14.0 (16 maja 2026) Hermes oferuje OAuth SuperGrok z kontekstem 1M w grok-4.3, zgodny z OpenAI lokalny serwer proxy dla dostawców OAuth (hermes proxy), pełnoprawne x_search, obsługę instalacji z PyPI (od wersji v0.19.0 uznaną za przestarzałą — wspieraną metodą jest instalator jednowierszowy), leniwe instalowanie zależności, 22 platformy komunikacyjne, w tym LINE i SimpleX Chat, /handoff, diagnostykę semantyczną LSP po zapisach, ujednolicone video_generate, computer_use za pośrednictwem cua-driver dla dostawców innych niż Anthropic, natywną wersję beta dla Windows oraz rozwiązania 12 problemów P0 i 50 problemów P1.¹⁹ Najtrudniejszym elementem dla większości nowych użytkowników jest uwierzytelnianie u dostawcy: Hermes obsługuje około 20 pełnoprawnych dostawców oraz niestandardowe endpointy, a także trzy odrębne ścieżki uwierzytelniania (klucz API w .env, OAuth przez hermes model albo niestandardowy endpoint w config.yaml). Najpierw należy poznać model uwierzytelniania — wszystko inne zależy od tego, który dostawca zostanie wybrany.

Hermes Agent działa jako kompletne środowisko uruchomieniowe agenta, a nie nakładka na czat. Odczytuje system plików, wykonuje polecenia w izolowanych backendach, pobiera dane z internetu, uruchamia subagentów i zaplanowane zadania cron, komunikuje się z Telegram/Discord/Slack/WhatsApp/Signal/Email z poziomu jednego procesu gateway oraz tworzy własne skille na podstawie zdobytych doświadczeń.¹ CLI to terminalowy interfejs użytkownika zbudowany na pętli konwersacji w run_agent.py; gateway jest długotrwale działającym procesem, który przekazuje wiadomości z platform komunikacyjnych przez tę samą pętlę konwersacji.³

Różnica między okazjonalnym a eksperckim korzystaniem z Hermes sprowadza się do pięciu systemów. Ich opanowanie sprawia, że Hermes zwielokrotnia możliwości:

1. Wybór dostawcy: sposób mapowania przepływów uwierzytelniania na wywołania API
2. Hierarchia konfiguracji: config.yaml + .env + auth.json + SOUL.md + AGENTS.md
3. System narzędzi i toolsetów: możliwości agenta ograniczane osobno dla każdej platformy
4. System skilli: pamięć proceduralna tworzona i rozwijana przez agenta
5. Gateway + cron + profile: uruchamianie Hermes tam, gdzie na co dzień korzysta się z komunikatorów, a nie tylko tam, gdzie aktualnie się przebywa

Najważniejsze informacje

• Uwierzytelnianie u dostawcy obejmuje trzy ścieżki, a nie jedną. Klucz API w .env, OAuth przez hermes model/hermes auth albo niestandardowy endpoint w config.yaml. Należy wybrać ścieżkę odpowiadającą dostawcy, a nie tę, która wydaje się najbardziej znajoma.
• Do zmiany dostawcy wystarczy jedno polecenie. hermes model interaktywnie przeprowadza przez konfigurację każdego obsługiwanego dostawcy, w tym logowania OAuth, a /model provider:model pozwala zmienić model w trakcie sesji bez utraty historii.²
• Konfigurację użytkownik edytuje w dwóch plikach. ~/.hermes/config.yaml zawiera ustawienia, a ~/.hermes/.env — dane tajne. Plikami auth.json, SOUL.md, MEMORY.md oraz folderem skills/ zarządza bezpośrednio Hermes — SOUL.md można edytować ręcznie, natomiast pozostałe elementy modyfikuje sam agent.⁴
• Hermes jest następcą OpenClaw. Podczas migracji hermes claw migrate automatycznie importuje ponad 30 kategorii stanu.⁵
• Jakość działania zależy od modelu pomocniczego. Analiza obrazów, podsumowywanie treści z internetu, kompresja i zapis pamięci korzystają z osobnego pomocniczego LLM. Domyślnie jest nim Gemini Flash wybierany automatycznie (OpenRouter → Nous → Codex) — jeśli żaden z tych dostawców nie został skonfigurowany, funkcje te po cichu działają w ograniczonym zakresie, dopóki sloty pomocnicze nie zostaną skierowane do głównego dostawcy.⁴

Co zmienia v0.14

W wersji v0.14.0 nacisk położono nie tyle na jedną przełomową funkcję, ile na uproszczenie konfiguracji i rozszerzenie środowisk, w których można uruchomić Hermes.¹⁹ Najważniejsze zmiany operacyjne:

• Instalacja i uruchamianie są lżejsze. pip install hermes-agent umożliwia instalację z PyPI, rozbudowane adaptery instalują się leniwie przy pierwszym użyciu, a ścieżka uruchamiania odracza wystarczająco dużo operacji, by skrócić zimny start o około 19 sekund. (Od wersji v0.19.0 instalacje przez pip są uznane za przestarzałe — patrz Instalacja.)
• Subskrypcje mogą stać się lokalnymi endpointami API. hermes proxy przekształca dostawców korzystających z OAuth, takich jak Claude Pro, ChatGPT Pro i SuperGrok, w zgodny z OpenAI lokalny endpoint dla narzędzi takich jak Codex, Aider, Cline i Continue.
• Gateway obsługuje więcej platform. LINE i SimpleX Chat zwiększają ich liczbę do 22, Microsoft Teams działa kompleksowo, domyślnie włączono uzupełnianie historii Discord, a monity clarify w Telegram/Discord korzystają teraz z natywnych przycisków.
• Lepsza jest weryfikacja podczas zapisu. Po edycji Hermes może przed kolejną turą wyświetlić podsumowanie zmian w plikach wprowadzone w danej turze oraz diagnostykę semantyczną serwera językowego, co przybliża go do pracy agenta opartej na dowodach.
• Rozszerzono narzędzia komputerowe i multimedialne. computer_use działa za pośrednictwem cua-driver z dostawcami innymi niż Anthropic, video_generate ujednolicono za wymiennymi backendami, a vision_analyze przesyła nieprzetworzone piksele do modeli, które rzeczywiście potrafią analizować obrazy.

Każda poniższa sekcja opiera się na nadrzędnej dokumentacji dostępnej pod adresem hermes-agent.nousresearch.com/docs oraz drzewie źródłowym w repozytorium github.com/NousResearch/hermes-agent. Każde stwierdzenie dotyczące faktów zawiera przypis wskazujący konkretną stronę nadrzędnej dokumentacji, z której pochodzi.

Wybór ścieżki

Jak działa Hermes: model mentalny

Struktura Hermes opiera się na jednej pętli konwersacji, którą może wywołać dowolny punkt wejścia. Punktami wejścia są CLI (cli.py), gateway komunikatorów (gateway/run.py), adapter ACP do integracji z edytorem, mechanizm przetwarzania wsadowego oraz serwer API.³ Wszystkie ostatecznie wywołują metodę AIAgent.run_conversation() w pliku run_agent.py, która:

1. Buduje prompt systemowy z plików SOUL.md, MEMORY.md, USER.md, skills, plików kontekstowych i wskazówek dotyczących narzędzi za pośrednictwem prompt_builder.py³
2. Ustala dostawcę środowiska wykonawczego za pośrednictwem runtime_provider.py — na tym etapie wybierane są uwierzytelnianie, bazowy adres URL oraz tryb API³
3. Wywołuje dostawcę przy użyciu jednego z trzech trybów API: chat_completions, codex_responses lub anthropic_messages³
4. Przekazuje wszystkie zwrócone wywołania narzędzi do model_tools.py i centralnego rejestru narzędzi (tools/registry.py)³
5. Powtarza pętlę, dopóki model nie wygeneruje ostatecznej odpowiedzi, po czym zapisuje sesję w bazie SQLite z FTS5³

Zrozumienie tej pętli jest istotne, ponieważ każda funkcja — osobowości, pamięć, skills, kompresja i mechanizm awaryjny — wiąże się z jednym z tych etapów. Gdy analizuje się klucz konfiguracji i zastanawia nad jego działaniem, odpowiedź zwykle brzmi: „jest to parametr sterujący etapem 1, 2, 3 lub 4 powyższej pętli”.

Rdzeń niezależny od platformy. Jedna klasa AIAgent obsługuje CLI, gateway, ACP, przetwarzanie wsadowe oraz serwer API. Różnice między platformami znajdują się w punktach wejścia, a nie w samym agencie.³ Dlatego te same polecenia z ukośnikiem działają zarówno w terminalu, jak i w Telegram — są obsługiwane za pośrednictwem wspólnego rejestru COMMAND_REGISTRY w pliku hermes_cli/commands.py.⁶

Struktura katalogów jest systemem. Hermes przechowuje wszystko w ~/.hermes/ (lub $HERMES_HOME w przypadku profili innych niż domyślny):⁴

~/.hermes/
├── config.yaml        # Settings (model, terminal, TTS, compression, etc.)
├── .env               # API keys and secrets
├── auth.json          # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md            # Primary agent identity (slot #1 in system prompt)
├── memories/          # Persistent memory (MEMORY.md, USER.md)
├── skills/            # Bundled + agent-created + hub-installed skills
├── cron/              # Scheduled jobs
├── sessions/          # Gateway session state
└── logs/              # agent.log, gateway.log, errors.log (secrets auto-redacted)

Każdy z powyższych plików pełni określoną rolę; ich zakresy się nie pokrywają. Jeśli trzeba ustalić, „gdzie Hermes przechowuje X”, odpowiedzią jest jeden z nich.

Co nowego w wersji 0.19.0 (wydanie Quicksilver)

Nazwa Hermes Agent v0.19.0 (tag v2026.7.20, 20 lipca 2026) nawiązuje do szybkości samego boga posłańców: fundamentem tego wydania jest błyskawiczna responsywność, a czas do wygenerowania pierwszego tokenu w pierwszej turze skrócono o około 80% na każdej platformie. Wokół tego fundamentu skupiają się rozliczenia w terminalu, pobieranie sekretów z menedżerów haseł, domyślnie inteligentne zatwierdzanie, obserwowalne subagents oraz odporne na awarie dostarczanie odpowiedzi. Okres od wersji 0.18.0 jest dotychczas największym w historii projektu: około 2 245 commitów, około 1 065 scalonych PR-ów, około 3 300 zamkniętych zgłoszeń i ponad 450 współtwórców ze społeczności.²³

• Około 80% krótszy czas do pierwszego tokenu — wszędzie. Czas od wysłania pierwszego żądania po zimnym starcie do jego przekazania spadł z około 4,3 s do około 0,9 s zarówno w CLI, gateway, TUI, aplikacji komputerowej, jak i cron — wykrywanie możliwości Discord przeniesiono poza ścieżkę krytyczną, test Ollama jest pomijany dla znanych dostawców innych niż Ollama, a z inicjalizacji agenta usunięto operacje blokujące. Zadbano również o odczuwalne opóźnienie: modele rozumujące domyślnie przesyłają teraz swój tok rozumowania na żywo (display.show_reasoning jest WŁĄCZONE), a pole odpowiedzi jest odświeżane po każdym tokenie, zamiast po każdym wierszu.²³
• Fala usprawnień renderowania w aplikacji komputerowej i TUI. Aplikacja komputerowa przeszła obejmującą około 20 PR-ów optymalizację szybkości: 14-krotnie zmniejszono użycie procesora przez moduł dzielący strumieniowy Markdown dzięki przyrostowej analizie bloków, zwirtualizowano różnice w panelu przeglądu, przyspieszono przełączanie sesji w obszernych transkrypcjach oraz wyeliminowano ponowne renderowanie paska bocznego i wierszy narzędzi po każdym tokenie. TUI renderuje teraz strumieniowy Markdown przyrostowo, blok po bloku.²³
• Instalacje za pomocą pip i Homebrew są przestarzałe. Obie metody są teraz oznaczone jako „nieobsługiwane starsze instalacje” — ostrzeżenia pojawiają się we wszystkich interfejsach, ale nie blokują działania, a zaprzestanie publikowania w PyPI i Homebrew jest planowane. Obsługiwaną metodą jest instalator jednowierszowy; jeśli instalację wykonano za pomocą pip lub brew, należy już teraz zaplanować migrację.²³
• Sekrety mogą pochodzić z menedżera haseł. Nowy, rozszerzalny interfejs SecretSource pobiera podczas wczytywania sekrety z Bitwarden i 1Password (odwołania op://), umożliwiając jednoczesne korzystanie z wielu sejfów, deterministyczne ustalanie pierwszeństwa, ostrzeżenia o konfliktach oraz śledzenie pochodzenia każdej zmiennej — klucze API nie muszą już znajdować się w zwykłym pliku tekstowym .env. Obsługę przyszłych dostawców sejfów będzie można dodawać w formie pluginów.²³
• Inteligentne zatwierdzanie jest teraz domyślne. Gdy Hermes chce uruchomić oznaczone polecenie, zamiast pytać o każde z nich niezależny recenzent LLM dokonuje jego oceny — a każdy werdykt obejmuje wyłącznie to konkretne polecenie. Zdefiniowane przez użytkownika reguły odmowy blokują pasujące polecenia nawet w trybie YOLO, /deny <reason> przekazuje powód odmowy, aby agent mógł skorygować swoje działanie, natomiast akcja zatwierdzająca pre_tool_call pluginu (ponownie wprowadzona wraz z kluczami reguł) kieruje wywołanie narzędzia do zatwierdzenia przez człowieka.²³
• Rozliczenia w terminalu: /subscription i /topup. Planem Nous Portal można zarządzać bez opuszczania terminala — sprawdzać plan i pozostały limit, zobaczyć dokładny koszt podwyższenia planu lub termin wejścia w życie jego obniżenia, a następnie zastosować zmianę z możliwością jej cofnięcia. Aplikacja komputerowa otrzymała odpowiadającą temu kartę ustawień rozliczeń.²³
• Można obserwować pracę subagents i nigdy nie utracić gotowej odpowiedzi. Wywołania delegate_task udostępniają transkrypcje na żywo w plikach, które można śledzić poleceniem tail -f natychmiast po uruchomieniu subagents — każde wywołanie narzędzia, wynik i strumieniowana odpowiedź trafiają do jednego czytelnego dla człowieka dziennika na każde zadanie potomne. Wyniki delegowania w tle zachowują się po ponownym uruchomieniu, a końcowe odpowiedzi gateway są zapisywane w rejestrze zobowiązań dostarczenia w state.db i ponownie dostarczane przy następnym uruchomieniu, jeśli gateway ulegnie awarii podczas wysyłania. Opcja konfiguracji max_async_children jest przestarzała — zastąpiły ją ujednolicone limity współbieżności delegowania.²³
• Jeden gateway, wiele profili. Pojedynczy multipleksowany gateway, korzystający ze wspólnego tokenu bota, może kierować określone serwery, kanały lub wątki do różnych profili — każdy z całkowicie odizolowaną konfiguracją, skills, pamięcią i sekretami — z możliwością nadpisania za pomocą GATEWAY_MULTIPLEX_PROFILES. Indeks routingu przeniesiono do state.db; sessions.json jest teraz opcjonalną kopią zgodności ze starszymi wersjami.²³
• Fala nowych dostawców i modeli. Fireworks AI otrzymuje pełnoprawną obsługę (szacowanie kosztów i 2. miejsce na liście wyboru dostawcy), a dołączają do niego DeepInfra i Upstage Solar. Katalogi wzbogacono o GPT-5.6 (Sol/Terra/Luna + Pro, z pełną integracją), grok-4.5 (GA), kimi-k3 (kimi-k2.x wycofano) oraz w pełni zintegrowany Claude Sonnet 5. Flaga enabled: false dla poszczególnych dostawców oraz konfiguracja excluded_providers usuwają nieużywanych dostawców z list wyboru /model i procesu rozpoznawania.²³
• Intensywność rozumowania staje się regulowanym parametrem. Nowe poziomy intensywności max i ultra trafiają do wszystkich interfejsów, wraz z nadpisaniami dla poszczególnych modeli w konfiguracji, intensywnością dla poszczególnych miejsc w ustawieniach MoA (doradcy analizują dogłębnie, a syntezator zachowuje szybkość), intensywnością zależną od zadania dla modeli pomocniczych oraz ograniczonym do sesji poleceniem /reasoning w CLI.²³
• Interfejsy CLI i MCP. hermes sessions export zapisuje dane w formatach Markdown, Quarto, HTML, wyłącznie promptów oraz śladów Hugging Face, z opcjonalnym oczyszczaniem --redact; /model --once umożliwia jednorazowe nadpisanie modelu na jedną turę; wywołania slash-skill można łączyć (/skill-a /skill-b do XYZ); --safe-mode pomaga w rozwiązywaniu problemów; hermes config get/unset uzupełniają funkcje zarządzania konfiguracją; hermes serve staje się prawdziwym backendem bez interfejsu graficznego; a narzędzia MCP przyjmują konwencję nazewnictwa mcp__server__tool.²³

W przypadku aktualizacji z wersji 0.18.x dwie zmiany wymagają uwagi w pierwszej kolejności: instalacja za pomocą pip lub Homebrew wyświetla teraz ostrzeżenie o braku obsługi starszej metody (należy przejść na instalator jednowierszowy), a max_async_children jest przestarzałe na rzecz ujednoliconych limitów współbieżności delegowania. Wszystkie pozostałe zmiany mają charakter addytywny — najważniejsze powody aktualizacji to skrócenie opóźnienia pierwszej tury o około 80%, inteligentne zatwierdzanie oraz rejestr dostarczania, dzięki któremu gotowe odpowiedzi są odporne na awarie.

Co nowego w wersji v0.18.0 (wydanie Judgment)

Nazwa Hermes Agent v0.18.0 (tag v2026.7.1, 1 lipca 2026) nawiązuje do osądu: agent weryfikuje własną pracę, zamiast twierdzić, że zakończyła się sukcesem, a proces wnioskowania zespołowego można rzeczywiście prześledzić. Wydanie zamyka również cały rejestr zadań P0/P1 — w ciągu 12 dni rozwiązano około 692 spraw o najwyższym priorytecie.²²

• Mixture-of-Agents jako pełnoprawny model. MoA można teraz wybrać tak samo jak każdy inny model we wszystkich interfejsach, a wnioskowanie zespołowe jest widoczne: pełne dane wyjściowe każdego modelu referencyjnego pojawiają się w osobnym, oznaczonym bloku wraz z przesyłaną na żywo odpowiedzią — można obserwować tok rozumowania zespołu zamiast otrzymywać nieprzejrzystą, scaloną odpowiedź.²²
• Kontrakty ukończenia dla /goal. Przed zgłoszeniem realizacji celu agent uruchamia mechanizmy kontrolne projektu, aby zweryfikować własną pracę, zamiast jedynie ogłaszać sukces — stosuje osąd również wobec siebie.²²
• /learn — przekształcanie dowolnego opisu w skill. Wystarczy opisać proces, aby przekształcić go w skill wielokrotnego użytku; wygenerowane skills automatycznie spełniają konwencje pliku CONTRIBUTING.md w repozytorium.²²
• Oś czasu /journey. Wizualna, edytowalna historia pamięci i skills w czasie oraz graf pamięci w aplikacji komputerowej.²²
• Równoległe uruchamianie subagentów w tle. Można delegować wiele zadań wykonywanych współbieżnie bez blokowania rozmowy — pojedynczy subagent działający w tle z wersji v0.17.0 zmienia się w całą flotę.²²
• Projekty w aplikacji komputerowej. Pełnoprawne projekty programistyczne z modelem organizacyjnym opartym na projekcie, repozytorium i ścieżce pracy.²²
• Gateway skalowany do zera. Gateways mogą przechodzić w stan uśpienia podczas bezczynności i koordynować opróżnianie, aby umożliwić płynne wdrożenia — ma to znaczenie dla każdej osoby korzystającej z Hermes jako stale działającej usługi.²²
• Obsługa Google Vertex AI. Dostęp do Gemini za pośrednictwem kont usług GCP z automatycznym odświeżaniem tokenu OAuth2 dołącza do katalogu dostawców.²²
• Polecenie edytora /prompt. Otwiera $EDITOR, aby umożliwić tworzenie wielowierszowych promptów bez zmagania się z pojedynczym wierszem wprowadzania.²²

Przejście z wersji v0.17.x nie powoduje żadnych zmian niezgodnych wstecznie w CLI. Najważniejszymi powodami aktualizacji są kontrakty ukończenia (cele, które weryfikują własną realizację), pełnoprawny MoA z możliwymi do prześledzenia zespołami modeli oraz /learn do zapisywania procesów jako skills.

Co nowego w wersji v0.17.0 (wydanie Reach)

Nazwa Hermes Agent v0.17.0 (tag v2026.6.19, 19 czerwca 2026) nawiązuje do poszerzonego zasięgu agenta — nowych kanałów komunikacji, nowych dostawców modeli oraz większych możliwości sterowania z aplikacji komputerowej i panelu. Jest to rozszerzenie wersji v0.16.x; powierzchnia CLI pozostaje bez zmian.²¹

• Nowe kanały komunikacji. iMessage działa teraz bez przekaźnika na komputerze Mac dzięki Photon Spectrum (OAuth z kodem urządzenia, hermes photon login); WhatsApp Business Cloud API to oficjalny adapter Meta, który eliminuje konieczność korzystania z procesu pomostowego; SimpleX zyskuje grupy, natywne załączniki, grupowanie tekstu oraz automatyczne akceptowanie; natomiast Raft dołącza jako wbudowana wtyczka platformowa z prywatnym z założenia projektem kanału wybudzania.²¹
• Nowe modele i dostawcy. Do katalogu dodano z-ai/glm-5.2 (kontekst 1M), anthropic/claude-fable-5, laguna-m.1, nemotron-3-ultra oraz grok-composer-2.5-fast (model Cursor udostępniany przez xAI OAuth, kontekst 200k). Domyślny model xAI zmieniono na grok-build-0.1, a adaptacyjne modele Anthropic przestrzegają teraz współczesnego kontraktu wnioskowania (nigdy nie wysyłają pola reasoning).²¹
• Aplikacja komputerowa i panel. Aplikacja komputerowa zyskuje subagentów działających w tle z transmitującymi delegowane działania na żywo „oknami obserwacji” (delegate_task(background=true)), selektor modelu Composer, konfigurowalne skróty klawiaturowe, natywne powiadomienia systemowe, wersje robocze pola tworzenia wiadomości dla poszczególnych wątków, motywy z VS Code Marketplace oraz interfejs w języku japońskim i chińskim tradycyjnym. Panel zyskuje kompletny kreator profili (modele/skills/MCPs bez edytowania pliku config.yaml), globalny przełącznik profili, przeprojektowany Skills Hub ze skanowaniem zabezpieczeń, Automation Blueprints (sparametryzowane szablony dla formularzy, poleceń slash, rozmów i dokumentacji) oraz bezpieczne logowanie, które za bramą OAuth zwraca kod 401.²¹
• Skills i narzędzia. image_generate może teraz nie tylko tworzyć obraz od podstaw, lecz także edytować i przekształcać obraz źródłowy u każdego obsługiwanego dostawcy obrazów; narzędzie memory zyskało tablicę operations umożliwiającą atomowe, zbiorcze dodawanie, zastępowanie i usuwanie w jednym wywołaniu; nowy skill simplify-code uruchamia równoległy przegląd i porządkowanie przez 3 agentów, kontrolowane poziomem ryzyka opartym na zasadzie Chesterton’s Fence; trójstanowe ustawienie write_mode zastąpiono natomiast wartością logiczną write_approval.²¹
• Architektura. Subagenty działające w tle natychmiast zwracają uchwyt, a ich wynik trafia do rozmowy jako nowa tura; procedura pozyskiwania danych MCP pozwala uzyskać potwierdzenie w trakcie wywołania narzędzia, a narzędzia MCP łączące się z opóźnieniem są udostępniane między turami (bez naruszania pamięci podręcznej); cron staje się wymiennym CronScheduler z dostawcą zarządzanego cron Chronos; ponadto nowy zakres Managed (/etc/hermes) pozwala administratorowi przypinać konfigurację, której użytkownik nie może zmienić, a przekaźnik Gateway-Gateway umożliwia tworzenie topologii obejmujących wiele gateways.²¹
• Nowe polecenia. /version, /billing (interaktywne rozliczenia w terminalu), hermes photon login (uwierzytelnianie iMessage) oraz hermes curator run --consolidate — konsolidacja jest teraz opcjonalna, dzięki czemu rutynowa kuracja w tle nie zużywa żadnych tokenów.²¹
• Bezpieczeństwo. Wersja v0.17.0 usuwa możliwość obejścia listy blokad przez znaki ucieczki powłoki, domyślnie odrzuca operacje w razie braku modułów zatwierdzania i adapterów gateway z własnymi zasadami, oczyszcza środowisko podprocesów skryptów zadań cron, usuwa dane poufne ze zrzutów debugowania żądań, sprawdza konfiguracje stdio MCP pod kątem wzorców eksfiltracji oraz aktualizuje urllib3 i PyJWT, aby wyeliminować luki CVE.²¹

Przejście z wersji v0.16.x nie powoduje żadnych zmian niezgodnych wstecznie w CLI; wokół tego samego agenta pojawiają się jedynie nowe kanały, modele i powierzchnie. Najważniejszymi powodami aktualizacji są iMessage bez przekaźnika, oficjalne adaptery WhatsApp oraz administracyjny zakres Managed.

Co nowego w wersji v0.16.0 (wydanie Surface)

Nazwa Hermes Agent v0.16.0 (tag v2026.6.5, 5 czerwca 2026) nawiązuje do nowych powierzchni udostępnianych dla agenta, którego podstawą jest CLI. Najważniejsza zmiana: Hermes nie jest już ograniczony do terminala.²⁰

• Natywna aplikacja komputerowa. Hermes Desktop to nowa aplikacja Electron dla systemów macOS, Linux i Windows, z instalacją jednym kliknięciem oraz automatyczną aktualizacją w aplikacji. Oferuje okno czatu z przesyłaniem odpowiedzi na żywo, przeciąganie i upuszczanie plików, wklejanie obrazów ze schowka, paletę Cmd+K, listę sesji z archiwizacją i wyszukiwaniem oraz selektor modelu na pasku stanu. Może łączyć się ze zdalnym Hermes gateway przez bezpieczny WebSocket, korzystając z uwierzytelniania za pomocą OAuth albo nazwy użytkownika i hasła, ze zdalnymi hostami przypisanymi do poszczególnych profili oraz współbieżnymi sesjami wielu profili połączonymi odwołaniami @session między profilami. Interfejs aplikacji komputerowej zawiera również pełne tłumaczenie na uproszczony język chiński (简体中文), zaimplementowane za pomocą warstwy i18n z typami (display.language; domyślnym językiem pozostaje angielski).²⁰
• Panel administracyjny w przeglądarce. Lokalny panel internetowy przekształcono z widoku stanu w pełny panel administracyjny: katalog MCP z przełącznikami włączania i wyłączania, zarządzanie danymi uwierzytelniającymi, tworzenie webhooków i hooków, konfiguracja pamięci, sterowanie gateway oraz strona System ze sprawdzaniem przed aktualizacją i funkcją Debug Share uruchamianą jednym kliknięciem. Nowa strona Channels umożliwia konfigurowanie w przeglądarce każdej platformy komunikacyjnej gateway (Telegram, Discord, Slack i pozostałych). Uwierzytelnianie jest teraz wymienne: logowanie nazwą użytkownika i hasłem, ogólny samodzielnie hostowany dostawca OIDC, polecenie hermes dashboard register dla samodzielnie hostowanego klienta OAuth oraz rotacja sesji za pomocą tokenu odświeżania.²⁰
• Nowe polecenia CLI i polecenia slash. /undo [N] cofa ostatnie N tur użytkownika z uzupełnieniem wstępnym i miękkim usuwaniem; działa w CLI, TUI oraz na wszystkich platformach komunikacyjnych. Pojawia się konfigurowalny interfejs domyślny (cli lub tui) z możliwością zastąpienia go opcją --cli; TUI zyskuje ujednolicone polecenie /model oraz nakładkę Sessions. hermes portal jest czytelnym dla człowieka aliasem procesu wdrożeniowego Nous Portal, który oferuje nowe ścieżki pierwszego uruchomienia Quick Setup i Full Setup. Dodano również 2 narzędzia diagnostyczne: hermes prompt-size oraz hermes sessions optimize.²⁰
• Nowe modele i dostawcy. Selektor zyskuje modele deepseek-v4-flash, MiniMax-M3 (kontekst 1M, natywni dostawcy MiniMax), qwen3.7-plus (Nous + OpenRouter) oraz gemini-3.5-flash (Gemini OAuth + klucz API). Pełnoprawny dostawca xAI Grok OAuth dołącza do programu uruchamiającego aplikację komputerową, selektor modeli umożliwia teraz wyszukiwanie rozmyte na każdej powierzchni, dostawcy z wieloma punktami końcowymi są grupowani w jednym wierszu, a katalog jest odświeżany co godzinę zamiast raz dziennie.²⁰
• Odchudzone skills i stopniowe ujawnianie. Z domyślnego zestawu skills usunięto zbędne i nieaktywne pozycje (Spotify przeniesiono do natywnej wtyczki, Linear do hermes mcp install linear, a kilka nieaktualnych wpisów usunięto), więcej skills przeniesiono do opcjonalnych oraz dodano w metadanych frontmatter filtr istotności environments: (kanban/docker/s6), który ukrywa w indeksie skills przeznaczone do określonego kontekstu, dopóki nie zostaną wywołane. NVIDIA/skills jest teraz domyślnym zaufanym źródłem Skills Hub obok OpenAI, Anthropic i HuggingFace. Narzędzia MCP i wtyczek zyskały stopniowe (ograniczone zakresem) ujawnianie, a błąd MCP, który niepoprawnie zgłaszał powodzenie OAuth, gdy nie uzyskano tokenu, został naprawiony.²⁰
• Bezpieczeństwo. Wersja v0.16.0 przypina poprawioną wersję Starlette (≥1.0.1) ze względu na lukę CVE-2026-48710 (BadHost), przenosi kontrole adresów URL pod kątem SSRF poza pętlę zdarzeń w ścieżkach asynchronicznych, usuwa token okaziciela wnioskowania Bedrock ze środowiska podprocesów, dodaje bws_cache.json do zabezpieczenia odczytu plików, dodaje docker restart/stop/kill do listy niebezpiecznych wzorców oraz usuwa niewidoczne znaki Unicode ze sprawdzonej zawartości skills. Wydanie zamknęło 2 problemy P0 i 62 problemy P1, z których 16 oznaczono jako związane z bezpieczeństwem.²⁰

Przejście z wersji v0.15.x nie powoduje żadnych zmian niezgodnych wstecznie w samym CLI; wokół tego samego agenta dodano jedynie nowe powierzchnie i nowych dostawców. Aplikacja komputerowa i panel administracyjny są głównymi powodami aktualizacji, jeśli Hermes ma służyć użytkownikom niekorzystającym z terminala albo zdalny gateway ma być administrowany z przeglądarki.

Instalacja

Jednowierszowy instalator jest oficjalnie obsługiwaną metodą instalacji. Obsługuje Python, uv, Node.js, ripgrep, ffmpeg, klonowanie repozytorium, środowisko wirtualne oraz globalne polecenie hermes.⁷

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Instalacje przez pip i Homebrew są przestarzałe od wersji v0.19.0. Pakiet PyPI wprowadzony w wersji v0.14.0 (pip install hermes-agent) oraz formuła Homebrew są obecnie oznaczone jako „nieobsługiwane rozwiązania starszego typu” — po wykryciu takiej instalacji Hermes wyświetla ostrzeżenie w każdym interfejsie, ale nie blokuje działania. Planowane jest zaprzestanie publikowania w PyPI i Homebrew. Jeśli instalację przeprowadzono przez pip lub brew, należy przejść na instalator podany powyżej.²³

Działa w systemach Linux, macOS, WSL2 oraz Android/Termux (instalator automatycznie wykrywa Termux i przełącza się na przetestowany pakiet dla systemu Android).⁷ Wersja v0.14.0 wprowadza natywną obsługę systemu Windows we wczesnej wersji beta za pomocą instalatora PowerShell, jednak do zastosowań produkcyjnych bezpieczniejszym wyborem pozostaje WSL2, dopóki obsługa natywnej instalacji w systemie Windows nie osiągnie większej dojrzałości.¹⁹

Po zakończeniu instalacji:

source ~/.bashrc    # or ~/.zshrc
hermes              # Start chatting

Jedynym wymaganiem wstępnym jest git. Instalator automatycznie instaluje Python 3.11 za pomocą uv (bez konieczności używania sudo), Node.js v22 (do automatyzacji przeglądarki i mostu WhatsApp), ripgrep oraz ffmpeg.⁷

Weryfikacja instalacji

hermes version      # Check version
hermes doctor       # Diagnose config/dependency issues
hermes status       # Show current configuration + auth state
hermes dump         # Copy-pasteable setup summary for debugging

hermes doctor precyzyjnie wskazuje brakujące elementy i sposób rozwiązania problemu.⁷ hermes dump to polecenie diagnostyczne, którego wynik można wkleić do zgłoszenia w GitHub lub wątku na Discordzie podczas zwracania się o pomoc — jest to tekstowe podsumowanie całej konfiguracji, z którego usunięto dane poufne.⁸

Instalacja ręczna

Jeśli potrzebna jest pełna kontrola — niestandardowa wersja Python, określone dodatki lub integracja z Nix/NixOS — ręczny proces opisano krok po kroku w oficjalnym przewodniku instalacji.⁷ Najważniejsze opcjonalne dodatki, które można łączyć z uv pip install -e ".[<extras>]":

Polecenie instalacji w Termux jest inne — używa pip z plikiem ograniczeń zamiast uv pip:

python -m pip install -e ".[termux]" -c constraints-termux.txt

Wynika to z faktu, że .[all] w systemie Android instaluje faster-whisper za pośrednictwem dodatku voice, który zależy od pakietów binarnych ctranslate2 niedostępnych dla systemu Android.⁷

Uwierzytelnianie i dostawcy

Hermes obsługuje około 22 natywnie zintegrowanych dostawców oraz niestandardowe endpointy (wersja 0.19.0 dodaje Fireworks AI, DeepInfra i Upstage Solar), a także 3 odrębne ścieżki uwierzytelniania. Poniżej przedstawiono pełny zakres opcji uwierzytelniania, uporządkowany według ścieżek, aby łatwo można było znaleźć rozwiązanie odpowiadające posiadanym zasobom.

3 ścieżki uwierzytelniania

Każdy dostawca w Hermes korzysta z jednego z 3 schematów uwierzytelniania:

Ścieżka 1 — klucz API w .env. Klucz należy umieścić w ~/.hermes/.env, a Hermes odczyta go podczas uruchamiania. Tej ścieżki używają OpenRouter, AI Gateway, z.ai/GLM, Kimi/Moonshot, MiniMax (w tym MiniMax China), Alibaba Cloud/DashScope, Kilo Code, OpenCode Zen, OpenCode Go, DeepSeek, Hugging Face, Google/Gemini oraz większość zewnętrznych dostawców.² Od wersji 0.19.0 klucz nie musi już znajdować się w pliku tekstowym: rozszerzalny interfejs SecretSource może podczas wczytywania pobierać sekrety z Bitwarden lub 1Password (odwołania op://), obsługując jednocześnie wiele sejfów, deterministyczną kolejność pierwszeństwa, ostrzeżenia o konfliktach oraz informacje o pochodzeniu poszczególnych zmiennych — .env pozostaje rozwiązaniem rezerwowym. (Jest to rozwiązanie odmienne od tokenu inicjującego Bitwarden Secrets Manager z wersji 0.15.0, który konsolidował klucze dostawców za jednym tokenem; SecretSource zastępuje sam plik tekstowy, a przyszłych dostawców sejfów będzie można dodawać jako pluginy.)²³

Ścieżka 2 — OAuth przez hermes model lub hermes auth. Uruchamia przepływ kodu urządzenia, otwiera przeglądarkę i zapisuje dane uwierzytelniające w ~/.hermes/auth.json (może też importować istniejące dane uwierzytelniające z narzędzi takich jak Claude Code lub Codex CLI). Tej ścieżki używają Nous Portal, OpenAI Codex (konto ChatGPT), GitHub Copilot oraz Anthropic (Claude Pro/Max).²

Ścieżka 3 — niestandardowy endpoint w config.yaml. Przeznaczona dla dowolnego endpointu API zgodnego z OpenAI — Ollama, vLLM, SGLang, llama.cpp, LM Studio, proxy LiteLLM, Together AI, Groq, Azure OpenAI lub własnego serwera utrzymywanego samodzielnie. Konfigurację przeprowadza się raz za pomocą hermes model → Custom endpoint, po czym zostaje ona zapisana w config.yaml.²

Pełna macierz dostawców

Poniżej znajduje się pełna lista natywnie zintegrowanych dostawców wraz z dokładnym procesem konfiguracji każdego z nich.²

Od wersji 0.19.0 można również ukrywać nieużywanych dostawców: flaga enabled: false ustawiana dla poszczególnych dostawców oraz klucz konfiguracyjny excluded_providers usuwają ich z selektorów /model i wbudowanego mechanizmu rozpoznawania dostawców.²³

Anthropic: 3 metody uwierzytelniania

Anthropic wymaga osobnej sekcji, ponieważ Hermes obsługuje 3 różne ścieżki dostępu do Claude, a wybór właściwej ma znaczenie. Zgodnie z dokumentacją źródłową:²

# Method 1: API key (pay-per-token)
export ANTHROPIC_API_KEY=***
hermes chat --provider anthropic --model claude-sonnet-4-6

# Method 2: OAuth through hermes model (preferred)
# Uses Claude Code's credential store when available
hermes model

# Method 3: Manual setup-token (fallback/legacy)
export ANTHROPIC_TOKEN=***
hermes chat --provider anthropic

# Auto-detect Claude Code credentials
hermes chat --provider anthropic   # reads Claude Code files automatically

Po wybraniu uwierzytelniania Anthropic przez OAuth za pomocą hermes model Hermes preferuje własny magazyn danych uwierzytelniających Claude Code, zamiast kopiować token do ~/.hermes/.env. Dzięki temu dane uwierzytelniające Claude, które można odświeżać, zachowują tę możliwość.² Jeżeli na tym samym komputerze jest już używany Claude Code, jest to najprostsza ścieżka.

Aby na stałe ustawić Anthropic w config.yaml:

model:
  provider: "anthropic"
  default: "claude-sonnet-4-6"

--provider claude i --provider claude-code również działają jako skróty dla --provider anthropic.²

GitHub Copilot: 2 tryby

Copilot jest obsługiwany w 2 trybach: bezpośredni Copilot API (zalecany) oraz Copilot ACP (który uruchamia lokalny CLI Copilot jako podproces).²

# Direct Copilot API
hermes chat --provider copilot --model gpt-5.4

# Copilot ACP (requires the Copilot CLI in PATH + an existing copilot login)
hermes chat --provider copilot-acp --model copilot-acp

Zgodnie z dokumentacją źródłową uwierzytelnianie jest sprawdzane w następującej kolejności:² 1. Zmienna środowiskowa COPILOT_GITHUB_TOKEN 2. Zmienna środowiskowa GH_TOKEN 3. Zmienna środowiskowa GITHUB_TOKEN 4. Awaryjne użycie CLI gh auth token 5. Logowanie kodem urządzenia przez OAuth za pomocą hermes model

Typ tokenu ma znaczenie. Copilot API nie obsługuje klasycznych tokenów Personal Access Token (ghp_*). Obsługiwane są tokeny OAuth (gho_*), precyzyjnie ograniczone tokeny PAT (github_pat_* z uprawnieniem Copilot Requests) oraz tokeny GitHub App (ghu_*). Jeżeli gh auth token zwraca token ghp_*, zamiast tego należy użyć hermes model, aby uwierzytelnić się przez OAuth.²

Chińscy dostawcy AI (natywna obsługa)

Hermes ma wbudowaną obsługę z.ai/GLM, Kimi/Moonshot, MiniMax (endpointy globalne i chińskie) oraz Alibaba Cloud z dedykowanymi identyfikatorami dostawców.²

# z.ai / ZhipuAI GLM
hermes chat --provider zai --model glm-5                 # Requires: GLM_API_KEY

# Kimi / Moonshot AI
hermes chat --provider kimi-coding --model kimi-for-coding   # Requires: KIMI_API_KEY

# MiniMax (global)
hermes chat --provider minimax --model MiniMax-M2.7          # Requires: MINIMAX_API_KEY

# MiniMax (China)
hermes chat --provider minimax-cn --model MiniMax-M2.7       # Requires: MINIMAX_CN_API_KEY

# Alibaba Cloud / DashScope (Qwen)
hermes chat --provider alibaba --model qwen3.5-plus          # Requires: DASHSCOPE_API_KEY

Bazowe adresy URL można zastąpić za pomocą zmiennych środowiskowych GLM_BASE_URL, KIMI_BASE_URL, MINIMAX_BASE_URL, MINIMAX_CN_BASE_URL lub DASHSCOPE_BASE_URL.²

Z.AI automatycznie wykrywa endpoint. Podczas korzystania z dostawcy z.ai/GLM Hermes testuje wiele endpointów (globalne, chińskie i warianty programistyczne), aby znaleźć taki, który akceptuje dany klucz API. Działający endpoint jest automatycznie zapisywany w pamięci podręcznej — większość użytkowników nie musi ustawiać GLM_BASE_URL.²

xAI (Grok) automatycznie włącza buforowanie promptów. Gdy bazowy adres URL zawiera x.ai, Hermes wysyła nagłówek x-grok-conv-id z każdym żądaniem, aby kierować je do tego samego serwera w ramach sesji konwersacji oraz ponownie wykorzystywać zapisane w pamięci podręcznej prompty systemowe i historię.² Odbywa się to automatycznie i nie wymaga konfiguracji.

Polecenie hermes auth

hermes auth to polecenie służące do zarządzania pulami danych uwierzytelniających oraz danymi uwierzytelniającymi OAuth.⁶

hermes auth                              # Interactive wizard
hermes auth list                         # Show all credential pools
hermes auth list openrouter              # Show one provider's pool
hermes auth add openrouter --api-key sk-or-v1-xxx
hermes auth add anthropic --type oauth
hermes auth remove openrouter 2          # Remove by index
hermes auth reset openrouter             # Clear cooldowns

Pule danych uwierzytelniających umożliwiają rotację wielu kluczy API lub tokenów OAuth tego samego dostawcy — przydaje się to do rozdzielania limitów żądań między wiele kluczy bez zmiany kodu.⁶ Starsze polecenia hermes login / hermes logout zostały usunięte; zamiast nich należy używać hermes auth.⁶

Niestandardowe i samodzielnie utrzymywane endpointy

Hermes współpracuje z każdym endpointem API zgodnym z OpenAI. Jeżeli serwer implementuje /v1/chat/completions, można skierować do niego Hermes.²

Konfiguracja interaktywna (zalecana):

hermes model
# Select "Custom endpoint (self-hosted / VLLM / etc.)"
# Enter: API base URL, API key, Model name

Ręczna konfiguracja config.yaml:

model:
  default: your-model-name
  provider: custom
  base_url: http://localhost:8000/v1
  api_key: your-key-or-leave-empty-for-local

Oba podejścia zapisują ustawienia w config.yaml, który stanowi jedyne źródło prawdy dotyczące głównego modelu, dostawcy i bazowego adresu URL.² Starsze zmienne środowiskowe OPENAI_BASE_URL oraz LLM_MODEL nie są już odczytywane podczas konfiguracji głównego modelu — należy użyć hermes model lub bezpośrednio edytować config.yaml.² (OPENAI_BASE_URL i OPENAI_API_KEY są nadal respektowane jako rozwiązanie rezerwowe dla pomocniczej ścieżki routingu provider: "main", dlatego nie należy ich usuwać bez sprawdzenia, jeśli są tam używane.)⁴

Przełączanie niestandardowych endpointów w trakcie sesji:

/model custom:qwen-2.5             # Custom endpoint with explicit model
/model custom                      # Auto-detect the model from the endpoint
/model custom:local:qwen-2.5       # Named custom provider "local"
/model custom:work:llama3          # Named custom provider "work"
/model openrouter:claude-sonnet-4  # Back to a cloud provider

/model custom (bez nazwy modelu) wysyła zapytanie do API /v1/models danego endpointu i automatycznie wybiera model, jeżeli załadowano dokładnie 1 — jest to przydatne w przypadku lokalnych serwerów uruchamiających pojedynczy model.²

Lokalne serwery LLM (szablony konfiguracji)

Dokumentacja źródłowa zawiera kompletne przewodniki konfiguracji Ollama, vLLM, SGLang, llama.cpp i LM Studio. Poniżej przedstawiono najważniejsze polecenia, które rzeczywiście trzeba uruchomić. Każde z nich ma utworzyć działający endpoint, do którego można skierować Hermes.²

Ollama — najłatwiejsza ścieżka lokalna, bez konfiguracji:

ollama pull qwen2.5-coder:32b
OLLAMA_CONTEXT_LENGTH=32768 ollama serve   # Raise from 4k default
hermes model   # Custom endpoint → http://localhost:11434/v1 → qwen2.5-coder:32b

Istotna pułapka Ollama: domyślnie Ollama używa bardzo małych długości kontekstu (4096 tokenów przy mniej niż 24 GB VRAM). Należy je zwiększyć za pomocą OLLAMA_CONTEXT_LENGTH lub pliku Modelfile — zgodny z OpenAI API nie przyjmuje długości kontekstu od klienta, dlatego Hermes nie może ustawić jej automatycznie.² Do zastosowań agentowych należy ustawić co najmniej 16–32 tys.

vLLM — wysokowydajne udostępnianie GPU:

pip install vllm
vllm serve meta-llama/Llama-3.1-70B-Instruct \
  --port 8000 \
  --max-model-len 65536 \
  --tensor-parallel-size 2 \
  --enable-auto-tool-choice \
  --tool-call-parser hermes

Wywoływanie narzędzi wymaga --enable-auto-tool-choice oraz --tool-call-parser <name>. Obsługiwane parsery: hermes (Qwen 2.5, Hermes 2/3), llama3_json, mistral, deepseek_v3, deepseek_v31, xlam, pythonic. Bez tych flag wywołania narzędzi będą zwracane jako zwykły tekst.²

SGLang — szybkie udostępnianie z RadixAttention do ponownego używania pamięci podręcznej KV:

pip install "sglang[all]"
python -m sglang.launch_server \
  --model meta-llama/Llama-3.1-70B-Instruct \
  --port 30000 \
  --context-length 65536 \
  --tp 2 \
  --tool-call-parser qwen

Pułapka SGLang: domyślna wartość max_tokens wynosi 128. Jeżeli odpowiedzi są ucinane, należy ustawić --default-max-tokens na serwerze lub skonfigurować model.max_tokens w config.yaml.²

llama.cpp / llama-server — procesory CPU i Metal na Apple Silicon:

./build/bin/llama-server \
  --jinja -fa \
  -c 32768 \
  -ngl 99 \
  -m models/qwen2.5-coder-32b-instruct-Q4_K_M.gguf \
  --port 8080 --host 0.0.0.0

--jinja jest wymagane do wywoływania narzędzi. Bez tej opcji llama-server całkowicie ignoruje parametr tools, a model próbuje wywoływać narzędzia, zapisując JSON w treści odpowiedzi — Hermes nie potrafi jednak zinterpretować tego jako rzeczywistych wywołań narzędzi.²

LM Studio — aplikacja komputerowa z interfejsem graficznym:

Serwer należy uruchomić w aplikacji LM Studio (karta Developer → Start Server) lub za pomocą CLI: lms server start (uruchamia serwer na porcie 1234) oraz lms load qwen2.5-coder --context-length 32768.² Następnie należy skierować hermes model do http://localhost:1234/v1.

Istotna pułapka LM Studio: LM Studio odczytuje długość kontekstu z metadanych modelu, lecz wiele modeli GGUF podaje domyślnie 2048 lub 4096. Długość kontekstu należy zawsze jawnie ustawić w ustawieniach modelu LM Studio — kliknąć ikonę koła zębatego obok selektora modelu, ustawić „Context Length” na co najmniej 16384 (najlepiej 32768), a następnie ponownie załadować model.²

Nazwani niestandardowi dostawcy

Jeżeli korzysta się z wielu niestandardowych endpointów (na przykład lokalnego serwera programistycznego i zdalnego serwera GPU), można zdefiniować je jako nazwanych niestandardowych dostawców w config.yaml:²

custom_providers:
  - name: local
    base_url: http://localhost:8080/v1
    # api_key omitted — Hermes uses "no-key-required" for keyless local servers
  - name: work
    base_url: https://gpu-server.internal.corp/v1
    api_key: corp-api-key
    api_mode: chat_completions      # optional, auto-detected from URL
  - name: anthropic-proxy
    base_url: https://proxy.example.com/anthropic
    api_key: proxy-key
    api_mode: anthropic_messages    # for Anthropic-compatible proxies

Następnie można przełączać się między nimi w trakcie sesji za pomocą potrójnej składni:

/model custom:local:qwen-2.5
/model custom:work:llama3-70b
/model custom:anthropic-proxy:claude-sonnet-4

Nazwanych niestandardowych dostawców można również wybierać z interaktywnego menu hermes model.²

Rozszerzalna architektura dostawców (od wersji 0.13.0)

Wersja 0.13.0 wprowadza klasę abstrakcyjną ProviderProfile oraz folder plugins/model-providers/, dzięki którym zewnętrzni dostawcy inferencji mogą być dodawani bez modyfikowania głównego kodu.¹⁸ Jeżeli dostawca obsługuje tryb API zgodny z OpenAI, Anthropic lub Codex, można zaimplementować podklasę ProviderProfile, która deklaruje ścieżkę uwierzytelniania, bazowy adres URL, katalog modeli i nagłówki pamięci podręcznej; Hermes rozpoznaje ją za pośrednictwem tej samej ścieżki runtime_provider.py, z której korzystają wbudowani dostawcy. To właśnie ta zmiana architektoniczna umożliwiła rozszerzenie listy dostawców w wersji 0.13.0: zamiast edytować główny kod w celu dodania dostawcy, udostępnia się plugin.

Lokalne proxy zgodne z OpenAI (od wersji 0.14.0)

hermes proxy udostępnia lokalny endpoint zgodny z OpenAI, obsługiwany przez dostawcę OAuth, u którego Hermes jest już zalogowany — Claude Pro, ChatGPT Pro, SuperGrok lub innego zgodnego, skonfigurowanego dostawcę.¹⁹ Oznacza to, że narzędzia oczekujące API w stylu OpenAI, w tym Codex CLI, Aider, Cline, Continue czy niestandardowe skrypty, mogą ponownie wykorzystywać uwierzytelnianie Hermes oparte na subskrypcji bez osobnego klucza API. Proxy należy traktować jako lokalną infrastrukturę programistyczną: świadomie wybrać adres nasłuchiwania, nie udostępniać go szeroko i pamiętać o warunkach właściwych dla poszczególnych dostawców.

Wykrywanie długości kontekstu

Zgodnie z dokumentacją źródłową 2 ustawienia są stale ze sobą mylone:²

• context_length — całe okno kontekstu (łączny budżet tokenów wejściowych i wyjściowych, np. 1 000 000 dla Claude Opus 4.7 lub 200 000 dla Sonnet 4.6). Hermes używa tej wartości, aby określić, kiedy skompresować historię.
• model.max_tokens — limit danych wyjściowych (maksymalna liczba tokenów, które model może wygenerować w pojedynczej odpowiedzi). Nie ma związku z długością historii.

Gdy automatyczne wykrywanie błędnie ustala rozmiar okna, należy ustawić context_length:

model:
  default: "qwen3.5:9b"
  base_url: "http://localhost:8080/v1"
  context_length: 131072      # tokens

Do wykrywania okien kontekstu Hermes używa wieloźródłowego łańcucha rozpoznawania: nadpisanie w konfiguracji → ustawienie dla modelu u niestandardowego dostawcy → trwała pamięć podręczna → /models endpointu → Anthropic /v1/models → OpenRouter API → Nous Portal → models.dev (rejestr utrzymywany przez społeczność, obejmujący ponad 3800 modeli) → wartości domyślne (128K).² System uwzględnia dostawcę, dlatego ten sam model może mieć różne limity kontekstu w zależności od tego, kto go udostępnia (np. claude-opus-4.6 ma 1 mln bezpośrednio w Anthropic, ale 128K w GitHub Copilot).²

Rotacja dostawców i rozwiązanie rezerwowe

Pule danych uwierzytelniających. Jeśli dostępnych jest wiele kluczy API tego samego dostawcy, strategię rotacji należy skonfigurować za pomocą hermes auth. W ten sposób można rozdzielić limity żądań między wiele kluczy.⁶

Model rezerwowy. Można skonfigurować zapasową parę provider:model, na którą Hermes automatycznie przełączy się w przypadku awarii modelu głównego (limity żądań, błędy serwera, błędy uwierzytelniania):²

fallback_model:
  provider: openrouter            # required
  model: anthropic/claude-sonnet-4  # required
  # base_url: http://localhost:8000/v1    # optional, for custom endpoints
  # api_key_env: MY_CUSTOM_KEY           # optional, env var name

Mechanizm rezerwowy zmienia model i dostawcę w trakcie sesji bez utraty konwersacji. Uruchamia się najwyżej raz na sesję.² Dostawcy obsługujący mechanizm rezerwowy: openrouter, nous, openai-codex, copilot, copilot-acp, anthropic, huggingface, zai, kimi-coding, minimax, minimax-cn, deepseek, ai-gateway, opencode-zen, opencode-go, kilocode, alibaba, custom.²

Modele pomocnicze

Hermes używa lekkich modeli „pomocniczych” do zadań pobocznych: analizy obrazów, podsumowywania stron internetowych, analizy zrzutów ekranu z przeglądarki, klasyfikowania zatwierdzeń niebezpiecznych poleceń, kompresji kontekstu, podsumowywania wyników wyszukiwania sesji, dopasowywania skill, przekazywania zadań narzędziom MCP oraz zapisywania pamięci.⁴ Domyślnie zadania te wykorzystują Gemini Flash przez automatyczne wykrywanie (OpenRouter → Nous → Codex).

Można skonfigurować model i dostawcę używane przez każde zadanie pomocnicze. Każdy slot pomocniczy korzysta z tych samych 3 parametrów: provider, model, base_url.⁴

auxiliary:
  vision:
    provider: "auto"                # "auto", "openrouter", "nous", "codex", "main", etc.
    model: ""                       # e.g. "openai/gpt-4o", "google/gemini-2.5-flash"
    base_url: ""                    # Custom OpenAI-compatible endpoint
    api_key: ""                     # Falls back to OPENAI_API_KEY
    timeout: 30
    download_timeout: 30
  web_extract:
    provider: "auto"
    model: ""
    timeout: 360
  approval:
    provider: "auto"
    model: ""
    timeout: 30
  compression:
    timeout: 120
  session_search: { provider: "auto", model: "", timeout: 30 }
  skills_hub:    { provider: "auto", model: "", timeout: 30 }
  mcp:           { provider: "auto", model: "", timeout: 30 }
  flush_memories:{ provider: "auto", model: "", timeout: 30 }

Opcja dostawcy "main" oznacza „użyj dostawcy, z którego korzysta mój główny agent” — jest prawidłowa wyłącznie w konfiguracjach auxiliary:, compression: oraz fallback_model:. Nie można jej używać w ustawieniu model.provider najwyższego poziomu. Jeżeli jako model główny używany jest niestandardowy endpoint zgodny z OpenAI, w sekcji model: należy ustawić provider: custom.⁴

Dlaczego ma to znaczenie: jeśli skonfigurowano wyłącznie Anthropic OAuth (bez klucza OpenRouter), funkcje analizy obrazu, podsumowywania stron internetowych i kompresji będą działać gorzej lub przestaną działać, ponieważ domyślny łańcuch rezerwowy modeli pomocniczych najpierw próbuje użyć OpenRouter. Należy dodać OPENROUTER_API_KEY na potrzeby zadań pomocniczych albo skonfigurować każdy slot pomocniczy tak, aby korzystał z głównego dostawcy:

auxiliary:
  vision:
    provider: "main"
  web_extract:
    provider: "main"

To najczęstsza przyczyna problemu „moje funkcje po cichu nie działają” u nowych użytkowników Hermes.

System konfiguracji

Hermes korzysta z warstwowego systemu konfiguracji. Zrozumienie kolejności priorytetów jest kluczowe, ponieważ wyższe warstwy nadpisują niższe, a jedną z nich stanowi globalny rejestr dostawców, którego nie widać w pliku config.yaml.

Układ plików konfiguracyjnych

Zgodnie z dokumentacją projektu konfiguracja Hermes składa się z następujących plików:⁴

~/.hermes/
├── config.yaml       # All settings (model, terminal, TTS, compression, memory, toolsets, ...)
├── .env              # Secrets (API keys, bot tokens, passwords)
├── auth.json         # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md           # Primary agent identity (slot #1 in system prompt)
├── memories/         # Persistent memory (MEMORY.md, USER.md)
├── skills/           # Bundled + agent-created + hub-installed skills
├── cron/             # Scheduled jobs
├── sessions/         # Gateway session state
└── logs/             # agent.log, gateway.log, errors.log (secrets auto-redacted)

config.yaml a .env — jeśli ustawienie znajduje się w obu plikach, w przypadku ustawień innych niż dane poufne pierwszeństwo ma config.yaml.⁴ Obowiązuje następująca zasada: - Dane poufne (klucze API, tokeny botów, hasła) → .env - Wszystkie pozostałe ustawienia (model, backend terminala, ustawienia kompresji, limity pamięci, toolsets) → config.yaml

Do danych poufnych można odwoływać się w pliku config.yaml za pomocą interpolacji w stylu powłoki:⁴

auxiliary:
  vision:
    api_key: ${GOOGLE_API_KEY}
    base_url: ${CUSTOM_VISION_URL}
  delegation:
    api_key: ${DELEGATION_KEY}

Zarządzanie konfiguracją

hermes config                # View current configuration
hermes config show           # Same as above
hermes config edit           # Open config.yaml in your editor
hermes config set KEY VAL    # Set a specific value
hermes config get KEY        # Print a single value (v0.19.0+)
hermes config unset KEY      # Remove a key so the default applies again (v0.19.0+)
hermes config path           # Print the config file path
hermes config env-path       # Print the .env file path
hermes config check          # Check for missing options (after updates)
hermes config migrate        # Interactively add missing options

Przykłady:⁴

hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...   # Saves to .env

hermes config check i hermes config migrate to polecenia, które należy uruchamiać po każdym hermes update — wykrywają nowo dodane opcje konfiguracji, których jeszcze nie ma w używanym pliku.⁶

Kolejność priorytetów konfiguracji

Hermes wczytuje konfigurację z kilku źródeł. Jeśli to samo ustawienie zostanie zdefiniowane w wielu źródłach, pierwszeństwo ma źródło o wyższym priorytecie:⁴

1. Argumenty CLI — hermes chat --model anthropic/claude-sonnet-4 (nadpisanie dla pojedynczego wywołania)
2. Zmienne środowiskowe — stosowane podczas uruchamiania procesu
3. config.yaml — główny plik ustawień
4. .env — wyłącznie dane poufne
5. Wbudowane wartości domyślne — stosowane, gdy wartość nie została ustawiona w żadnym innym miejscu

Flagi CLI zawsze mają pierwszeństwo w ramach danego wywołania. Długoterminowym źródłem prawdy pozostaje config.yaml.

Lokalizacja (v0.13.0+)

W wersji v0.13.0 dodano 7 wersji językowych komunikatów CLI i gateway: chińską (uproszczoną), japońską, niemiecką, hiszpańską, francuską, ukraińską i turecką.¹⁸ Wersja v0.14.0 wprowadza lokalizację wszystkich poleceń gateway oraz panelu internetowego, dodaje 8 kolejnych wersji językowych i zwiększa ich łączną liczbę do 16.¹⁹ Dokumentacja jest obecnie dostępna w wersji zlokalizowanej wyłącznie dla zh-Hans. Wersja językowa jest ustalana na podstawie zmiennych środowiskowych LC_ALL / LANG albo jawnego klucza locale: w pliku config.yaml. Domyślną wersją i źródłem prawdy dla każdego tekstu, którego nie objęto jeszcze tłumaczeniem, pozostaje język angielski.

Profiles — wiele odizolowanych instancji Hermes

Profiles umożliwiają korzystanie z wielu odizolowanych instancji Hermes, z których każda ma własną konfigurację, sesje, skills, pamięć i PID gateway. W ten sposób można uruchomić obok siebie „służbową instancję Hermes” i „prywatną instancję Hermes”, bez wzajemnego dostępu do ich stanu.⁶

hermes profile list
hermes profile create work --clone                  # Clone from current profile
hermes profile use work                             # Set sticky default
hermes profile alias work --name h-work             # Create wrapper script
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes -p work chat -q "Hello from work profile"    # One-off without switching

Każdy profile otrzymuje własny katalog HERMES_HOME (domyślnie ~/.hermes-<name>/), dzięki czemu wiele profiles może jednocześnie uruchamiać gateway bez wzajemnych konfliktów.⁶³

Polecenia CLI

Ta sekcja stanowi praktyczny przewodnik po poleceniach najwyższego poziomu CLI. Oficjalne informacje oparte na kodzie źródłowym zawiera dokumentacja nadrzędnego projektu Polecenia CLI.⁶

Opcje globalne

hermes [global-options] <command> [subcommand/options]

Polecenia najwyższego poziomu

hermes chat — główny punkt wejścia

Polecenie hermes bez argumentów uruchamia interaktywny czat. hermes chat jest jego jawną formą z opcjami:⁶

hermes chat -q "Summarize the latest PRs"           # One-shot, non-interactive
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills          # Enable specific toolsets
hermes chat --quiet -q "Return only JSON"           # Programmatic mode
hermes chat --worktree -q "Review repo and open a PR"

Najważniejsze opcje:

hermes setup — pełny kreator

Uruchamia pełny kreator konfiguracji lub przechodzi bezpośrednio do jednej z jego sekcji:⁶

hermes setup                 # Full wizard
hermes setup model           # Provider and model only
hermes setup terminal        # Terminal backend only
hermes setup gateway         # Messaging platforms only
hermes setup tools           # Tool enable/disable per platform
hermes setup agent           # Agent behavior only
hermes setup --non-interactive
hermes setup --reset         # Reset config to defaults before setup

hermes logs — uporządkowane przeszukiwanie dzienników

Polecenie hermes logs oferuje więcej możliwości niż tail -f uruchomione na plikach dziennika, ponieważ pozwala jednocześnie filtrować według poziomu, identyfikatora sesji i zakresu czasu.⁶

hermes logs                          # Last 50 lines of agent.log
hermes logs -f                       # Follow in real time
hermes logs gateway -n 100           # Last 100 lines of gateway.log
hermes logs --level WARNING --since 1h   # Warnings from the last hour
hermes logs --session abc123         # Filter by session ID substring
hermes logs errors --since 30m -f    # Follow errors.log from 30m ago
hermes logs list                     # List all log files with sizes

Pliki dziennika znajdują się w ~/.hermes/logs/:⁶ - agent.log — cała aktywność agenta (wywołania API, przekazywanie zadań narzędziom, cykl życia sesji, poziom INFO i wyższe) - errors.log — wyłącznie ostrzeżenia i błędy (odfiltrowany podzbiór pliku agent.log) - gateway.log — aktywność gateway komunikatora (połączenia z platformami, przekazywanie zadań, webhooki)

Rotacja odbywa się automatycznie za pomocą RotatingFileHandler z biblioteki Python — należy szukać plików agent.log.1, agent.log.2 itd.⁶

hermes doctor — diagnostyka

W razie problemów jako pierwsze należy uruchomić polecenie hermes doctor [--fix]. Sprawdza ono poprawność konfiguracji, obecność zależności, dostępność klucza API i stan usług, a z opcją --fix może podjąć próbę automatycznej naprawy.⁶

Aby udostępnić diagnostykę innej osobie, należy użyć polecenia hermes dump — tworzy ono zwięzłe podsumowanie w postaci zwykłego tekstu, z ukrytymi kluczami API, gotowe do wklejenia w zgłoszeniu GitHub lub wątku na Discord.⁶

Polecenia slash

Polecenia slash działają w aktywnej sesji czatu (CLI lub na platformie komunikacyjnej). Są obsługiwane za pośrednictwem wspólnego rejestru COMMAND_REGISTRY w pliku hermes_cli/commands.py, dlatego większość poleceń działa identycznie we wszystkich interfejsach.⁹

Zarządzanie sesją

Konfiguracja i model

Polecenie /model jest podstawowym narzędziem do przełączania dostawców w trakcie sesji:⁹

/model                              # Show current model and options
/model claude-sonnet-4              # Switch model (auto-detect provider)
/model zai:glm-5                    # Switch provider:model
/model custom:qwen-2.5              # Use model on custom endpoint
/model custom                       # Auto-detect model from custom endpoint
/model custom:local:qwen-2.5        # Named custom provider
/model openrouter:anthropic/claude-sonnet-4   # Back to cloud

Wersja v0.19.0 dodaje /model --once — jednorazowe zastąpienie modelu na 1 turę, po której odpowiedzi poprzedni model zostaje automatycznie przywrócony.²³

Narzędzia, skills i informacje

Dynamiczne polecenia slash dla skills

Każdy zainstalowany skill jest automatycznie udostępniany jako polecenie slash:⁹

/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor
/excalidraw       # Just the skill name loads it and lets the agent ask what you need

Od wersji v0.19.0 wywołania skills za pomocą poleceń slash można łączyć: /skill-a /skill-b do XYZ wczytuje oba skills po kolei w ramach 1 tury, zapewniając autouzupełnianie i tekst podpowiedzi dla połączonych nazw.²³

W config.yaml można również definiować szybkie polecenia, które przypisują krótką nazwę do dłuższego promptu:⁹

quick_commands:
  review: "Review my latest git diff and suggest improvements"
  deploy: "Run the deployment script at scripts/deploy.sh and verify the output"
  morning: "Check my calendar, unread emails, and summarize today's priorities"

Następnie w CLI należy wpisać /review, /deploy lub /morning.

Dopasowywanie prefiksów

Polecenia obsługują dopasowywanie prefiksów: wpisanie /h wywołuje /help, a /mod — /model. Gdy prefiks jest niejednoznaczny, wybierana jest pierwsza pozycja zgodnie z kolejnością w rejestrze. Pełne nazwy poleceń i zarejestrowane aliasy zawsze mają pierwszeństwo przed dopasowaniami prefiksów.⁹

Polecenia specyficzne dla platform komunikacyjnych

Niektóre polecenia działają wyłącznie na platformach komunikacyjnych (Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant):⁹

• /status — wyświetlenie informacji o sesji
• /sethome (alias /set-home) — oznaczenie bieżącego czatu jako platform home
• /approve [session|always] — zatwierdzenie oczekującego niebezpiecznego polecenia
• /deny [reason] — odrzucenie oczekującego niebezpiecznego polecenia. Od wersji v0.19.0 polecenie /deny <reason> przekazuje agentowi powód odmowy, aby mógł skorygować sposób działania, zamiast ponawiać próbę bez znajomości przyczyny²³
• /update — zaktualizowanie Hermes Agent do najnowszej wersji
• /commands [page] — przeglądanie wszystkich poleceń i skills (z podziałem na strony)

Niektóre polecenia są natomiast dostępne wyłącznie w CLI: /skin, /tools, /toolsets, /browser, /config, /cron, /skills, /platforms, /paste, /statusbar, /plugins.⁹

Narzędzia i toolsets

Hermes jest wyposażony w rozbudowany, wbudowany rejestr narzędzi obejmujący wyszukiwanie w internecie, automatyzację przeglądarki, wykonywanie poleceń w terminalu, edycję plików, pamięć, delegowanie zadań, trenowanie RL, dostarczanie wiadomości, integrację z Home Assistant i inne funkcje.¹⁰ Narzędzia są zorganizowane w logiczne toolsets, które można włączać lub wyłączać osobno dla każdej platformy.

Kategorie wysokiego poziomu

Do często używanych nazw toolsets należą web, terminal, file, browser, vision, image_gen, moa, skills, tts, todo, memory, session_search, cronjob, code_execution, delegation, clarify, homeassistant oraz rl.¹⁰

Zarządzanie narzędziami

hermes chat --toolsets "web,terminal"       # Use specific toolsets
hermes tools                                # Interactive per-platform tool config
hermes tools --summary                      # Print enabled-tools summary

Narzędzia można również przełączać w trakcie sesji za pomocą /tools disable <name> oraz /tools enable <name>. Powoduje to zresetowanie sesji, aby nowy zestaw narzędzi zaczął obowiązywać.⁹

Backendy terminala

Narzędzie terminala może wykonywać polecenia w 6 różnych środowiskach:¹⁰

Backendy można przełączać poleceniem hermes config set terminal.backend <name> lub w pliku config.yaml:

terminal:
  backend: docker      # or: local, ssh, singularity, modal, daytona
  cwd: "."             # Working directory
  timeout: 180         # Command timeout in seconds

Backend SSH (zalecany ze względów bezpieczeństwa — agent nie może modyfikować własnego kodu):¹⁰

terminal:
  backend: ssh

# In ~/.hermes/.env
TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa

Backend Docker:

terminal:
  backend: docker
  docker_image: python:3.11-slim

Zasoby kontenera (dotyczy docker, singularity, modal i daytona):¹⁰

terminal:
  container_cpu: 1
  container_memory: 5120          # MB (default 5GB)
  container_disk: 51200           # MB (default 50GB)
  container_persistent: true      # Persist filesystem across sessions

Przy ustawieniu container_persistent: true zainstalowane pakiety, pliki i konfiguracja są zachowywane między sesjami.¹⁰

Wszystkie backendy kontenerowe działają z dodatkowymi zabezpieczeniami: systemem plików katalogu głównego tylko do odczytu (Docker), odebranymi wszystkimi funkcjami Linux z wyjątkiem DAC_OVERRIDE, CHOWN i FOWNER, zablokowaną eskalacją uprawnień, limitami PID (256 procesów), pełną izolacją przestrzeni nazw oraz trwałym obszarem roboczym opartym na woluminach.¹⁰

Procesy działające w tle

Narzędzie terminala obsługuje wykonywanie zadań w tle z jawnym zarządzaniem procesami:¹⁰

terminal(command="pytest -v tests/", background=true)
# Returns: {"session_id": "proc_abc123", "pid": 12345}

process(action="list")                            # Show all running processes
process(action="poll", session_id="proc_abc123")  # Check status
process(action="wait", session_id="proc_abc123")  # Block until done
process(action="log", session_id="proc_abc123")   # Full output
process(action="kill", session_id="proc_abc123")  # Terminate
process(action="write", session_id="proc_abc123", data="y")  # Send input

Tryb PTY (pty=true) umożliwia korzystanie z interaktywnych narzędzi CLI, takich jak Codex i Claude Code.¹⁰

Sudo

Jeśli polecenie wymaga sudo, Hermes poprosi o podanie hasła, które zostanie zapisane w pamięci podręcznej na czas sesji. Można również ustawić zmienną SUDO_PASSWORD w pliku ~/.hermes/.env.¹⁰

Wieloagentowa tablica Kanban (v0.13.0+)

W wersji v0.13.0 współpraca wielu agentów staje się mechanizmem pierwszej klasy: trwałą tablicą Kanban, która śledzi zadania, ich status oraz tożsamość wykonawców między agentami i po ponownych uruchomieniach.¹⁸ To właśnie dzięki tablicy rój wykonawców Hermes rzeczywiście kończy pracę, zamiast zatrzymywać się wskutek nieudanych przekazań zadań.

Tablica Kanban naturalnie współpracuje z /goal (pętlą Ralph z zablokowanym celem) po stronie celu oraz z istniejącym narzędziem delegate_task w zakresie tworzenia wykonawców. Powstaje w ten sposób wzorzec roju, w którym każdy agent korzysta z jednego źródła prawdy określającego, co należy zrobić dalej, kto nad tym pracuje i gdzie wystąpiła blokada.

System skills

Skills to dokumenty wiedzy ładowane na żądanie, z których agent może korzystać w razie potrzeby. Działają zgodnie z modelem stopniowego ujawniania informacji, aby ograniczyć zużycie tokenów, i są zgodne z otwartym standardem agentskills.io.¹¹

Wszystkie skills znajdują się w ~/.hermes/skills/ — jest to główny katalog i źródło prawdy. Przy nowej instalacji do tego katalogu kopiowane są skills dołączone do repozytorium. Trafiają tam również skills zainstalowane z hubu oraz utworzone przez agenta.¹¹

Stopniowe ujawnianie informacji

Level 0: skills_list()           → [{name, description, category}, ...]   (~3k tokens)
Level 1: skill_view(name)        → Full content + metadata                 (varies)
Level 2: skill_view(name, path)  → Specific reference file                 (varies)

Agent ładuje pełną treść skill tylko wtedy, gdy rzeczywiście jej potrzebuje.¹¹

Format SKILL.md

---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
platforms: [macos, linux]      # Optional — restrict to OS platforms
metadata:
  hermes:
    tags: [python, automation]
    category: devops
    fallback_for_toolsets: [web]     # Conditional activation
    requires_toolsets: [terminal]    # Conditional activation
    config:                          # Config.yaml settings
      - key: my.setting
        description: "What this controls"
        default: "value"
        prompt: "Prompt for setup"
---

# Skill Title

## When to Use
Trigger conditions for this skill.

## Procedure
1. Step one
2. Step two

## Pitfalls
- Known failure modes and fixes

## Verification
How to confirm it worked.

Aktywacja warunkowa

Skills mogą być wyświetlane lub ukrywane zależnie od dostępności określonych narzędzi. Jest to szczególnie przydatne w przypadku skills zapasowych — bezpłatnych lub lokalnych alternatyw, które powinny pojawiać się tylko wtedy, gdy narzędzie premium jest niedostępne:¹¹

Przykład: wbudowana skill duckduckgo-search używa ustawienia fallback_for_toolsets: [web]. Gdy ustawiono FIRECRAWL_API_KEY, toolset web jest dostępny i agent korzysta z web_search, a skill DuckDuckGo pozostaje ukryta. Bez klucza API skill DuckDuckGo automatycznie pojawia się jako rozwiązanie zapasowe.¹¹

Skills zarządzane przez agenta

Agent może tworzyć, aktualizować i usuwać własne skills za pomocą narzędzia skill_manage. Stanowią one pamięć proceduralną agenta — gdy opracuje on nietrywialny przepływ pracy, zapisuje tę metodę jako skill do ponownego wykorzystania w przyszłości.¹¹

Kiedy agent tworzy skills:¹¹ - Po pomyślnym wykonaniu złożonego zadania (co najmniej 5 wywołań narzędzi) - Gdy napotkał błędy lub ślepe zaułki i znalazł skuteczne rozwiązanie - Gdy użytkownik skorygował jego podejście - Gdy odkrył nietrywialny przepływ pracy

Działania:¹¹

Hub skills

Przeglądanie, wyszukiwanie, instalowanie i zarządzanie skills z rejestrów internetowych:⁶¹¹

hermes skills browse                          # Browse all hub skills
hermes skills browse --source official        # Browse official optional skills
hermes skills search kubernetes               # Search all sources
hermes skills search react --source skills-sh # Search skills.sh directory
hermes skills inspect openai/skills/k8s       # Preview before installing
hermes skills install openai/skills/k8s       # Install with security scan
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills check                           # Check for upstream updates
hermes skills update                          # Reinstall changed hub skills
hermes skills audit                           # Re-scan installed hub skills
hermes skills uninstall k8s
hermes skills publish skills/my-skill --to github --repo owner/repo
hermes skills tap add myorg/skills-repo       # Add custom GitHub source

Zintegrowane źródła hubu:¹¹

Domyślne źródła GitHub (można je przeglądać bez konfiguracji): openai/skills, anthropics/skills, VoltAgent/awesome-agent-skills, garrytan/gstack.¹¹

Skanowanie zabezpieczeń

Wszystkie skills instalowane z hubu przechodzą skanowanie zabezpieczeń pod kątem eksfiltracji danych, prompt injection, destrukcyjnych poleceń, sygnałów zagrożeń w łańcuchu dostaw oraz innych niebezpieczeństw.¹¹

Poziomy zaufania:¹¹

Opcja --force może zastąpić blokady wynikające z zasad dla skills społecznościowych, o ile nie dotyczą one zagrożeń sklasyfikowanych jako niebezpieczne. Nie zastępuje ona werdyktu skanowania dangerous.¹¹

Zewnętrzne katalogi skills

Można wskazać Hermes dodatkowe katalogi skills, które będą skanowane razem z katalogiem lokalnym:¹¹

skills:
  external_dirs:
    - ~/.agents/skills
    - /home/shared/team-skills
    - ${SKILLS_REPO}/skills

Ścieżki obsługują rozwijanie ~ oraz podstawianie zmiennych środowiskowych ${VAR}. Katalogi zewnętrzne są tylko do odczytu — gdy agent tworzy lub edytuje skill, zawsze zapisuje ją w ~/.hermes/skills/. Jeśli skill o tej samej nazwie istnieje w obu lokalizacjach, pierwszeństwo ma wersja lokalna.¹¹

Pamięć trwała

Hermes ma ograniczoną, starannie selekcjonowaną pamięć, która jest zachowywana między sesjami. Pamięć agenta składa się z dwóch plików przechowywanych w ~/.hermes/memories/:¹²

Oba są wstawiane do promptu systemowego jako zamrożony obraz stanu z początku sesji. Agent zarządza własną pamięcią za pomocą narzędzia memory — add, replace lub remove.¹²

Wzorzec zamrożonego obrazu stanu: zawartość wstawiana do promptu systemowego jest rejestrowana tylko raz, na początku sesji, i nie zmienia się w jej trakcie. Jest to celowe — pozwala zachować pamięć podręczną prefiksu LLM, co zwiększa wydajność. Zmiany wprowadzone podczas sesji są natychmiast zapisywane na dysku, lecz pojawiają się w prompcie systemowym dopiero w następnej sesji.¹²

Co zapisywać

Należy zapisywać (agent robi to proaktywnie):¹² - Preferencje użytkownika: „Wolę TypeScript od JavaScript” → user - Informacje o środowisku: „Ten serwer działa na Debianie 12 z PostgreSQL 16” → memory - Korekty: „Nie używać sudo w poleceniach Docker, użytkownik należy do grupy docker” → memory - Konwencje: „Projekt używa tabulatorów, limitu 120 znaków w wierszu i docstringów w stylu Google” → memory - Ukończone prace: „Przeprowadzono migrację bazy danych z MySQL do PostgreSQL 2026-01-15” → memory

Należy pomijać:¹² - Błahe lub oczywiste informacje - Fakty, które można łatwo ustalić ponownie - Surowe zrzuty danych (są zbyt obszerne dla pamięci) - Tymczasowe informacje dotyczące konkretnej sesji - Informacje znajdujące się już w plikach kontekstowych

Przeszukiwanie sesji

Oprócz MEMORY.md i USER.md agent może przeszukiwać wcześniejsze rozmowy za pomocą narzędzia session_search. Wszystkie sesje CLI i komunikatorów są przechowywane w SQLite (~/.hermes/state.db) z pełnotekstowym wyszukiwaniem FTS5. Zapytania zwracają odpowiednie wcześniejsze rozmowy podsumowane przez Gemini Flash.¹²

Zewnętrzni dostawcy pamięci

Do obsługi bardziej rozbudowanej pamięci trwałej, wykraczającej poza MEMORY.md i USER.md, Hermes zawiera osiem wtyczek zewnętrznych dostawców pamięci: Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover i Supermemory.¹²

Zewnętrzni dostawcy działają równolegle z wbudowaną pamięcią (nigdy jej nie zastępują) i zapewniają między innymi grafy wiedzy, wyszukiwanie semantyczne, automatyczne wyodrębnianie faktów oraz modelowanie użytkownika między sesjami:⁶¹²

hermes memory setup         # Pick a provider and configure it
hermes memory status        # Check what's active
hermes memory off           # Disable external provider (built-in only)

Jednocześnie może być aktywny tylko jeden zewnętrzny dostawca. Wbudowana pamięć jest zawsze aktywna.⁶

Automatyczne wznawianie sesji (v0.13.0+)

W wersji v0.13.0 przerwanie pracy agenta nie powoduje już utraty sesji. Po ponownym uruchomieniu gateway automatycznie wznawia przerwane sesje; ponowne uruchomienia wykonywane przez /update zachowują stan sesji podczas aktualizacji; przeładowanie plików źródłowych w czasie programowania utrzymuje aktywną sesję zamiast wymuszać utworzenie nowej.¹⁸ W praktyce oznacza to, że długotrwałe zadania wykonywane przez gateway oraz zadania uruchamiane przez cron nie tracą już okna kontekstu po ponownym uruchomieniu procesu.

Checkpointy v2 (v0.13.0+)

W wersji v0.13.0 mechanizm utrwalania stanu został przepisany jako rozwiązanie oparte na jednym magazynie, z rzeczywistym usuwaniem zbędnych danych, zabezpieczeniami przestrzeni dyskowej i bez osieroconych repozytoriów pomocniczych.¹⁸ Poprzedni system checkpointów gromadził stan na dysku w długo działających profilach; magazyn v2 nakłada ścisły limit na lokalną przestrzeń zajmowaną przez checkpointy i usuwa powieloną ewidencję, która powodowała jej rozrost. Nie jest wymagana żadna zmiana konfiguracji po stronie użytkownika; kolejny zapis checkpointu użyje ścieżki v2.

Osobowość i SOUL.md

SOUL.md określa podstawową tożsamość instancji Hermes. Zajmuje pozycję nr 1 w prompcie systemowym, zastępując domyślną tożsamość zapisaną na stałe w kodzie.¹³

Hermes automatycznie tworzy domyślny plik SOUL.md w ~/.hermes/SOUL.md (lub $HERMES_HOME/SOUL.md w przypadku niestandardowych profili). Istniejące pliki użytkownika nigdy nie są nadpisywane. Hermes wczytuje SOUL.md wyłącznie z HERMES_HOME — nie szuka go w bieżącym katalogu roboczym. Dzięki temu osobowość pozostaje przewidywalna we wszystkich projektach.¹³

Co powinno znaleźć się w SOUL.md

Plik ten służy do definiowania trwałych wytycznych dotyczących sposobu wypowiadania się i osobowości:¹³ - ton - styl komunikacji - poziom bezpośredniości - domyślny styl interakcji - elementy stylistyczne, których należy unikać - sposób, w jaki Hermes powinien radzić sobie z niepewnością, różnicą zdań i niejednoznacznością

W mniejszym stopniu należy używać go do:¹³ - jednorazowych instrukcji projektowych - ścieżek plików - konwencji repozytorium - tymczasowych szczegółów przepływu pracy

Ich miejsce jest w AGENTS.md, a nie w SOUL.md.

SOUL.md a AGENTS.md

To najważniejsze rozróżnienie w zarządzaniu tożsamością Hermes:¹³

SOUL.md — tożsamość, ton, styl, domyślne zasady komunikacji i zachowanie wynikające z osobowości.

AGENTS.md — architektura projektu, konwencje programistyczne, preferencje dotyczące narzędzi, przepływy pracy właściwe dla repozytorium, polecenia, porty, ścieżki i uwagi dotyczące wdrażania.

Przydatna zasada: jeśli coś powinno towarzyszyć użytkownikowi wszędzie, należy umieścić to w SOUL.md. Jeśli dotyczy konkretnego projektu, należy umieścić to w AGENTS.md.¹³

Wbudowane osobowości

Hermes zawiera wbudowane osobowości, między którymi można się przełączać za pomocą /personality:¹³

Niestandardowe osobowości w config.yaml:¹³

agent:
  personalities:
    codereviewer: >
      You are a meticulous code reviewer. Identify bugs, security issues,
      performance concerns, and unclear design choices. Be precise and constructive.

Następnie można się przełączyć za pomocą /personality codereviewer.

SOUL.md a /personality

SOUL.md określa bazowy sposób wypowiadania się. /personality stanowi nakładkę obowiązującą na poziomie sesji.¹³ Warto zachować pragmatyczny, domyślny plik SOUL.md, a następnie używać /personality teacher podczas nauki lub /personality creative podczas burzy mózgów.

Nous Tool Gateway (v0.10.0+)

Od wersji Hermes Agent v0.10.0 (2026-04-16) płatni subskrybenci Nous Portal uzyskują zarządzany dostęp do starannie dobranego zestawu narzędzi za pośrednictwem dotychczasowych danych uwierzytelniających Portal — bez konieczności zarządzania dodatkowymi kluczami API.²⁸ Sam CLI Hermes pozostaje objęty licencją MIT i w pełni otwartoźródłowy. Zmiana polega na tym, że uwierzytelnianie w Portal odblokowuje teraz nie tylko wnioskowanie modeli.

Co zawiera gateway

Jak to działa

Gateway jest włączany osobno dla każdego narzędzia za pomocą nowego pola konfiguracyjnego use_gateway. Jeśli dane uwierzytelniające Portal są zapisane w hermes auth, a gateway został włączony dla danego narzędzia, jego wywołania są kierowane przez Portal. W przeciwnym razie używany jest bezpośredni klucz API (jeśli go podano).

# config.yaml — per-tool gateway opt-in
tools:
  web_search:
    provider: firecrawl
    use_gateway: true          # route via Nous Portal subscription
  image_generation:
    provider: fal
    use_gateway: true

Kolejność pierwszeństwa podczas działania: gdy gateway jest dostępny, a dla narzędzia ustawiono use_gateway: true, Hermes wybiera gateway nawet wtedy, gdy skonfigurowano również bezpośredni klucz API. Ma to znaczenie dla rozliczeń — wywołania przez gateway są pokrywane z subskrypcji Portal, a nie z salda bezpośredniego klucza API.

Włączanie gatewaya

hermes model                      # select Nous Portal (OAuth flow)
hermes tools                      # per-platform tool picker integrates gateway tools
hermes status                     # confirms gateway/subscription detection

Subskrypcja jest wykrywana automatycznie na podstawie danych uwierzytelniających OAuth Portal zapisanych już w hermes auth — osobne logowanie nie jest wymagane. Od wersji v0.19.0 samą subskrypcją można również zarządzać z poziomu sesji: /subscription wyświetla plan i pozostały limit, dokładnie informuje o koszcie przejścia na wyższy plan lub terminie wejścia w życie przejścia na niższy plan oraz wprowadza zmianę wraz z banerami dotyczącymi zaplanowanej zmiany i możliwością jej cofnięcia; /topup dodaje środki. Aplikacja komputerowa zawiera odpowiadającą tym funkcjom kartę ustawień rozliczeń.²³

Ceny i dostęp

Ceny oraz nazwy poziomów są publikowane na stronie cennika Nous Portal (https://portal.nousresearch.com/pricing). W tym przewodniku nie wymieniono poziomów, ponieważ należą one do produktu Portal, a nie do CLI Hermes, i zmieniają się niezależnie od wydań Hermes. Rejestracja jest dostępna pod adresem https://portal.nousresearch.com/; aktualne poziomy można sprawdzić na stronie cennika.

Informacja o wycofaniu

• Zmienna środowiskowa HERMES_ENABLE_NOUS_MANAGED_TOOLS została usunięta w wersji v0.10.0. Zarządzane narzędzia włącza się teraz osobno za pomocą pola konfiguracyjnego use_gateway, a ich dostępność zależy od stanu subskrypcji Portal.²⁸

Kontekst: czym to wydanie nie jest

CLI Hermes Agent nie wymaga subskrypcji. Projekt nadal jest objęty licencją MIT, a wszystkie podstawowe funkcje (CLI, skills, pamięć, gateway komunikacyjny, cron, MCP, lokalny panel, BYOK dla każdego dostawcy) działają kompleksowo bez żadnych opłat. Wersja v0.10.0 dodaje wygodną ścieżkę dla użytkowników, którzy już opłacają Nous Portal — nie usuwa niczego z bezpłatnej ścieżki.

Messaging Gateway

Hermes może działać jako długotrwale uruchomiony proces gateway, który z poziomu jednego procesu łączy się z 22 platformami komunikacyjnymi: Telegram, Discord, Slack, WhatsApp, Signal, SMS, Email, Home Assistant, Mattermost, Matrix, DingTalk, Feishu/Lark, WeCom, Weixin (WeChat), BlueBubbles (iMessage), QQBot, Microsoft Teams, Tencent Yuanbao, Google Chat, LINE, SimpleX Chat oraz ogólnym adapterem Webhook.^327171819 Wersja v0.9.0 dodała obsługę iMessage za pośrednictwem BlueBubbles (automatyczną rejestrację webhooka, kreator konfiguracji i odporność na awarie) oraz natywną obsługę WeChat przez iLink Bot API, z trybem wywołań zwrotnych WeCom dla aplikacji firmowych.¹⁶ W wersji v0.11.0 dodano QQBot.²⁷ Wersja v0.12.0 wprowadziła Microsoft Teams i Tencent Yuanbao.¹⁷ Wersja v0.13.0 dodała Google Chat jako 20. platformę, wykorzystując tę samą rozszerzalną architekturę adapterów; IRC i Microsoft Teams również przeniesiono do nowego wzorca adapterów z ogólnymi hookami wtyczek env_enablement_fn / cron_deliver_env_var.¹⁸ Wersja v0.14.0 dodaje LINE i SimpleX Chat oraz uzupełnia cały stos Microsoft Teams o uwierzytelnianie Graph, odbiornik webhooków, środowisko wykonawcze pipeline’u i dostarczanie wiadomości wychodzących.¹⁹ Wersja v0.17.0 (19 czerwca 2026) dodaje iMessage bez pośredniego serwera dzięki Photon Spectrum (uwierzytelnianie OAuth za pomocą kodu urządzenia i polecenia hermes photon login — bez konieczności używania Maca ani serwera pośredniego BlueBubbles), oficjalny adapter WhatsApp Business Cloud API (zastępujący wymóg korzystania z procesu mostu), grupy SimpleX i natywne załączniki oraz Raft jako dołączoną wtyczkę platformy.²¹

Konfiguracja

hermes gateway setup                # Interactive platform configuration
hermes gateway install              # Install as user service (systemd/launchd)
hermes gateway start                # Start the installed service
hermes gateway stop
hermes gateway restart
hermes gateway status
hermes gateway run                  # Run in foreground (debugging)

Interaktywna konfiguracja prowadzi przez proces podłączania każdej platformy: tokeny API, identyfikatory botów, mapowania kanałów i listy dozwolonych użytkowników.⁶

Przepływ wiadomości

Zgodnie z dokumentacją architektury projektu źródłowego:³

Platform event → Adapter.on_message() → MessageEvent
  → GatewayRunner._handle_message()
    → authorize user
    → resolve session key
    → create AIAgent with session history
    → AIAgent.run_conversation()
    → deliver response back through adapter

Każda platforma komunikacyjna korzysta z tej samej pętli konwersacji AIAgent co CLI. Dlatego polecenia z ukośnikiem działają identycznie w obu miejscach, a zadanie cron zaplanowane w Telegram może dostarczyć wynik do Discord — różnica między platformami występuje wyłącznie na obrzeżu systemu.³

Wersja v0.19.0 dodaje routing wiadomości oparty na profilach oraz trwałe dostarczanie. Pojedynczy multipleksowany gateway korzystający z jednego tokenu bota może kierować określone serwery, kanały lub wątki do różnych profili — każdy z całkowicie odizolowaną konfiguracją, skills, pamięcią i sekretami — z możliwością nadpisania przez GATEWAY_MULTIPLEX_PROFILES. Dzięki wzmocnieniu odporności jeden nieprawidłowo skonfigurowany profil nie może już zatrzymać całego gatewaya. W warstwie wewnętrznej indeks routingu przeniesiono do state.db (sessions.json jest teraz opcjonalną starszą kopią), a końcowe odpowiedzi są zapisywane w trwałym rejestrze zobowiązań dostarczenia obejmującym operację wysyłania na platformę — jeśli gotowa odpowiedź nie zostanie dostarczona z powodu awarii gatewaya, po kolejnym uruchomieniu nastąpi ponowna próba zamiast jej bezpowrotnej utraty.²³

Autoryzacja i parowanie użytkowników

hermes pairing list                    # Show pending and approved users
hermes pairing approve <platform> <code>
hermes pairing revoke <platform> <user-id>
hermes pairing clear-pending

Kody parowania uniemożliwiają przypadkowym osobom korzystanie z gatewaya. Użytkownik wysyła kod parowania ze swojej platformy komunikacyjnej; następnie należy go zatwierdzić poleceniem hermes pairing approve. Od tego momentu użytkownik jest autoryzowany.⁶

Zaplanowane zadania (Cron)

Hermes ma wbudowany system cron, w którym zadania są zadaniami agenta, a nie poleceniami powłoki. Każde zaplanowane zadanie jest wykonywane przez nową instancję AIAgent ze skonfigurowanym promptem i opcjonalnie dołączonymi skills, a wyniki mogą zostać dostarczone na dowolną platformę:³⁶

hermes cron list
hermes cron create --prompt "Check HN for AI news and summarize" --schedule "0 9 * * *" --deliver telegram
hermes cron edit <id>
hermes cron pause <id>
hermes cron resume <id>
hermes cron run <id>         # Trigger now on the next tick
hermes cron remove <id>
hermes cron status           # Check if scheduler is running
hermes cron tick             # Run due jobs once and exit

Zadanie można również utworzyć konwersacyjnie na czacie platformy komunikacyjnej:

Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.

Agent skonfiguruje zadanie cron za pomocą swoich narzędzi. Zadania są trwale zapisywane w JSON i pozostają dostępne po ponownym uruchomieniu.³

Integracja z MCP

Hermes obsługuje Model Context Protocol zarówno jako klient, jak i serwer:⁶

Jako klient — umożliwia połączenie Hermes z zewnętrznymi serwerami MCP w celu rozszerzenia zestawu jego narzędzi:

hermes mcp add <name> --url https://example.com/mcp
hermes mcp add <name> --command npx --args "-y,@modelcontextprotocol/server-github"
hermes mcp list
hermes mcp test <name>
hermes mcp remove <name>
hermes mcp configure <name>   # Toggle individual tool selection

Można też skonfigurować je ręcznie w config.yaml:¹⁴

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Od wersji v0.19.0 narzędzia MCP są udostępniane modelowi zgodnie z konwencją nazewnictwa mcp__server__tool — każda nazwa narzędzia zawiera nazwę jego serwera, dzięki czemu narzędzia o tej samej nazwie udostępniane przez dwa serwery nie powodują już konfliktu — a powiadomienia z dzienników serwera MCP są zapisywane w agent.log.²³

Jako serwer — umożliwia udostępnianie konwersacji Hermes innym agentom:

hermes mcp serve
hermes mcp serve -v    # Verbose

Kompresja kontekstu

Hermes automatycznie kompresuje długie konwersacje, aby mieściły się w oknie kontekstowym modelu. Moduł podsumowujący kompresję wykonuje osobne wywołanie LLM — można skierować je do dowolnego dostawcy lub punktu końcowego.⁴

compression:
  enabled: true
  threshold: 0.50                           # Compress at this % of context limit
  target_ratio: 0.20                        # Fraction to preserve as recent tail
  protect_last_n: 20                        # Min recent messages to keep uncompressed
  summary_model: "google/gemini-3-flash-preview"
  summary_provider: "auto"                  # "auto", "openrouter", "nous", "codex", "main", etc.
  summary_base_url: null                    # Custom OpenAI-compatible endpoint

Opcje dostawcy:⁴

summary_model musi obsługiwać kontekst co najmniej tak długi jak model główny, ponieważ otrzymuje do kompresji całą środkową część konwersacji.⁴

Ostrzeżenia o wyczerpywaniu budżetu

Podczas wykonywania złożonego zadania wymagającego wielu wywołań narzędzi agent może wyczerpać budżet iteracji (domyślnie: 90 tur), nie zdając sobie z tego sprawy. Funkcja monitorowania budżetu automatycznie ostrzega model:⁴

Limity czasu strumienia

Połączenie strumieniowe LLM ma dwie warstwy limitów czasu, które automatycznie dostosowują się do lokalnych dostawców (localhost, adresy IP w sieci LAN):⁴

Limit czasu odczytu z gniazda jest zwiększany do 30 minut w przypadku lokalnych punktów końcowych, ponieważ przy dużych kontekstach lokalne LLM mogą potrzebować kilku minut na wstępne przetwarzanie, zanim wygenerują pierwszy token.⁴

Lokalny panel internetowy (v0.9.0+)

Panel działający w przeglądarce, który służy do lokalnego zarządzania Hermes Agent. Umożliwia konfigurowanie ustawień, monitorowanie sesji, przeglądanie skills oraz zarządzanie gateway bez modyfikowania plików konfiguracyjnych ani korzystania z terminala.¹⁶ Uruchamia się go poleceniem hermes dashboard. To najłatwiejszy sposób rozpoczęcia pracy dla nowych użytkowników preferujących interfejs graficzny.

Monitorowanie procesów w tle (v0.9.0+)

watch_patterns umożliwia określenie wzorców monitorowanych w danych wyjściowych procesów działających w tle oraz otrzymywanie powiadomień w czasie rzeczywistym po ich dopasowaniu.¹⁶ Można wykrywać błędy, oczekiwać na określone zdarzenia („listening on port”) lub śledzić logi kompilacji — bez odpytywania. W połączeniu z notify_on_complete z wersji v0.8.0 (funkcją powiadamiającą o ukończeniu zadania w tle) Hermes oferuje teraz kompletną warstwę obserwowalności procesów działających w tle.¹⁵

Wymienny context engine (v0.9.0+)

Zarządzanie kontekstem jest teraz wymiennym modułem dostępnym za pośrednictwem hermes plugins. Można podłączać niestandardowe context engines, które kontrolują informacje widoczne dla agenta w każdej turze — przez filtrowanie, podsumowywanie lub wstrzykiwanie kontekstu właściwego dla danej dziedziny.¹⁶ Oddziela to strategię zarządzania kontekstem od głównej pętli agenta, umożliwiając dostosowanie kontekstu do konkretnego projektu lub dziedziny.

Kopie zapasowe i przywracanie (v0.9.0+)

hermes backup tworzy pełne archiwum konfiguracji, sesji, skills i pamięci. hermes import przywraca dane z archiwum kopii zapasowej.¹⁶ Funkcje te służą do migracji między urządzeniami, tworzenia migawek przed istotnymi zmianami oraz udostępniania członkom zespołu sprawdzonej konfiguracji.

Obsługa Termux i systemu Android (v0.9.0+)

Hermes działa natywnie na urządzeniach z systemem Android za pośrednictwem Termux. Dostosowane ścieżki instalacji, optymalizacje TUI dla ekranów urządzeń mobilnych, obsługa backendu głosowego oraz polecenie /image działają bezpośrednio na urządzeniu.¹⁶

Wzmocnienie zabezpieczeń (v0.13.0+)

W wersji v0.13.0 usunięto 8 problemów bezpieczeństwa klasy P0 i zmieniono jedno ustawienie domyślne na korzystniejsze dla użytkownika.¹⁸ Wersja v0.14.0 usuwa kolejne 12 problemów klasy P0 i 50 problemów klasy P1, w tym wzmacnia ochronę przed atakami brute force na sudo i nadużywaniem sudo-stdin, eliminuje sposoby obchodzenia zabezpieczeń przed niebezpiecznymi poleceniami, oczyszcza błędy narzędzi przed ich ponownym wstrzyknięciem do modelu, dodaje uwierzytelnianie API wtyczek panelu, rozszerza ochronę skills-hub przed SSRF oraz wprowadza skanowanie ostrzeżeń dotyczących łańcucha dostaw podczas instalacji.¹⁹

W przypadku utrzymywania wdrożenia Hermes wersje v0.13.0 i v0.14.0 należy traktować jako aktualizacje istotne dla bezpieczeństwa, a nie wyłącznie wydania nowych funkcji. Wersja v0.13.0 usuwa lukę umożliwiającą obejście ograniczeń między serwerami Discord oraz dwa okna TOCTOU; v0.14.0 wprowadza kolejną serię wzmocnień w zakresie obsługi sudo, ponownego wstrzykiwania błędów narzędzi, API wtyczek, ochrony skills-hub przed SSRF oraz ostrzeżeń dotyczących zależności.

Architektura dla praktyków

Ta sekcja jest przeznaczona dla osób, które chcą zrozumieć mechanizmy działania systemu, aby móc go debugować, rozszerzać lub analizować jego wydajność. Stanowi syntezę dokumentacji architektury projektu źródłowego.³

Punkty wejścia → AIAgent

Każdy punkt wejścia w Hermes ostatecznie wywołuje AIAgent.run_conversation():

┌──────────────────────────────────────────────────────────────────┐
│                        Entry Points                              │
│                                                                  │
│  CLI (cli.py)    Gateway (gateway/run.py)    ACP (acp_adapter/)  │
│  Batch Runner    API Server                  Python Library     │
└──────────┬──────────────┬───────────────────────┬────────────────┘
           │              │                       │
           ▼              ▼                       ▼
┌──────────────────────────────────────────────────────────────────┐
│                     AIAgent (run_agent.py)                       │
│                                                                  │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────┐             │
│  │ Prompt      │  │ Provider     │  │ Tool         │             │
│  │ Builder     │  │ Resolution   │  │ Dispatch     │             │
│  └──────┬──────┘  └──────┬───────┘  └──────┬───────┘             │
│         │                │                 │                    │
│  ┌──────┴───────┐ ┌──────┴───────┐  ┌──────┴───────┐             │
│  │ Compression  │ │ 3 API Modes  │  │ Tool Registry│             │
│  │ & Caching    │ │ chat_compl   │  │ 47 tools     │             │
│  │              │ │ codex_resp   │  │ 20 toolsets  │             │
│  │              │ │ anthropic    │  │              │             │
│  └──────────────┘ └──────────────┘  └──────────────┘             │
└──────────────────────────────────────────────────────────────────┘

Diagram opracowano na podstawie dokumentacji architektury projektu źródłowego.³

„47 narzędzi / 20 toolsets” a „28 narzędzi” w banerze. Liczba „47 narzędzi” oznacza łączną liczbę narzędzi w rejestrze repozytorium źródłowego — obejmuje każde narzędzie, którego kod źródłowy jest dostarczany z Hermes, we wszystkich toolsets. Rzeczywiście uruchomiony CLI wyświetli w banerze startowym mniejszą liczbę (instalacja, na której zweryfikowano ten przewodnik, zgłasza 28 tools / 89 skills). Nie jest to błąd. Wiele toolsets jest opcjonalnych i wymaga jawnego włączenia w config.yaml w sekcji toolsets: — dotyczy to m.in. adapterów platform komunikacyjnych, automatyzacji przeglądarki oraz bardziej zaawansowanych narzędzi do pozyskiwania danych. Łączna liczba w rejestrze oznacza „to, co jest dostępne”, natomiast liczba w banerze — „to, co jest włączone w bieżącym profile”. Aktywne toolsets można sprawdzić za pomocą hermes tools --list, a poszczególne toolsets włączać lub wyłączać w bloku toolsets: w pliku ~/.hermes/config.yaml (albo za pomocą /tools list, /tools enable <name> i /tools disable <name> w uruchomionej sesji — usunięcie narzędzia powoduje zresetowanie sesji, aby agent mógł ponownie utworzyć swój manifest narzędzi).

Trzy tryby API

Hermes ujmuje różnice między dostawcami w postaci trzech trybów API, wybieranych automatycznie podczas działania:³

Mechanizm rozpoznawania w runtime_provider.py mapuje krotki (provider, model) na (api_mode, api_key, base_url) dla ponad 18 dostawców, obsługując przepływy OAuth, pule danych uwierzytelniających oraz rozpoznawanie aliasów.³

Przepływ danych w sesji CLI

User input → HermesCLI.process_input()
  → AIAgent.run_conversation()
    → prompt_builder.build_system_prompt()
    → runtime_provider.resolve_runtime_provider()
    → API call (chat_completions / codex_responses / anthropic_messages)
    → tool_calls? → model_tools.handle_function_call() → loop
    → final response → display → save to SessionDB

Na podstawie strony poświęconej architekturze projektu źródłowego.³

Kolejność składania promptu

Stos promptu obejmuje:¹³

1. SOUL.md (tożsamość agenta — lub wbudowany wariant zastępczy, jeśli plik jest niedostępny)
2. Wskazówki dotyczące zachowania uwzględniającego dostępne narzędzia
3. Pamięć i kontekst użytkownika (MEMORY.md, USER.md)
4. Wskazówki dotyczące skills
5. Pliki kontekstowe (AGENTS.md, .cursorrules)
6. Znacznik czasu
7. Wskazówki dotyczące formatowania właściwe dla danej platformy
8. Opcjonalne nakładki na prompt systemowy, takie jak /personality

SOUL.md stanowi fundament — wszystkie pozostałe elementy są na nim nadbudowywane.¹³

Przechowywanie sesji

Sesje są przechowywane w bazie SQLite z pełnotekstowym wyszukiwaniem FTS5. Obejmują śledzenie pochodzenia (relacje nadrzędne/podrzędne między kompresjami), izolację poszczególnych platform oraz niepodzielne operacje zapisu z obsługą konfliktów dostępu.³

System wtyczek

Dostępne są trzy źródła wykrywania: ~/.hermes/plugins/ (użytkownik), .hermes/plugins/ (projekt) oraz punkty wejścia pip. Wtyczki rejestrują narzędzia, haki i polecenia CLI za pośrednictwem kontekstowego API. Dostawcy pamięci stanowią wyspecjalizowany typ wtyczki w katalogu plugins/memory/.³

hermes plugins                       # Interactive enable/disable UI
hermes plugins install <repo>        # Install from Git URL or owner/repo
hermes plugins enable <name>
hermes plugins disable <name>
hermes plugins list

Zasady projektowe

Na podstawie strony poświęconej architekturze projektu źródłowego:³

Migracja z OpenClaw

Hermes Agent jest następcą OpenClaw. W przypadku migracji z istniejącej instalacji OpenClaw:⁶⁵

hermes claw migrate --dry-run                    # Preview what would be migrated
hermes claw migrate --preset full                # Full migration including API keys
hermes claw migrate --preset user-data --overwrite   # User data only, no secrets
hermes claw migrate --source /custom/path        # Non-default OpenClaw location

hermes claw migrate domyślnie odczytuje dane z ~/.openclaw (automatycznie wykrywa również starsze katalogi ~/.clawdbot i ~/.moldbot) oraz zapisuje je w ~/.hermes.⁶

Importowane bezpośrednio (ponad 30 kategorii): SOUL.md, MEMORY.md, USER.md, AGENTS.md, skills z 4 katalogów źródłowych, domyślny model, niestandardowi dostawcy, serwery MCP, tokeny i listy dozwolonych użytkowników platform komunikacyjnych (Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), ustawienia domyślne agenta (intensywność rozumowania, kompresja, opóźnienie imitujące człowieka, strefa czasowa, sandbox), zasady resetowania sesji, reguły zatwierdzania, konfiguracja TTS, ustawienia przeglądarki, ustawienia narzędzi, limit czasu wykonywania, lista dozwolonych poleceń, konfiguracja gateway oraz klucze API z 3 źródeł.⁶

Archiwizowane do ręcznego sprawdzenia: zadania cron, wtyczki, haki/webhooki, backend pamięci (QMD), konfiguracja rejestru skills, interfejs użytkownika/tożsamość, rejestrowanie zdarzeń, konfiguracja wielu agentów, powiązania kanałów, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md.⁶

Klucze API są wyszukiwane w trzech źródłach według następującej kolejności priorytetów: wartości konfiguracji → ~/.openclaw/.env → auth-profiles.json.⁶

Rozwiązywanie problemów

„No inference provider configured. Run ‘hermes model’ to choose a provider and model”

Pierwszy błąd, który pojawia się po każdej nowej instalacji: Hermes nie ma jeszcze skonfigurowanego aktywnego dostawcy. Komunikat oznacza dokładnie to, co mówi — żadna z 3 ścieżek uwierzytelniania nie zapewniła działającego dostawcy. Należy uruchomić:

hermes model

Interaktywny selektor przeprowadza przez konfigurację każdego obsługiwanego dostawcy, w tym procesy z kodem urządzenia OAuth (Nous Portal, GitHub Copilot, Anthropic, OpenAI Codex) oraz niestandardowe endpointy serwerów hostowanych samodzielnie. Jeśli dostawca powinien być już skonfigurowany, polecenie hermes doctor pokaże, które dane uwierzytelniające Hermes rzeczywiście wykrywa. Najczęstsze przyczyny to klucz API zapisany w niewłaściwym miejscu (powinien znajdować się w .env lub zostać ustawiony za pomocą hermes config set, a nie w profilu powłoki), wygasłe dane uwierzytelniające OAuth w ~/.hermes/auth.json albo niestandardowy endpoint w config.yaml, w którym brakuje wartości base_url. Ścieżki uwierzytelniania szczegółowo opisano w sekcji Uwierzytelnianie i dostawcy.²⁷

„Klucz API nie jest ustawiony”

Należy uruchomić hermes model, aby interaktywnie skonfigurować dostawcę, albo wykonać hermes config set OPENROUTER_API_KEY your_key. Polecenie hermes doctor wskaże dokładnie, których kluczy brakuje.⁷

„Context limit: 2048 tokens” podczas uruchamiania (modele lokalne)

Hermes automatycznie wykrywa długość kontekstu za pośrednictwem endpointu /v1/models serwera, ale wiele lokalnych serwerów zgłasza niskie wartości domyślne. Wartość tę należy ustawić jawnie w config.yaml:²

model:
  default: your-model
  provider: custom
  base_url: http://localhost:11434/v1
  context_length: 32768

Wywołania narzędzi są wyświetlane jako tekst zamiast wykonywane

Na serwerze nie włączono wywoływania narzędzi albo model nie obsługuje go za pośrednictwem implementacji danego serwera.²

Odpowiedzi urywają się w połowie zdania

Możliwe są 2 przyczyny:²

1. Niski limit odpowiedzi (max_tokens) na serwerze — domyślnie SGLang ogranicza odpowiedź do 128 tokenów. Należy ustawić --default-max-tokens na serwerze albo skonfigurować model.max_tokens w config.yaml.
2. Wyczerpanie kontekstu — model wypełnił całe okno kontekstu. Należy zwiększyć model.context_length albo włączyć kompresję kontekstu w Hermes.

„Connection refused” przy łączeniu się z WSL2 z serwerem modelu działającym w systemie Windows

WSL2 korzysta z wirtualnej karty sieciowej i własnej podsieci — localhost w WSL2 wskazuje maszynę wirtualną z systemem Linux, a nie hosta z systemem Windows. Dostępne są 2 rozwiązania:²

Sieć lustrzana (Windows 11 22H2 lub nowszy): należy edytować %USERPROFILE%\.wslconfig:

[wsl2]
networkingMode=mirrored

Następnie wykonać wsl --shutdown i uruchomić środowisko ponownie. localhost będzie teraz działać w obu kierunkach.

Awaryjne użycie adresu IP hosta (starsze wersje systemu Windows): należy pobrać adres IP hosta Windows z poziomu WSL2 i użyć go zamiast localhost:

ip route show | grep -i default | awk '{ print $3 }'
# Use that IP as the base_url host

Serwer modelu musi również nasłuchiwać na 0.0.0.0, a nie na 127.0.0.1 — w przypadku Ollama należy ustawić OLLAMA_HOST=0.0.0.0, w przypadku llama-server/SGLang dodać --host 0.0.0.0, a w LM Studio włączyć opcję „Serve on Network”.²

Gdzie znajdują się wszystkie pliki?

Pomocne będą tutaj polecenia hermes status i hermes dump. hermes logs list wyświetla wszystkie pliki dzienników wraz z ich rozmiarami. hermes config path wyświetla lokalizację pliku konfiguracyjnego. hermes config env-path wyświetla lokalizację pliku .env.⁶

Często zadawane pytania

Czym różni się Hermes Agent od Claude Code?

Claude Code to oficjalny CLI firmy Anthropic, ograniczony do modeli Anthropic. Hermes Agent to platforma agentowa typu open source opracowana przez Nous Research, która współpracuje z każdym dostawcą zgodnym z OpenAI — Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Hugging Face, Google lub własnym endpointem hostowanym samodzielnie.¹² Hermes oferuje również gateway komunikacyjny dla Telegram/Discord/Slack/WhatsApp/Signal, którego Claude Code nie ma.

Czy można używać Hermes z kluczem API firmy Anthropic?

Tak. Dostępne są 3 sposoby:²

1. Ustawić ANTHROPIC_API_KEY w ~/.hermes/.env i uruchomić hermes chat --provider anthropic --model claude-sonnet-4-6
2. Uruchomić hermes model i wybrać Anthropic — Hermes użyje magazynu danych uwierzytelniających Claude Code, jeśli będzie dostępny
3. Ustawić ręcznie ANTHROPIC_TOKEN (token konfiguracyjny lub token OAuth) jako rozwiązanie awaryjne

Opcja 2 jest zalecana, jeśli Claude Code jest już używany na tym samym komputerze — pozwala zachować możliwość odświeżania danych uwierzytelniających Claude.

Jak zmienić dostawcę bez utraty rozmowy?

W ramach sesji należy użyć /model provider:model. Historia rozmowy, pamięć i skills zostaną zachowane:⁹

/model zai:glm-5
/model openrouter:anthropic/claude-sonnet-4
/model custom:local:qwen-2.5

Skonfigurowano Anthropic, ale funkcje obrazu, sieci i kompresji nie działają

Przyczyną jest awaryjny model pomocniczy. Analiza obrazu, podsumowywanie treści internetowych, kompresja i inne zadania poboczne korzystają z osobnego pomocniczego LLM — domyślnie jest to Gemini Flash wybierany przez automatyczne wykrywanie (OpenRouter → Nous → Codex). Jeśli żaden z tych dostawców nie został skonfigurowany, a dostępny jest wyłącznie Anthropic, funkcje te ograniczają swoje działanie bez wyświetlania błędu.⁴

Rozwiązanie: dodać OPENROUTER_API_KEY na potrzeby zadań pomocniczych albo ponownie skonfigurować sloty pomocnicze tak, aby korzystały z głównego dostawcy. Warto pamiętać, że kompresja kontekstu znajduje się we własnym bloku najwyższego poziomu compression: i przyjmuje summary_provider, a nie auxiliary.compression.provider — slot auxiliary.compression udostępnia wyłącznie timeout. Pełne rozwiązanie:

auxiliary:
  vision:      { provider: "main" }
  web_extract: { provider: "main" }

compression:
  summary_provider: "main"

Czym różnią się SOUL.md i AGENTS.md?

SOUL.md definiuje tożsamość agenta — ton, styl i domyślne zasady komunikacji. Znajduje się w ~/.hermes/SOUL.md i obowiązuje wszędzie. AGENTS.md dotyczy konkretnego projektu — jego architektury, konwencji, poleceń i ścieżek — oraz znajduje się w katalogu projektu.¹³ Informacje, które powinny obowiązywać wszędzie, należy umieścić w SOUL.md. Informacje dotyczące konkretnego projektu powinny trafić do AGENTS.md.

Jak uruchomić obok siebie wiele instancji Hermes?

Należy użyć profiles. Każdy profile otrzymuje własne HERMES_HOME, konfigurację, pamięć, sesje oraz PID gateway:⁶

hermes profile create work --clone
hermes profile use work                 # Sticky default
hermes -p work chat -q "..."            # One-off without switching
hermes profile alias work --name h-work # Wrapper script

Czy Hermes obsługuje lokalne LLMs?

Tak, za pośrednictwem ścieżki niestandardowego endpointu. Hermes współpracuje z każdym serwerem zgodnym z OpenAI: Ollama, vLLM, SGLang, llama.cpp/llama-server, LM Studio, LocalAI, Jan lub własnym rozwiązaniem.² Instrukcje konfiguracji poszczególnych serwerów znajdują się w sekcji Niestandardowe endpointy i endpointy hostowane samodzielnie.

Dlaczego baner startowy pokazuje mniej narzędzi, niż podano w przewodniku?

W przewodniku podano 47 narzędzi / 20 toolsets na podstawie nadrzędnego rejestru architektury — jest to pełna liczba narzędzi, których kod źródłowy Hermes dostarcza we wszystkich toolsets. Działająca instalacja pokazuje w banerze mniejszą liczbę (instalacja referencyjna użyta w tym przewodniku zgłasza 28 narzędzi), ponieważ podczas uruchamiania Hermes włącza tylko domyślny zestaw toolsets. Wiele toolsets wymaga jawnego włączenia: adaptery gateway komunikacyjnego, automatyzacja przeglądarki, bardziej rozbudowane mechanizmy pobierania danych ze stron oraz kilka wyspecjalizowanych integracji muszą zostać wyraźnie wymienione w sekcji toolsets: pliku ~/.hermes/config.yaml, zanim zostaną załadowane. Łączna liczba w rejestrze = „co jest dostępne po włączeniu”. Łączna liczba w banerze = „co faktycznie załadowano w bieżącym profile”. Za pomocą hermes tools --list można sprawdzić, które toolsets są aktywne, a które są dostępne, lecz wyłączone. Poszczególne toolsets można przełączać podczas działania za pomocą /tools enable <name> i /tools disable <name> (wyłączenie powoduje zresetowanie sesji, aby agent przebudował manifest narzędzi zgodnie z nową konfiguracją).

Jak Hermes obsługuje awaryjną zmianę modelu, gdy główny dostawca przestaje działać?

Należy skonfigurować blok fallback_model w config.yaml:²

fallback_model:
  provider: openrouter
  model: anthropic/claude-sonnet-4

Gdy główny dostawca przestanie działać (z powodu limitu żądań, błędu serwera lub niepowodzenia uwierzytelniania), Hermes przełączy się na model awaryjny w trakcie sesji bez utraty historii rozmowy. Może to nastąpić najwyżej raz w każdej sesji.

Czy agent może z czasem ulepszać własne skills?

Tak — na tym polega „samodoskonalenie” Hermes Agent. Agent może tworzyć, aktualizować i usuwać skills za pomocą narzędzia skill_manage. Gdy opracuje nietrywialny przepływ pracy, zapisuje zastosowane podejście jako skill do ponownego wykorzystania w przyszłości.¹¹ Agent tworzy skills po złożonych zadaniach (wymagających co najmniej 5 wywołań narzędzi), po napotkaniu błędów i znalezieniu działającego rozwiązania, po skorygowaniu jego podejścia przez użytkownika albo po odkryciu nietrywialnego przepływu pracy.

Czy dostępna jest integracja z IDE?

Tak — Hermes może działać jako serwer ACP (Agent Client Protocol) dla VS Code, Zed i JetBrains:⁶

pip install -e '.[acp]'
hermes acp

Dziennik zmian

Źródła