Hermes Agent: przewodnik praktyka (2026)

W skrócie: Hermes Agent to samodoskonalący się agent AI typu open source opracowany przez Nous Research. Działa jako CLI oraz wieloplatformowy gateway komunikacyjny, przechowuje na dysku trwałą tożsamość i pamięć, gromadzi skills 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 punktem końcowym.¹²¹⁹ Bieżące wydanie to v0.21.5 (tag v2026.9.24 z 24 września 2026), zbiorcza poprawka dla linii v0.21; sekcja Co nowego w v0.21.5 omawia wprowadzone zmiany, a następujące po niej sekcje wydań są uporządkowane od najnowszego do najstarszego.⁵² Dla większości nowych użytkowników najtrudniejszym elementem jest uwierzytelnianie u dostawcy: w tagu v2026.9.24 Hermes udostępnia 39 dostawców na statycznej liście wyboru i automatycznie rozszerza ją na podstawie 38 dołączonych wtyczek dostawców, a ponadto obsługuje niestandardowe punkty końcowe oraz trzy odrębne ścieżki uwierzytelniania (klucz API w .env, OAuth przez hermes model lub niestandardowy punkt końcowy w config.yaml).⁵³ W pierwszej kolejności należy zrozumieć 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 środowiskach, pozyskuje dane z internetu, uruchamia podagentów, realizuje zaplanowane zadania cron, komunikuje się z Telegram/Discord/Slack/WhatsApp/Signal/Email za pośrednictwem jednego procesu gateway i tworzy własne skills na podstawie doświadczeń.¹ CLI to terminalowy interfejs użytkownika zbudowany na pętli konwersacji w run_agent.py; gateway jest procesem działającym długotrwale, który kieruje wiadomości z platform komunikacyjnych przez tę samą pętlę konwersacji.³

Różnica między okazjonalnym a zaawansowanym 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 odwzorowania 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: możliwości agenta ograniczane zależnie od platformy
4. System skills: pamięć proceduralna tworzona i rozwijana przez agenta
5. Gateway + cron + profiles: uruchamianie Hermes tam, gdzie odbywa się codzienna praca, a nie tylko w bieżącym miejscu

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 punkt końcowy w config.yaml. Należy wybrać ścieżkę odpowiednią dla danego dostawcy, a nie tę, która wydaje się znajoma.
• Zmiana dostawcy wymaga jednego polecenia. hermes model interaktywnie prowadzi przez konfigurację każdego obsługiwanego dostawcy, w tym logowania OAuth, natomiast /model provider:model pozwala przełączyć model w trakcie sesji bez utraty historii.²
• Dwa pliki stanowią część konfiguracji przeznaczoną do edycji przez użytkownika. ~/.hermes/config.yaml zawiera ustawienia, a ~/.hermes/.env — dane poufne. Plikami auth.json, SOUL.md, MEMORY.md oraz katalogiem 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. W przypadku migracji polecenie hermes claw migrate automatycznie importuje ponad 30 kategorii stanu.⁵
• Zadania pomocnicze domyślnie korzystają z głównego modelu. Analiza obrazu, klasyfikacja zatwierdzeń, kompresja i tytuły sesji są obsługiwane jako osobne „pomocnicze” wywołania LLM, a w tym tagu ustawienie auto kieruje wszystkie z nich do głównego modelu czatu – nie trzeba niczego konfigurować, jednak w przypadku kosztownych modeli rozumujących te zadania dodatkowe generują zauważalne koszty. Gdy ma to znaczenie, warto przypisać poszczególne pozycje auxiliary.<task> do tanich i szybkich modeli.⁴³⁴

Każda z poniższych sekcji opiera się na dokumentacji źródłowej dostępnej pod adresem hermes-agent.nousresearch.com/docs oraz drzewie kodu źródłowego w repozytorium github.com/NousResearch/hermes-agent. Każde stwierdzenie dotyczące faktów opatrzono przypisem wskazującym konkretną stronę źródłową, z której pochodzi.

Wybór ścieżki

Jak działa Hermes: model mentalny

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 edytorami, mechanizm przetwarzania wsadowego oraz serwer API.³ Wszystkie ostatecznie wywołują metodę AIAgent.run_conversation() w pliku run_agent.py, która:

1. Tworzy prompt systemowy na podstawie SOUL.md, MEMORY.md, USER.md, skills, plików kontekstowych i wskazówek dotyczących narzędzi za pośrednictwem agent/prompt_builder.py (w wyniku dekompozycji z września 2026 przeniesiono ją do nowego pakietu agent/)³
2. Ustala dostawcę środowiska wykonawczego za pomocą runtime_provider.py — na tym etapie wybierane są uwierzytelnianie, bazowy adres URL i tryb API³
3. Wywołuje dostawcę w jednym z trzech trybów API: chat_completions, codex_responses lub anthropic_messages³
4. Przekazuje wszystkie zwrócone wywołania narzędzi przez model_tools.py i centralny rejestr narzędzi (tools/registry.py)³
5. Powtarza pętlę, dopóki model nie wygeneruje ostatecznej odpowiedzi, a następnie zapisuje sesję w bazie SQLite z FTS5³

Zrozumienie tej pętli jest istotne, ponieważ każda funkcja — osobowości, pamięć, skills, kompresja i mechanizm fallback — wiąże się z jednym z tych etapów. Przy analizowaniu klucza konfiguracyjnego i zastanawianiu się nad jego działaniem odpowiedź zwykle brzmi: „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 i 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 stanowi system. Hermes przechowuje wszystko w ~/.hermes/ (lub w $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ę; żadne z nich się nie pokrywają. Odpowiedź na pytanie „gdzie Hermes przechowuje X?” zawsze wskazuje jeden z nich.

Co nowego w wersji v0.21.5 (zbiorcze wydanie z 24 września)

Hermes Agent v0.21.5 (tag v2026.9.24 z 24 września 2026) to bieżące wydanie — trzecie niewielkie wydanie zbiorcze w linii v0.21.x: „Ten tag obejmuje około 460 PR-ów scalonych od wersji v0.21.4 i udostępnia je jako stabilne, oznaczone wydanie dla dalszych odbiorców”. Opracowane informacje o wydaniu ponownie odłożono do wersji v0.22.0. Zmiany istotne dla operatorów, zweryfikowane w kodzie źródłowym oznaczonym tym tagiem:⁵²⁵³

• Pamięć Hindsight opuszcza główne drzewo. Usunięto wbudowanego dostawcę Hindsight oraz dodatek pip hermes-agent[hindsight]; Hindsight instaluje się teraz z katalogu pluginów i jest utrzymywany przez Vectorize; nie wspomniano o tym w informacjach o wydaniu. Jeśli konfiguracja zawiera memory.provider: hindsight, polecenie hermes update instaluje plugin z katalogu w katalogu domowym każdego profilu, który go wskazuje, a pierwsze uruchomienie agenta instaluje go, jeśli nadal go brakuje — chyba że security.allow_lazy_installs ma wartość false (w takim przypadku należy uruchomić hermes plugins install hindsight). Ustawienia, klucze .env i dane pamięci pozostają nienaruszone. Zobacz Zewnętrzni dostawcy pamięci.
• Wycofano gateway.multiplex_profiles: false. Gateway zmienia tę wartość na true bezpośrednio w pliku i jednorazowo wyświetla komunikat w ramce. Profil nazwany, który musi zachować własny gateway, ustawia gateway.standalone: true we własnym pliku config.yaml; aby wyłączyć jeden obsługiwany profil bez zatrzymywania hosta, polecenie hermes -p <name> gateway stop zawiesza teraz jego działanie. Zobacz Gateway komunikatorów.
• Nowe modele w selektorach Nous i OpenRouter: GPT-6 Sol oraz GPT-6 Luna (każdy również w wariancie -pro), a także Claude Opus 5.5.
• Zgodność pluginów pozostaje bez zmian: plugins.allow_deprecated_imports: true nadal działa.

Aktualizacja: hermes update lub jednowierszowe polecenie instalatora; obrazy Docker i Hermes Cloud są budowane na podstawie nousresearch/hermes-agent:v2026.9.24.⁵²

Co nowego w v0.21.4 (drugi zbiorczy patch)

Hermes Agent v0.21.4 (tag v2026.9.21, 21 września 2026) to drugi celowo niewielki zbiorczy patch w linii v0.21.x. Autorzy opisują go następująco: „Wydanie poprawkowe. Ten tag obejmuje około 1 800 PR-ów scalonych od wersji v0.21.3 i udostępnia je jako stabilne, oznaczone wydanie dla dalszych odbiorców (obrazy Docker, Hermes Cloud, wdrożenia hostingowe)”. Okres od v0.21.3 obejmuje „5 071 commitów bez scaleń” w „5 169 zmienionych plikach”, „1 812 scalonych PR-ów” oraz „2 116 zamkniętych zgłoszeń”. Pod względem liczby commitów jest to drugi co do wielkości okres między tagami w historii projektu — ustępuje tylko 5 139 commitom z v0.21.1 — natomiast pod względem liczby scalonych PR-ów jest największy. Opracowanie uporządkowanego opisu zmian ponownie odłożono, ujmując to dosłownie: „Pełne, opracowane informacje o wydaniu dla tego okresu pojawią się wraz z v0.22.0, które udokumentuje wszystko od v0.21.0”, oraz „Żaden element z tego okresu nie zostanie pominięty”. W informacji o wydaniu wymieniono jednak elementy, których jeszcze nie udokumentowano, a każdy z poniższych punktów sprawdzono w kodzie źródłowym dla tego tagu. Jeśli dany element zmienia istniejącą sekcję tego przewodnika, odpowiednie odwołanie znajduje się bezpośrednio w tekście.⁵⁰⁵¹

• Jeden gateway na host, a Desktop dołącza zamiast uruchamiać kolejną instancję. Obowiązuje zasada jednego procesu hermes serve i jednego procesu hermes gateway run na host oraz użytkownika systemu operacyjnego, przy czym każdy z nich obsługuje wszystkie profile — wymusza to nowa warstwa pojedynczej instancji dla całego hosta: blokada hosta utrzymywana przez cały czas działania zwycięskiego procesu oraz rekord punktu spotkania zawierający (pid, createTime). Dzięki temu drugie wywołanie może potwierdzić, że właścicielem jest ten sam aktywny proces, i dołączyć do niego zamiast zajmować drugi port. Nieaktualność jest zawsze potwierdzana, nigdy zakładana, a aplikacja Desktop stosuje tę samą zasadę po swojej stronie, dołączając do działającego backendu hosta zamiast uruchamiać kolejny. Szczegóły mechanizmu opisano w sekcji Messaging Gateway.⁵¹
• Connectors stają się jedną operacją kontrolowaną przez backend i korzystają z jednej karty konfiguracji. Wywołanie narzędzia manage_connections steruje na backendzie maszyną stanów połączenia opartą wyłącznie na danych, a Desktop, TUI oraz CLI wyświetlają ją jako tę samą kartę konfiguracji: jedno pole dla każdego brakującego poświadczenia, przy czym działanie karty pozostaje zablokowane, dopóki wszystkie wymagane pola nie zawierają tekstu. Więcej informacji zawiera podsekcja dotycząca bezpłatnego planu Nous.⁵¹
• --format stream-json: jednorazowe uruchomienia w formacie przeznaczonym do odczytu maszynowego. Polecenie hermes chat -q ... --format stream-json emituje do stdout po jednym obiekcie JSON w każdym wierszu dla mechanizmów CI i orkiestratorów: najpierw zdarzenie system/init, następnie zdarzenia przyrostów text, tool_use i tool_result, a na końcu pojedynczą końcową kopertę result zawierającą kod wyjścia, końcowy tekst i statystyki tokenów. Informacje diagnostyczne i identyfikator sesji pozostają w stderr, dane wyjściowe narzędzia są ograniczone do 5 000 znaków na zdarzenie, flaga wymusza --quiet, wymaga -q lub --query-file (bez jednego z nich proces kończy się kodem 2) i nie może być używana razem z --tui. Flaga została uwzględniona w tabeli opcji hermes chat.⁵¹
• skills.auto_load przypina skills do każdej sesji. Nazwy wymienione w skills.auto_load w pliku config.yaml są w całości ładowane w każdej nowej sesji — zarówno w CLI, TUI, gateway, cron, jak i API — i rozpoznawane jednokrotnie podczas pierwszego tworzenia promptu. Sekcja System skills zyskuje podsekcję dotyczącą przypiętych skills.⁵¹
• Opcja decline dla nieautoryzowanych wiadomości prywatnych. Ustawienie unauthorized_dm_behavior otrzymuje trzecią wartość obok pair i ignore: decline wysyła jedną uprzejmą odmowę, po czym przez 24 godziny nie odpowiada danemu nadawcy. Zob. Autoryzacja użytkowników i parowanie.⁵¹
• mcp.discovery_concurrency ogranicza równoległe połączenia podczas wykrywania MCP. Wartość domyślna to 4, a 0 oznacza brak limitu. Każdy skonfigurowany serwer nadal zostanie połączony, lecz połączenia nie będą już nawiązywane jednocześnie. Zob. Integracja z MCP.⁵¹
• session_search otrzymuje ograniczenia czasowe i ponawianie wyszukiwania. Struktura wykrywania przyjmuje ograniczenia after/before (w formacie ISO lub jako względne okresy, np. 7d), a wielowyrazowe zapytanie bez wyników jest ponawiane z dopasowaniem DOWOLNEGO terminu zamiast domyślnego w FTS5 łączenia wszystkich terminów operatorem AND. Zob. Wyszukiwanie sesji.⁵¹
• hermes sessions set-journal-mode delete|wal: konwerter trybu dziennika działający offline. To samoobsługowy sposób naprawy pliku state.db, który utknął w niewłaściwym trybie dziennika SQLite — wcześniej wymagało to ręcznego wykonania PRAGMA journal_mode=DELETE. Najpierw należy zatrzymać gateway, dashboard i wszystkie procesy CLI: polecenie odmawia działania, jeśli jakikolwiek obcy proces korzysta z bazy danych, przełącza tryb bez oczekiwania na zamknięcie aktywnych uchwytów i następnie weryfikuje bajty nagłówka SQLite. Windows nie oferuje skanowania procesów korzystających z pliku, dlatego polecenie odmawia tam działania, dopóki — po samodzielnym zatrzymaniu wszystkich procesów Hermes — nie zostanie przekazana flaga --force. Polecenie hermes doctor wskazuje teraz tę możliwość. Została ona uwzględniona w wierszu hermes sessions w sekcji Polecenia najwyższego poziomu.⁵¹
• Desktop: ustawienie czcionki, aktualizacje silnika jednym kliknięciem i odinstalowywanie pluginów. W ustawieniach pojawiło się pole rodziny czcionek, zapisywane osobno dla każdego profile w desktop.font_family — zastępuje ono bezszeryfowy krój motywu w czacie i interfejsie, a lista sugestii zaczyna się od krojów zwiększających dostępność (OpenDyslexic, Atkinson Hyperlegible, Lexend). Puste pole oznacza, że o wyborze decyduje motyw. Zarządzane środowisko wykonawcze lokalnego modelu wyświetla przycisk „Aktualizuj silnik”, gdy aktualizacja jest dostępna, a nieudana aktualizacja pozostaje widoczna, umożliwiając jej bezpośrednie ponowienie. Ponadto centrum Plugins pozwala odinstalować plugin po potwierdzeniu w oknie dialogowym.⁵¹
• Katalogi modeli wideo: LTX 2.5 i Kling O3. Plugin wideo FAL dodaje ltx-2.5 (otwartoźródłowy model audio-wideo firmy Lightricks: natywny dźwięk, generowanie wideo z obrazu o długości do 20 s i rozdzielczości 4K, ustawienia ruchu kamery, tani plan — fal odrzuca klipy dłuższe niż 10 s w rozdzielczości 1440p/2160p) oraz kling-o3 (najbardziej zaawansowana rodzina modeli firmy Kuaishou, plan premium: natywne opowiadanie wieloujęciowe, opcjonalny dźwięk, długość 3–15 s).⁵¹
• Katalog pluginów staje się dołączonym folderem i witryną internetową. Folder plugin-catalog/ w repozytorium rozrósł się z 9 pozycji w v2026.9.14 do 228 w tym tagu — po jednym zweryfikowanym pliku YAML na każdy plugin, przypiętym do konkretnego identyfikatora SHA commitu — a witryna dokumentacji tworzy teraz osobną stronę dla każdego pluginu i autora, wyświetlając na niej README pluginu z przypiętego commitu. Wszystkie 10 społecznościowych pluginów wymienionych w informacji o wydaniu znajduje się w katalogu dla tego tagu. Szczegóły zawiera sekcja System pluginów.⁵¹
• Oraz duża seria poprawek dotyczących izolacji profile/multiplex, cron, kanban, Desktop i state.db, wymieniona w informacji o wydaniu jedynie jako kategoria. Opracowany wykaz tych poprawek zostanie przygotowany dla v0.22.0.⁵⁰

Wycofanie warstwy zgodności pluginów nadal nie nastąpiło w tym okresie. Pliki COMPAT_MANIFEST.md, compat_manifest.json oraz warstwy zgodności są obecne w v2026.9.21. Jedyne zmiany w hermes_cli/plugin_compat.py z tego okresu to pamięć podręczna skanowania dla całego procesu (gateway typu multiplex wykrywa pluginy raz dla każdego obsługiwanego profile, a ponowne analizowanie kodu źródłowego każdego pluginu wydłużało uruchamianie o około 0,4 s na profile) oraz ścieżki trafień w formacie POSIX w systemie Windows (#112576). Ograniczenie daty i furtka w postaci literału logicznego pozostają bez zmian, dlatego plugins.allow_deprecated_imports: true nadal pozwala wczytywać pluginy, których dotyczy problem. Ramka dotycząca zgodności w sekcji System pluginów przedstawia aktualny stan.⁴²

Sposób aktualizacji pozostaje bez zmian: hermes update w przypadku instalacji z git lub instalator powłoki w przypadku nowych instalacji. Obrazy Docker oraz Hermes Cloud są budowane z tego tagu (nousresearch/hermes-agent:v2026.9.21).⁵⁰

Co nowego w v0.21.3 (patch z 14 września)

Hermes Agent v0.21.3 (tag v2026.9.14, 14 września 2026) obejmuje kolejne 3 dni zmian z gałęzi main, opisane w dwupunktowej informacji o wydaniu. Wersję opublikowano, ponieważ agenci Cloud automatycznie aktualizują się do najnowszego tagu wydania, a poprawki logowania do zdalnego gateway były potrzebne, aby można było się z nimi połączyć. (1) Sesje zdalnego dashboardu nie są już unieważniane przez serie odświeżeń: obie ścieżki odświeżania na gateway (mechanizm kontroli plików cookie i natywna trasa tokenu bearer aplikacji Desktop) łączą teraz równoczesne żądania zawierające ten sam rotacyjny token odświeżania w jedną operację. Dzięki temu seria żądań po wybudzeniu aplikacji Desktop nie może już ponownie użyć obróconego wcześniej tokenu, uruchomić w Nous Portal mechanizmu wykrywania ponownego użycia i unieważnić całej sesji. Odświeżanie odbywa się też poza pętlą zdarzeń, więc powolny dostawca tożsamości nie blokuje już /api/status. (2) Długotrwałe procesy przestają tworzyć zduplikowane uchwyty zapisu do state.db: gateway, backend dashboardu/Desktop, ACP oraz procesy odczytujące CLI dołączają w trybie tylko do odczytu, natomiast procesy zapisujące w ramach tej samej instancji współdzielą uchwyt rejestru. Statystyki tego okresu: „1 036 commitów bez scaleń” w „2 642 zmienionych plikach” oraz „338 scalonych PR-ów”. Wszystko inne odłożono celowo: w informacji o wydaniu wskazano elementy, których jeszcze nie udokumentowano (selektory poziomu intensywności rozumowania w każdym selektorze modelu, PKCE dla OAuth OpenRouter, dekodowanie HEIF/HEIC/AVIF, fala nowych pozycji w katalogu FAL, tabele wklejane w Slack i API Agent Sessions, odmowa używania trybu WAL przez state.db w systemach plików współdzielonych między maszynami wirtualnymi i inne zmiany), oraz zobowiązano się do przygotowania uporządkowanego opisu, ujmując to dosłownie: „Pełne, opracowane informacje o wydaniu dla tego okresu pojawią się wraz z v0.22.0, które udokumentuje wszystko od v0.21.0”, oraz „Żaden element z tego okresu nie zostanie pominięty”.⁴⁹

Termin wyłączenia zgodności pluginów nadszedł zgodnie z planem. Usunięcie zapowiedziane w v0.21.1 na 14 września 2026 zostało wdrożone w opublikowanym kodzie jako ograniczenie daty, a nie jako wycofanie kodu: w tagu v2026.9.14 plik hermes_cli/plugin_compat.py zawiera COMPAT_REMOVAL_DATE = 2026-09-14, a funkcja removal_in_effect() zwraca wartość true od tej daty (lub natychmiast po zniknięciu pliku manifestu). W rezultacie zewnętrzny plugin, którego dotyczy zmiana, jest teraz wyłączany podczas ładowania i wyświetlane jest czerwone ostrzeżenie. Co jeszcze NIE nastąpiło: wycofanie kodu, które rzeczywiście usuwa stare ścieżki importu. Pliki COMPAT_MANIFEST.md, compat_manifest.json oraz warstwy zgodności nadal są obecne w tym tagu — a także w v2026.9.21 i na gałęzi main według stanu na 22 września — dlatego plugins.allow_deprecated_imports: true wciąż działa jako furtka: stare ścieżki nadal można rozwiązać, gdy moduł ładujący otrzyma zgodę na kontynuowanie. Należy uważać na 2 kwestie: klucz musi być literałem logicznym YAML (kod akceptuje wyłącznie wartość logiczną True; ciąg znaków w cudzysłowie, taki jak "true" lub "false", jest traktowany jak brak ustawienia, zgodnie z komentarzem w kodzie „Literal boolean only”), a furtka przestanie działać w chwili wdrożenia wycofania, ponieważ same ścieżki znikną. Ramka dotycząca zgodności w sekcji System pluginów przedstawia aktualny stan.⁴²⁴⁹

Co nowego w v0.21.2 (wydanie poprawkowe state.db)

Hermes Agent v0.21.2 (tag v2026.9.11, 11 września 2026) powstał przede wszystkim po to, aby naprawić to, co zepsuła wersja v0.21.0. W informacji o wydaniu ujęto to wprost: „W v0.21.0 wprowadzono gruntownie przebudowaną obsługę połączeń z magazynem sesji, co w niektórych instalacjach naraziło state.db na awarie: równolegli autorzy wzajemnie anulowali swoje blokady, sprawne bazy danych były zgłaszane jako uszkodzone, a pojedynczy wadliwy wiersz uniemożliwiał działanie sessions list. To wydanie eliminuje całą tę klasę problemów i zbiera wszystkie pozostałe zmiany, które trafiły do main w ciągu czterech dni od v0.21.1”. W przeciwieństwie do celowo zwięzłej informacji o v0.21.1 ta wersja opisuje własne najważniejsze zmiany; statystyki tego okresu obejmują „947 commitów bez merge’ów”, „1 869 zmienionych plików” i „312 scalonych PR-ów” od „140 współtwórców”, natomiast opracowanie pełnego przebiegu całej serii v0.21.x pozostawiono na wydanie v0.22.0.⁴⁸

• Kampania na rzecz niezawodności state.db: sześć PR-ów i 44 zamknięte zgłoszenia. Najpierw przedstawiono zalecenie dla administratorów, które warto zastosować: jeśli state.db uległ uszkodzeniu w wersji 0.21.0 lub 0.21.1, należy uruchomić hermes doctor — polecenie rozróżnia teraz uszkodzenia strukturalne od uszkodzeń indeksu wyszukiwania pełnotekstowego, zamiast określać wszystkie problemy jako „uszkodzenie zapisu FTS”, a gdy sama przebudowa nie wystarcza, wskazuje hermes sessions recover --inspect-only (działające offline, niedestrukcyjne i przypisane do profilu; raportuje możliwość odczytu tabel kanonicznych bez tworzenia wyjściowej bazy danych). Usunięcie przyczyn źródłowych wyeliminowało wszystkich równoległych autorów zapisujących do magazynu: gatewaye profili co 5 sekund zapisywały stan hostowanych pokojów w głównym state.db, lecz mechanizm koordynacji znajduje się teraz w osobnym pliku shared-state.db, dzięki czemu gatewaye profili nigdy nie otwierają głównego magazynu sesji z prawem zapisu; dashboard najpierw otwiera go tylko do odczytu; zabezpieczenie cyklu życia cron korzysta z rejestru śledzonych połączeń zamiast bezpośredniego open() na aktywnej bazie danych (co anulowało blokady POSIX gatewaya — klasyczny sposób na uszkodzenie SQLite); ponadto doctor --fix odmawia wykonania checkpointu, jeśli nie może potwierdzić jego bezpieczeństwa. Poza kwestią równoległego zapisu: uszkodzenie indeksu FTS ogranicza teraz możliwości wyszukiwania, a indeks jest później przebudowywany, zamiast powodować zamknięcie całej tury z błędem; pojedynczy uszkodzony wiersz nie uniemożliwia już działania sessions list, eksportu ani analiz (wadliwe wiersze są wyświetlane jako ? wraz z ostrzeżeniem wskazującym sesję); sesje nigdy nie łączą się z bazą danych innego profilu ani z niej nie odczytują; ponadto otwarcie tylko do odczytu nie zakłada już blokady zapisu, dlatego jednorazowe wywołanie hermes przy obciążonym gatewayu zamiast zawieszać się na 4–20 s i kończyć błędem, trwa teraz 0,01 s.⁴⁸
• Wzmocnienie izolacji wielu profili. Od wersji v0.19.0 w tym przewodniku przytaczane jest zapewnienie projektu, że routing profili gwarantuje każdemu profilowi „całkowicie odizolowaną konfigurację, skills, pamięć i sekrety”. W wersji v0.21.2 zapewnienie to miało luki, które zostały już usunięte: boty profili dodatkowych dziedziczyły listy dozwolonych elementów z profilu domyślnego, adaptery mogły wysyłać dane uwierzytelniające do hosta profilu domyślnego, serwery stdio MCP otrzymywały sekrety ze skarbca profilu domyślnego, dostarczanie przez MEDIA: mogło załączyć plik .env/auth.json/state.db innego profilu, callbacki webhooków i Feishu mogły odchodzić od profilu wybranego przez routing, a profile dodatkowe mogły pobierać token bearer Nous należący do profilu równorzędnego z pamięci podręcznej procesu (#107609-#107630). Jeśli w ramach jednego multipleksowanego gatewaya działa kilka profili, dopiero w tym wydaniu deklarowana izolacja rzeczywiście funkcjonuje.⁴⁸
• Skarbiec danych uwierzytelniających niewidocznych dla agenta. Agent może teraz logować się, płacić i wypełniać adresy w przeglądarce przy użyciu 1Password, Bitwarden lub lokalnego skarbca Hermes, nigdy nie uzyskując dostępu do sekretu, natomiast kody uwierzytelniania dwuskładnikowego pochodzą z zapisanego klucza aplikacji uwierzytelniającej (TOTP: ziarno zakodowane w base32 lub URI otpauth://totp; licznikowy HOTP jest odrzucany) albo użytkownik jest proszony o ich podanie w interfejsie. Każdy backend przekazuje agentowi dane w tej samej postaci — metadane logowania wraz z nieprzezroczystym uchwytem z przestrzenią nazw (vault_ lokalnie, op:, bw:), przy czym hasło jest pobierane dopiero podczas wypełniania; zewnętrzne menedżery pozostają zablokowane do czasu odblokowania ich na czas sesji, a hasło główne „nigdy nie jest argumentem narzędzia ani elementem argv i nigdy nie jest utrwalane”. Rozwiązanie rozwija mechanizm SecretSource z wersji v0.19.0, który usunął klucze API dostawców z pliku .env przechowującego je jawnym tekstem; skarbiec zapewnia teraz taką samą ochronę danych uwierzytelniających używanych przez agenta podczas przeglądania stron.⁴⁸
• Starannie dobrany katalog pluginów przypiętych do SHA. Polecenie hermes plugins browse wyświetla „wszystkie starannie dobrane pozycje katalogu pluginów”, hermes plugins search przeszukuje katalog, a hermes plugins install rozpoznaje nazwy katalogowe obok adresów URL Git i zapisów owner/repo. Całość uzupełnia hermes plugins pack z „deklaratywnymi zestawami pluginów, które można udostępniać”: pojedynczy plik hermes-pack.yaml przypina zestaw pluginów do konkretnych SHA commitów, pack install rozdziela operację na zwykłe instalacje przypiętych wersji, przy czym zgoda na uprawnienia pozostaje osobna dla każdego pluginu, pack export generuje zestaw dla bieżącej instalacji, a pack show umożliwia symulację bez wprowadzania zmian. Blok poleceń w sekcji System pluginów zawiera nowe podpolecenia.⁴⁸
• Bezpłatny plan Nous i pierwsze uruchomienie z przewodnikiem. Świeże instalacje od razu zapewniają bezpłatne wnioskowanie i konektory, a do zalogowania wystarcza jedno polecenie; /login działa bezpośrednio na czacie, a narzędzia konektorów (Gmail, Linear, Notion i pozostałe) można wyszukiwać za pomocą tool_search. Pierwsze uruchomienie aplikacji desktopowej z przewodnikiem jest kontrolowane przez HERMES_GUEST_ONBOARDING=1 i włącza je wyłącznie dosłowna wartość 1: test samej aplikacji desktopowej potwierdza, że wartości 'true', '0' oraz pusta pozostawiają tę funkcję wyłączoną, a decyzja podjęta podczas uruchamiania jest zapisywana w środowisku uruchomionego backendu, dzięki czemu odziedziczona wartość nie może się do niego przedostać. Więcej informacji znajduje się w sekcji Nous Tool Gateway.⁴⁸
• Koniec lawinowego uruchamiania backendów przez aplikację desktopową. Bot Mode uruchamiał wcześniej jeden backend na profil lub nawiązywał z nim połączenie zarówno przy starcie, jak i przy każdym odświeżeniu listy; samo najechanie kursorem na listę botów uruchamiało backend dla każdego wiersza, a przełączenie profilu mogło uruchomić drugi egzemplarz głównego backendu. Wszystkie te problemy naprawiono w tym wydaniu.⁴⁸

Sposób aktualizacji pozostaje bez zmian: hermes update dla istniejącej instalacji albo instalator powłoki w przypadku nowej.⁴⁸

Co nowego w v0.21.1 (zbiorcza poprawka)

Hermes Agent v0.21.1 (tag v2026.9.7 z 7 września 2026) jest celowo skromnym wydaniem: to „wydanie poprawkowe”, które „zbiera bieżący stan gałęzi main od v0.21.0 na potrzeby wdrożeń opartych na tagach i dalszych odbiorców”. W opisie podano statystyki z tego okresu — „5 139 commitów bez scaleń w 4 364 zmienionych plikach (+601 014 / -768 419)” oraz „632 scalone PR-y” — po czym właściwą historię odłożono na później: „Pełne, zredagowane informacje o wydaniu obejmujące ten okres zostaną opublikowane wraz z v0.22.0”. Jest to więc największy w historii projektu zakres zmian między kolejnymi tagami (żaden wcześniejszy zakres między sąsiednimi tagami nie przekracza 2 790 commitów bez scaleń z v2026.7.20..v2026.7.30), opublikowany z najkrótszym opisem wydania. Zanim w v0.22.0 powstanie zredagowany zapis, poniższych sześć obszarów — każdy zweryfikowany w kodzie źródłowym — pokazuje, co w tym tagu zmienia sposób pracy z Hermes.⁴¹

• Baza kodu została podzielona, a termin zgodności pluginów upłynął 14 września. Przeprowadzony we wrześniu 2026 podział (PR #102117) rozbił duże moduły repozytorium na wyspecjalizowane pliki: nowy pakiet agent/ zawiera wewnętrzne elementy pętli konwersacji (214 modułów najwyższego poziomu oraz siedem podpakietów; prompt_builder.py znajduje się teraz w agent/prompt_builder.py, natomiast run_agent.py pozostaje siedzibą AIAgent), parsery podpoleceń CLI przeniesiono do pakietu hermes_cli/subcommands/ (61 modułów), statyczną listę CANONICAL_PROVIDERS przeniesiono z hermes_cli/models.py do hermes_cli/models_catalog_static.py (sama lista się nie zmieniła: nadal zawiera 39 statycznych pozycji i jest automatycznie rozszerzana na podstawie 39 dołączonych folderów pluginów dostawców), a delegate_task rozdzielono na około tuzin modułów tools/delegate_tool_*. Wewnętrzne ścieżki importu nie stanowią stabilnego API, dlatego nowy plik COMPAT_MANIFEST.md w katalogu głównym repozytorium ponownie eksportuje 1 148 „przeniesionych, ładowanych leniwie” nazw publicznych z ich dawnych ścieżek modułów. Przy rozwiązywaniu każdej z nich raz na nazwę i proces emitowane jest ostrzeżenie HermesPluginCompatWarning. Warstwa zgodności była tymczasowa, a jej wyłączenie nastąpiło zgodnie z harmonogramem 2026-09-14, sześć dni po utworzeniu tagu — nie poprzez wycofanie kodu, lecz za sprawą bramki daty obecnej już w wydanym kodzie. Od tego dnia plugin zewnętrzny, którego dotyczy problem, nie jest ładowany: baner CLI, hermes doctor i hermes update wyświetlają czerwony komunikat z nazwą wyłączonego pluginu, aplikacja komputerowa jednorazowo pokazuje okno modalne, a hermes plugins list podaje przyczynę. Jeśli używane są zewnętrzne pluginy, należy je sprawdzić: hermes plugins compat <path> wypisuje każde wystąpienie file:line wraz ze starą i nową ścieżką oraz kończy działanie z kodem 1, dopóki pozostają jakiekolwiek niezgodności (--json zapewnia wynik przetwarzalny maszynowo; uruchomienie bez argumentów skanuje cały zestaw zainstalowanych pluginów). Rozwiązaniem awaryjnym dla pluginu, którego autor nie zdążył wprowadzić zmian, jest plugins.allow_deprecated_imports: true w config.yaml — i nadal ono działa: zmiana faktycznie usuwająca stare ścieżki importu wciąż nie została scalona według stanu na 22 września (zweryfikowano do tagu v2026.9.21 oraz w gałęzi main), więc po zezwoleniu loaderowi na kontynuowanie stare ścieżki nadal są rozwiązywane. Szczegóły następstw opisano powyżej w sekcji Co nowego w v0.21.2, a sekcja System pluginów zawiera ramkę z aktualnym stanem.⁴²
• Konwersacje gateway nie są już rotowane przez zegary — w żadnych okolicznościach. Dokumentacja cyklu życia sesji określa teraz tę zasadę wprost: „Brak aktywności ani upływ czasu nigdy nie powodują rotacji konwersacji. /new i /reset tworzą jawną granicę; kompresja kontekstu nadal służy do zarządzania długimi historiami. Starsza konfiguracja czasomierzy jest ignorowana. Istniejący typ danych SessionResetPolicy to nieaktywne dane zgodności, a nie zasada wykonywana w czasie działania”. Granice są jawne i wyznaczane przez użytkownika; czasomierze resetowania sesji z czasów OpenClaw, przeniesione przez hermes claw migrate, są obecnie nieaktywnymi danymi. Zob. Gateway komunikacyjny.⁴³
• Autoryzacja MCP zyskuje przepływ z kodem urządzenia. Polecenie hermes mcp login <name> otrzymuje opcję --flow {browser,device}: browser oznacza dotychczasowy przepływ PKCE, device — logowanie kodem urządzenia zgodne z RFC 8628, przeznaczone dla maszyn, na których wywołanie zwrotne przeglądarki jest niepraktyczne, a flaga zastępuje ustawienie oauth.flow serwera. W tym okresie wzmocniono również pozostałą część mechanizmu uwierzytelniania MCP: własność profilu jest egzekwowana we wszystkich sesjach OAuth, nieprawidłowe pamięci podręczne metadanych OAuth są ignorowane zamiast blokować serwer, a aplikacja komputerowa przekazuje OAuth MCP przez lokalne wywołania zwrotne klienta. Powiązana zmiana: -t/--toolsets filtruje teraz również, które skonfigurowane serwery MCP są w ogóle uruchamiane, dzięki czemu jednorazowe wykonanie hermes -z -t <toolsets> pomija inicjalizowanie niewymaganych serwerów od zera. Blok poleceń w sekcji Integracja MCP zawiera teraz login i reauth [--all]; oba polecenia istniały już przed tym okresem, lecz wcześniej nie były tutaj udokumentowane.⁴⁴
• Delegowanie uczciwie przedstawia teraz pracę w tle. Sześć zmian zwiększających niezawodność delegate_task, wszystkie odczytane z kodu źródłowego narzędzia delegującego w tym tagu. (1) Domyślnie zadania wsadowe w tle zwracają JEDNO ukończenie; włączenie delegation.independent_completions dzieli wywołanie na jednostki ukończenia: zadania o tej samej wartości group są łączone i raportowane razem, natomiast każde niezgrupowane zadanie jest raportowane osobno po zakończeniu. To świadomy wybór — w kodzie źródłowym zauważono, że lawina ukończeń poszczególnych zadań „rozbijała pracę orkiestratorów, które nie były na nią przygotowane”. (2) Procesy działające w tle u agenta potomnego są kończone podczas jego zamykania, chyba że agent przekaże je agentowi nadrzędnemu za pomocą process_manage(action="handoff"); nieprzekazane pozostałości są wymieniane w wyniku jako orphaned_processes, a procesy potomne, które zakończyły się bez odczytania ich wyniku, pojawiają się jako unread_completions wraz z końcowym fragmentem danych wyjściowych. Jak stwierdzono w docstringu kodu źródłowego, założenie projektowe jest takie, że agent nadrzędny „musi otrzymać tę informację ze środowiska wykonawczego”, zamiast ufać deklaracji agenta potomnego, że „proces obserwujący działa”. (3) delegation.fallback_providers staje się rzeczywistym elementem konfiguracji: null powoduje odziedziczenie łańcucha agenta nadrzędnego przez agentów potomnych bez przypisania, [] wyłącza mechanizm awaryjny, a agent potomny przypisany do dostawcy, endpointu lub modelu nie otrzymuje żadnego mechanizmu awaryjnego, chyba że zostanie on określony w tym ustawieniu. (4) Łańcuch awaryjny agenta potomnego jest rozwiązywany za pomocą kanonicznego normalizatora, więc nieprawidłowe wpisy są odrzucane, zamiast uniemożliwiać uruchomienie. (5) Awaria w trakcie jednostki nie powoduje już utraty zakończonych agentów potomnych: każdy ukończony agent potomny w jednostce obejmującej wielu agentów jest trwale zapisywany w wierszu tej jednostki i trafia do odzyskanego wyniku jako rezultat częściowy. (6) Subagenci nigdy nie dziedziczą godzinnej warstwy pamięci podręcznej promptów: delegowany agent potomny jest przenoszony do warstwy 5-minutowej, ponieważ warstwa 1-godzinna jest wyceniona z myślą o osobie, która odchodzi od komputera, a nie o gwałtownej serii równoległych agentów potomnych.⁴⁵
• Dostawcy i modele. Do katalogów trafiają GPT-6 Astra i Astra Pro od OpenAI wraz z wariantami poziomów szybkości -fast/-flex („2-krotna cena, poziom priorytetowy” / „0,5-krotna cena, poziom elastyczny”) w katalogach Nous Portal i OpenRouter. Na trasie OAuth ChatGPT/Codex dostęp do Astra zależy od konta (model może być ogłaszany wyłącznie przez aktywne wykrywanie w zakresie konta) i zyskuje opcjonalny wariant -900k w selektorze, który zwiększa deklarowane okno z 272K do zweryfikowanych na żywo około 900K; sufiks nigdy nie jest przesyłany. Dołączają również: anthropic/claude-fable-5.1, google/gemini-3.7-flash i gemini-3.8-flash, qwen/qwen3.8-max-0902 i qwen3.8-flash, a także rodzina Muse Spark 1.3 firmy Meta (kontekst 1M, w tym warianty dla współtwórców) oraz plugin dostawcy generowania obrazów muse-image firmy Meta. Tavily pojawia się jako backend do wyszukiwania i wyodrębniania treści z internetu (TAVILY_API_KEY; po wybraniu Tavily przez hermes tools działa także bez klucza). Zarządzane środowisko wykonawcze llama.cpp czyni lokalne modele pełnoprawną ścieżką (oficjalne pliki binarne, jeden nadzorowany llama-server, konfiguracja jednym kliknięciem w aplikacji komputerowej), a dostawcy procesów zewnętrznych spoza repozytorium otrzymują własną gałąź rozwiązywania. Od strony operacyjnej zdalne katalogi selektora są teraz odświeżane co 20 minut (model_catalog.ttl_minutes, domyślnie 20; starszy klucz ttl_hours jest respektowany wyłącznie wtedy, gdy użytkownik jawnie ustawił jego wartość).⁴⁶
• Aplikacja komputerowa: adnotacje na stronie i kontrola nad sesją. Przeglądarka w aplikacji zyskuje tryb komentarzy: należy kliknąć Annotate, następnie kliknąć dowolny element aktywnej strony (lub przeciągnąć, aby zaznaczyć obszar) i wpisać notatkę; zapisane komentarze pozostają jako ponumerowane pinezki i nigdy samodzielnie nie wysyłają tury. Po zakończeniu opcja „Add N comments” przekazuje zestaw do edytora wraz z przyciętym zrzutem ekranu dla każdej pinezki, a każdy komentarz do elementu zawiera jego selektor CSS, znaczniki oraz style obliczone istotne dla układu, dzięki czemu agent odnajduje element w kodzie źródłowym, zamiast zgadywać na podstawie obrazu (hasła, ukryte wartości i atrybuty przypominające klucze są usuwane, zanim znaczniki opuszczą stronę). Większe zestawy są grupowane według obszaru strony, więc ponad dwadzieścia komentarzy zamienia się w kilka fragmentów pracy, które zazwyczaj dotyczą osobnych plików — dzięki temu można bezpiecznie rozdzielić je między równoległych pracowników. Towarzyszą temu: uporządkowane mechanizmy sterowania sesjami i ich automatyzacją, tworzenie sesji przez przeciągnięcie, widok importowania sesji z transkrypcji innych agentów programistycznych, display.resume_last_session (domyślnie true: zimny start ponownie otwiera ostatni czat lub stronę), wyświetlana przy pierwszym otwarciu prośba o zgodę na użycie browser.use_real_profile, gdy panel Browser zostaje otwarty z wyłączonym ustawieniem, wbudowany katalog opcjonalnych skills w Capabilities -> Skills z instalacją jednym kliknięciem oraz nowy rosyjski język interfejsu aplikacji komputerowej (17 katalogów ustawień regionalnych CLI pozostaje bez zmian).⁴⁷

Sposób aktualizacji pozostaje bez zmian: hermes update w istniejącej instalacji lub instalator powłoki w przypadku nowej. Zredagowany opis tego okresu pojawi się w v0.22.0; powyższe obszary przedstawiają zmiany wprowadzone w tym tagu.⁴¹

Co nowego w wersji 0.21.0 (wydanie Pantheon)

Hermes Agent v0.21.0 (tag v2026.8.31, 31 sierpnia 2026) jest obecnym wydaniem funkcjonalnym i stanowi uporządkowane zestawienie, do którego odwoływała się cała seria zbiorczych aktualizacji v0.20.x: „To wydanie obejmuje wszystkie poprawki infrastruktury oznaczone tagami v0.20.1–v0.20.6 — okresy te zostały tutaj w pełni udokumentowane”. Narracja jest kontynuacją wydania Herald: „Wersja v0.20.0 uczyniła Hermesa heroldem — przemawiał i przekazywał wieści innym agentom. W wersji v0.21.0 bogowie zbierają się razem”. Statystyki w oryginalnym brzmieniu: „Od wersji v0.20.0: ~5 800 commitów · ~2 475 scalonych PR-ów · ~5 680 zmienionych plików · ~869 000 dodań · ~135 000 usunięć · ~2 100 zamkniętych zgłoszeń · ponad 760 współtwórców”.³⁵

Wydanie uporządkowano według obszarów funkcjonalnych; tak samo zorganizowano niniejsze podsumowanie. Jeśli dana funkcja zmienia istniejącą sekcję tego przewodnika, odsyłacz znajduje się bezpośrednio w tekście.

• Bot Mode: agenci tworzą wbudowaną społeczność. Bot Mode, wcześniej dostępny jako dołączona wtyczka hermes-bots z okresu v0.20.3, staje się domyślnie włączoną częścią aplikacji desktopowej. Każdy profile agenta otrzymuje nazwę, deterministyczny awatar twarzy z opcjami losowania i blokowania oraz miejsce we wspólnym wykazie; można tworzyć czaty grupowe w stylu Discorda, w których wiele botów i użytkownik rozmawiają w jednym pokoju, oznaczać dowolnego bota za pomocą @ w polu tworzenia wiadomości, a także nadawać pokojom nazwy i obrazy. Katalog funkcji obejmuje karty wiadomości między agentami ze wskazaniem nadawcy, powiadomienia o dostarczeniu po stronie nadawcy, mechanizm paint-first hydration zapewniający natychmiastowe wybudzanie, panel Routines oraz przebudowę opartą na systemie projektowym aplikacji. Jak ujęto to w samym wydaniu: „Wcześniej »multi-agent« oznaczało techniczne zaplecze; teraz wygląda jak aplikacja do czatowania pełna współpracowników”.³⁵
• hermes peer: bezpośrednie wiadomości między botami należącymi do użytkownika. Każdy agent Hermes może wysłać wiadomość do dowolnego innego agenta za pomocą jego uchwytu — między profilami i gateway — z poziomu CLI lub bezpośrednio z rozmowy. Można poprosić bota badawczego o przekazanie ustaleń botowi programistycznemu, a następnie odczytać odpowiedź w bieżącym miejscu. „Odpowiedzi trafiają do kanonicznego Bot Chat każdego agenta, dlatego rozmowy między agentami są trwałe i możliwe do przejrzenia, zamiast znikać po wysłaniu”. Polecenie hermes peer (dodawanie, wyświetlanie i usuwanie peerów oraz dm) znajduje się w tabeli poleceń najwyższego poziomu.³⁵
• Zadania cron, które pamiętają. Zaplanowane zadania przestają mieć pamięć złotej rybki: agenci cron wczytują i aktualizują trwałą pamięć tak samo jak pozostali agenci, continuity=true przekazuje wynik każdego uruchomienia do następnego, dzięki czemu monitor może pomijać informacje, które już zgłosił, a każde zadanie otrzymuje trwały notatnik roboczy. Zadania działające w trybie monitorowania całkowicie pomijają LLM, gdy nic się nie zmieniło, poziom intensywności rozumowania można ustalić osobno dla każdego zadania, a wynik cron może trafić do kanonicznego Bot Chat bota, który rzeczywiście na niego odpowie. Sekcja Zaplanowane zadania (Cron) opisuje teraz mechanikę tagu dla każdej z tych funkcji.³⁵³⁷
• Orkiestracja subagentów na żywo. delegate_task zyskuje działania sterujące: wyświetlanie działających agentów podrzędnych, korygowanie kierunku pracy jednego z nich w trakcie wykonywania zadania oraz wcześniejsze zatrzymywanie z zachowaniem częściowego wyniku. Wyniki agentów podrzędnych można weryfikować względem schematu JSON, rezultaty pokazują koszt poszczególnych delegacji, a wartości domyślne zwiększono do 250 iteracji na subagenta i 10 równocześnie działających agentów podrzędnych — są to ujednolicone limity, które w wersji v0.19.0 zastąpiły max_async_children.³⁵³⁸
• Centrum sterowania MCP. Serwery MCP i katalog połączono na jednej stronie aplikacji desktopowej. Dodano import „wklej czegokolwiek” metodą przeciągania, działające w tle kontrole kondycji, które przypominają o ponownym uwierzytelnieniu, zanim wywołanie narzędzia zakończy się niepowodzeniem, nakładkę kosztów i wykorzystania całej floty (szacunkowa liczba tokenów schematu oraz wykorzystanie każdego serwera z ostatnich 30 dni), a także deep linki hermes://, które instalują serwer MCP po wyraźnym potwierdzeniu. Zobacz Integracja z MCP.³⁵
• Fala nowych możliwości CLI. Skrót Ctrl+P otwiera paletę poleceń z wyszukiwaniem przybliżonym, dostępną również jako /palette; selektor /model filtruje wyniki podczas pisania; /status pokazuje tryb rozumowania, oczekujące zatwierdzenia i wykorzystanie kontekstu; natomiast pasek stanu może na żywo wyświetlać odsetek trafień w pamięci podręcznej, opóźnienie i liczbę tokenów na sekundę, z możliwością osobnego przełączania każdego pola. Dodano także globalne zatrzymanie awaryjne, przypinanie i odpinanie sesji, zmieniające się teksty zastępcze w polu tworzenia wiadomości oraz terminalowe zwierzaki. Uwaga dotycząca nazewnictwa: w opisie wydania narzędzie do próbnego sprawdzania zatwierdzeń figuruje jako hermes approval-check; w oznaczonej tagiem wersji funkcja ta jest dostępna jako hermes approvals test — podpolecenie approval-check nie istnieje.³⁵⁴⁰
• Agent steruje przeglądarką aplikacji desktopowej. Przeglądarka w aplikacji przestaje być oknem, na które agent może jedynie patrzeć: Hermes bezpośrednio po niej nawiguje, klika i odczytuje jej zawartość, a strony można otwierać w przeglądarce systemowej wraz z pełnymi menu kontekstowymi odnośników.³⁵
• Sześciu nowych dostawców i fala zmian w katalogu modeli. Meta Model API (Muse Spark), CommandCode, Tencent TokenPlan, Nebius Token Factory, Ramp Router i Actual Computer. Trzech z nich (Meta AI, CommandCode i Actual Computer) dodano we wcześniejszych okresach zbiorczych aktualizacji i uwzględniono już w macierzy dostawców; obecnie macierz obejmuje również Tencent TokenPlan, Nebius Token Factory i Ramp Router, a także nowy pakiet Alibaba Token Plan opisany w dokumentacji. Do katalogów trafiają GLM-5.3-Flash, qwen3.8-max/flash, Gemini 3.7 Flash, bezpłatny MiniMax M3, Nemotron 3.5 Lightning oraz Muse Spark 1.2. Towarzyszą temu 2 zmiany strukturalne: model_overrides w pliku config.yaml pozwala zmienić okno kontekstowe lub ceny dowolnego modelu bez czekania na kolejne wydanie, a dostawcy mogą być teraz dystrybuowani jako pakiety instalowane przez pip i wykrywane za pomocą punktów wejścia. Ujednolicony rejestr zabezpieczeń wyboru ostrzega również we wszystkich selektorach, gdy model trenuje na danych użytkownika.³⁵³⁶
• Kompleksowe wzmocnienie zabezpieczeń. Zapisy do chronionych plików z instrukcjami agenta (AGENTS.md, skills i magazynów pamięci) zawsze wymagają teraz zatwierdzenia, dzięki czemu agent poddany atakowi prompt injection nie może po cichu przepisać własnych stałych instrukcji. Szeroko zakrojony mechanizm redagowania danych zamyka luki umożliwiające wyciek sekretów przez błędy terminala, odczyty plików .env, checkpointy i logi ACP; system zatwierdzeń rozpoznaje destrukcyjne polecenia systemu Windows; przyznane uprawnienia macOS pozostają ważne po aktualizacjach dzięki stabilnej tożsamości podpisu TCC (hermes desktop --setup-tcc-identity); a wpis Blender MCP w katalogu oraz powiązany skill usunięto po naruszeniu bezpieczeństwa projektu źródłowego. Szczegóły dla oznaczonej tagiem wersji znajdują się w sekcji Wzmocnienie zabezpieczeń.³⁵³⁹
• Dojrzewanie gateway. Slack otrzymuje natywne karty na żywo — rzeczywiście strumieniowane odpowiedzi oraz opcjonalne karty planów i zadań — a także wyłączanie podglądów odnośników w wiadomościach wychodzących. Telegram zyskuje selektor wbudowany, dzięki któremu każde polecenie i każdy skill można wyszukać za pomocą @botname, z pominięciem limitu menu poleceń Telegrama. Mechanizm przekazywania dojrzewa dzięki natywnej inicjalizacji wtyczek, operacjom na kartach na żywo ze strumieniowaniem wersji roboczych, segmentacji zakresu sesji i przywróconej transkrypcji STT notatek głosowych. Gniazdo sterujące gateway umożliwia klientom zarządzającym flotą wysyłanie zapytań do gateway, a mechanizmom aktualizacji — jego łagodne wstrzymanie zamiast wymuszonego zamykania całego drzewa procesów. Mechanizm turn-reaper zapisuje stosy zablokowanych workerów po uruchomieniu watchdog.³⁵
• Fala nowych skills. Osiem odzyskanych skills zwiększających produktywność (document-to-action-items, meeting-action-items, email-inbox-triage, github-issue-to-pr, weekly-review-planning, competitor-news-monitor, product-price-monitor, social-media-content-calendar), klienty API utworzone na podstawie HAR („raz obserwować witrynę, a następnie bezpośrednio wywoływać jej ukryty API bez przeglądarki”), publish-site, session-librarian, blocked-page-recovery, merge-reconciler, plan-interrogation oraz doradczy linter SKILL.md uruchamiany podczas tworzenia.³⁵

Wycofane w tym okresie (nie wchodzą w skład wydania): tryb Model Council (/council) i context engine DCP zostały dodane, a następnie wycofane; serwer gateway działający wyłącznie przez WS (#94245) scalono, po czym wycofano (#96118), dlatego FastAPI nadal pozostaje częścią ścieżki uruchamiania aplikacji desktopowej — dostarczono jednak powtórne odtwarzanie zdarzeń ze znacznikami sekwencji (#94219) oraz bezstratne ponowne łączenie aplikacji desktopowej przez WebSocket. Electron przywrócono do wersji 40.10.2. Jeśli materiały społecznościowe dotyczące okresów v0.20.x wspominały o którejkolwiek z tych funkcji, nie ma jej w tym wydaniu.³⁵

Sposób aktualizacji pozostaje bez zmian: hermes update w przypadku istniejącej instalacji albo instalator powłoki w przypadku nowej. Podsekcja zbiorczych aktualizacji znajdująca się poniżej opisu wydania Herald nadal zawiera zestawienie funkcji dodanych w poszczególnych okresach oznaczonych tagami.³⁵

Co nowego w v0.20.0 (wydanie Herald)

Hermes Agent v0.20.0 (tag v2026.8.3 z 3 sierpnia 2026) był wydaniem funkcjonalnym poprzedzającym v0.21.0, które scaliło wszystkie dotychczasowe zmiany; v0.20.1 (13 sierpnia) i v0.20.2 (16 sierpnia) to bazujące na nim wydania stabilizacyjne, natomiast v0.20.3 (tag v2026.8.16.2, opublikowany 17 sierpnia), v0.20.4 (tag v2026.8.18 z 18 sierpnia), v0.20.5 (tag v2026.8.19, opublikowany 21 sierpnia) oraz v0.20.6 (tag v2026.8.27 z 27 sierpnia) kontynuują serię wydań zbiorczych, wprowadzając także własne funkcje — szczegóły znajdują się w podsekcji poniżej. Okres od v0.19.0 obejmuje około 3 650 commitów, 1 400 scalonych PR-ów oraz 1 200 zamkniętych zgłoszeń przy udziale ponad 650 współtwórców.⁵⁵

Trzy zmiany unieważniają zalecenia podane we wcześniejszych wersjach tego przewodnika. Należy zapoznać się z nimi w pierwszej kolejności:

• Wymagany jest teraz Node 26. Instalator przypina NODE_VERSION="26" i odrzuca starsze środowiska wykonawcze z komunikatem „Node.js … jest zbyt stary (Hermes wymaga Node >=26)”. Instalatory oraz polecenia heal i upgrade egzekwują ten wymóg. Warto zauważyć, że strona instalacyjna w dokumentacji nadal podaje Node v22 — skrypt instalacyjny i informacje o wydaniu są nowszymi, autorytatywnymi źródłami.⁵⁵
• pip i Homebrew zostały wycofane, a nie jedynie oznaczone jako przestarzałe. Dosłownie: „kanały brew oraz pakietów pip/PyPI zostały wycofane (obsługiwane kanały to instalator powłoki / Docker / Nix)”. Instalacje wykonane przez pip lub brew nie otrzymują już nowych wydań.⁵⁵
• Domyślny limit iteracji wywoływania narzędzi zwiększono z 90 do 500. Długie autonomiczne przebiegi nie napotykają już sztucznej bariery, a wszystkie poniższe progi presji budżetu są obliczane względem nowego limitu. Domyślny limit read_file wynosi teraz również 2 000 wierszy zamiast 500.⁵⁵

Pozostałe elementy wydania:

• Konwersacyjna obsługa głosu. Strumieniowe TTS z możliwością przerwania wypowiedzi oraz lokalnie rozpoznawanymi słowami wybudzającymi.⁵⁵
• A2A v1.0. Plugin protokołu komunikacji między agentami, realizujący długo oczekiwane zgłoszenie nr 514.⁵⁵
• Podpisane wychodzące webhooki. hermes webhook obsługiwało wcześniej wyłącznie ruch przychodzący; v0.20.0 dodaje wychodzące webhooki cyklu życia podpisywane za pomocą HMAC dla zdarzeń sesji, tur i narzędzi.⁵⁵
• Cytowania oparte na źródłach. Nowy skill z trybem weryfikacji faktów.⁵⁵
• Fala usprawnień CLI dla zaawansowanych użytkowników. !command natychmiast wykonuje polecenie powłoki bez zużywania tury modelu; /init skanuje projekt i zapisuje lub aktualizuje plik AGENTS.md; /diff wyświetla z dowolnego interfejsu zmiany przygotowane do commitu, wszystkie zmiany lub zmiany w sesji; /context pokazuje, co zajmuje okno kontekstu; /focus udostępnia widok ze zredukowaną ilością danych wyjściowych i możliwością przywracania ukrytych wierszy; Ctrl+S odkłada częściowo napisany prompt. hermes import-agent przenosi konfigurację Claude Code lub Codex CLI za pomocą jednego polecenia.⁵⁵
• Rozszerzenia interfejsu obsługi sekretów. Źródło sekretów korzystające z pomocniczego polecenia, które współpracuje z każdym sejfem, obracanie tokenów jednym poleceniem z praktycznymi komunikatami o błędach podczas uruchamiania, opcjonalna szyfrowana awaryjna pamięć podręczna dla Bitwarden, klucze wstrzykiwane z sejfu i ograniczone do katalogu domowego danego profile oraz zgodność SecretRef ${env:VAR} między config.yaml a konfiguracją MCP. Opisany poniżej model uwierzytelniania oparty na trzech ścieżkach pozostaje bez zmian.⁵⁵
• Szybszy ciepły start. Czas zimnego startu hermes -w skrócono z około 14 s do 1,8 s.⁵⁵
• Aplikacja desktopowa stała się platformą. Artifacts z wersjonowanymi kartami i podglądem na żywo działającym w piaskownicy, Plugin SDK z Kanban jako pierwszym pluginem desktopowym, globalny skrót klawiszowy do szybkiego wprowadzania danych, wiele okien GUI, tryb zdalnego backendu SSH oraz natywne logowanie zgodne z RFC 8252.⁵⁵

Wydania zbiorcze v0.20.3, v0.20.4, v0.20.5 i v0.20.6 (17–27 sierpnia)

Po v0.20.0 projekt rozwijał się w rytmie często publikowanych, otagowanych wydań zbiorczych, które wprowadzały więcej niż tylko poprawki stabilizacyjne. We wszystkich czterech przypadkach opracowane informacje odłożono w ten sam sposób — każde wydanie zapowiadało, że „pełne, opracowane informacje o wydaniach z tego okresu zostaną opublikowane wraz z v0.21.0” — a v0.21.0 już je dostarczyło: sekcja Co nowego w v0.21.0 powyżej stanowi opracowany zapis całego tego okresu (wydanie potwierdza, że okresy te „zostały tutaj w pełni udokumentowane”). Poniższe bloki pozostają ówczesnym zapisem poszczególnych tagów — wskazują, które zmiany trafiły do każdego z nich, podczas gdy opracowane informacje przedstawiają je łącznie.^54233035

v0.20.3 (około 250 commitów i 125 PR-ów od v0.20.2):

• Migracja SDK do MCP 2.x z obsługą bezstanowego protokołu z 2026-07-28. Hermes przechodzi na bieżącą generację SDK dla MCP i obsługuje bezstanową wersję protokołu.⁵⁴
• Bot Mode jest dostarczany jako dołączony plugin (hermes-bots) zawierający podstawowy protokół współpracy zespołowej.⁵⁴
• Plugin dostawcy CommandCode dołącza do katalogu dostawców.⁵⁴
• Kontrakty środowiska wykonawczego Cua Driver 0.20 do obsługi komputera oraz wzmocniona kontrola własności środowiska wykonawczego procesu podrzędnego Python (izolacja PYTHONHOME/PYTHONPATH).⁵⁴
• Niezawodność: samonaprawianie harmonogramu cron (odzyskiwanie po EMFILE, uzgadnianie nieaktualnych roszczeń i ponowne uzbrajanie zablokowanych zadań), poprawki zapobiegające utracie danych podczas przekazywania sesji, samonaprawianie połączenia aplikacji desktopowej ze zdalnym gateway oraz fala portów z ekosystemu (skanowanie bezpieczeństwa przy instalacji pluginów, /worktree, zachowywanie ręcznych zmian przez /rollback, odczyt plików UTF-16).⁵⁴

v0.20.4 (około 146 commitów i 74 PR-y od v0.20.3):

• Szklana powierzchnia aplikacji desktopowej: matowe szkło i efekty przezroczystości wraz z selektorem oszronienia oraz wstępnym wyborem dla macOS.⁵⁴
• Pasek boczny z kartami SESSIONS|BOTS, umożliwiający ukrywanie i odkrywanie poszczególnych botów, a także poprawki czatów grupowych w Bot Mode (długotrwałe tury członków, renderowanie Markdown i routing między komputerami).⁵⁴
• Doradcze skanowanie NVIDIA SkillEvaluator Tier 1 podczas instalowania skill — podczas instalacji skill przeprowadzane są kontrole licencji i bezpieczeństwa.⁵⁴
• Wzmocnienie wysyłania multimediów przez cron (konfigurowalny limit czasu, załączniki w uruchomieniach ręcznych, ujawnianie pominiętych wywołań), poprawki SessionDB dotyczące wątku pętli zdarzeń i konfliktów dostępu, rzetelne informowanie przez hermes update o zaparkowanych gałęziach oraz natywne powiadomienia systemowe Kanban.⁵⁴

v0.20.5 (około 746 commitów i 323 PR-y od v0.20.4):

• Warstwa internetowa bez kluczy: wyszukiwanie w internecie działa w nowych instalacjach bez kluczy API — wykorzystuje bezpłatną rotację między 5 dostawcami z przełączaniem awaryjnym w pierścieniu.²³
• Fala usprawnień CLI: selektor /model z wyszukiwaniem przybliżonym, paleta poleceń Ctrl+P oraz bogatszy widok /status.²³
• Bot Mode dojrzewa: wątki w pokojach grupowych, zwijane podsumowania rozmów, awatary z twarzami w stylu blob oraz załączniki PDF i plikowe obsługujące przeciąganie i upuszczanie.²³
• Narzędzia do zarządzania flotą i worktree: potwierdzenia hermes update, hermes update --plan (informacje o wydaniu określają to jako „weryfikację --plan floty”; flaga należy do hermes update, a nie do polecenia fleet, i zgodnie z pomocą parsera „wyświetli plan aktualizacji i zakończy działanie bez wprowadzania zmian”) oraz hermes worktree list/prune.²³²⁷
• Zadania cron otrzymują trwałą pamięć oraz indywidualny poziom intensywności rozumowania, a także mechanizmy dyscypliny wykonania i zabezpieczenia przed zatrzymaniem środowiska wykonawczego opracowane na podstawie wyników ewaluacji Composio, doprecyzowywanie za pomocą wielu pytań, niewymagającego opencode dostawcę bez uwierzytelniania oraz usprawnienia wydajności aplikacji desktopowej (hydratacja Bot Mode z priorytetem dla pierwszego renderowania, React Compiler w obu mechanizmach renderujących).²³

v0.20.6 (tag v2026.8.27 z 27 sierpnia — około 1 313 commitów i 525 PR-ów od v0.20.5):

Wydanie określa się wprost jako „wydanie poprawkowe. Ten tag zbiera około 525 PR-ów scalonych od v0.20.5 w stabilne, otagowane wydanie dla dalszych użytkowników”, a jego opis podaje, że okres ten obejmuje około 1 313 commitów w mniej więcej 1 557 plikach (+177 113 / −21 682) — około 525 scalonych PR-ów.³⁰ Najważniejsze elementy tego opisu:

• Przeglądanie z użyciem rzeczywistego profile za zgodą użytkownika — lokalna przeglądarka może korzystać z domyślnego profile Chromium, a w systemie Windows dostępny jest proces zamykania wymagający zatwierdzenia.³⁰
• Przeglądarka w aplikacji desktopowej otrzymuje własne okno systemowe, a ponadto zarządzany mechanizm zdalnych aktualizacji SSH i panel profile floty.³⁰
• Rozszerzenie katalogu zdalnych MCP: ponad 50 aktywnych, zweryfikowanych serwerów hostowanych przez dostawców, w tym Cloudflare, Grafana Cloud, Better Stack i Railway.³⁰
• Opcjonalne szyfrowanie przechowywanych sekretów za pomocą systemowego pęku kluczy — koniec z monitami macOS Keychain przy każdym uruchomieniu.³⁰
• Nowe modele w selektorach: GLM-5.3-Flash, bezpłatny MiniMax M3 oraz wideo MiniMax H3 Max.³⁰
• Buforowanie wyników web_search/web_extract z TTL oraz wielozapytaniowe tool_search z redukcją wyrazów do rdzenia.³⁰
• Kompresja lean-tail jest teraz domyślna — sekcja Kompresja kontekstu poniżej opisuje konfigurację obowiązującą w chwili utworzenia tagu.³⁰³¹
• Backendy terminala stały się wymienne — patrz Backendy terminala.³⁰³²
• Rzetelność aktualizatora i zarządzania flotą: aktualizatory wstrzymują gateway przez gniazdo sterujące zamiast wymuszać zakończenie całego drzewa procesów, a instalacje zarządzane za pomocą obrazów lub pakietów odrzucają niebezpieczne aktualizacje w miejscu.³⁰
• Trwałe potwierdzenia incydentów cron z czytelniejszymi błędami niezgodności wersji kodu, kontrola rozwijania podglądu linków w Slack oraz współdzielone tożsamości kontenerów Docker.³⁰

Sposób aktualizacji pozostaje bez zmian: hermes update w istniejącej instalacji albo instalator powłoki w przypadku nowej.⁵⁴²³³⁰

Co nowego w v0.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: podstawą tego wydania jest błyskawiczna responsywność, a czas do pojawienia się pierwszego tokenu w pierwszej turze skrócono o około 80% na każdej platformie. Uzupełniają ją rozliczenia w terminalu, menedżery haseł jako źródła sekretów, domyślnie inteligentne zatwierdzanie, obserwowalne subagenty i odporne na awarie dostarczanie odpowiedzi. Okres od wydania v0.18.0 był najbardziej intensywny 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.⁵⁶

• Pierwszy token wszędzie około 80% szybciej. Czas od wysłania pierwszego żądania po uruchomieniu 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 Discorda usunięto ze ścieżki krytycznej, test Ollama jest pomijany w przypadku znanych dostawców innych niż Ollama, a operacje blokujące usunięto z inicjalizacji agenta. Zoptymalizowano również 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, a nie po każdym wierszu.⁵⁶
• Fala usprawnień renderowania w aplikacji komputerowej i TUI. Aplikacja komputerowa przeszła optymalizację szybkości obejmującą około 20 PR-ów: 14-krotnie zmniejszono zużycie CPU przez moduł dzielący strumieniowany Markdown dzięki przyrostowej analizie bloków, zwirtualizowano różnice w panelu przeglądu, przyspieszono przełączanie sesji przy obszernych transkrypcjach oraz wyeliminowano ponowne renderowanie paska bocznego i wierszy narzędzi po każdym tokenie. TUI renderuje teraz strumieniowany Markdown przyrostowo, blok po bloku.⁵⁶
• Instalacje przez pip i Homebrew są przestarzałe. Obie metody oznaczono jako „nieobsługiwane starsze sposoby instalacji” i zaplanowano ich usunięcie. Do usunięcia doszło już w v0.20.0 — kanały brew oraz pip/PyPI z pakietami wheel zostały wycofane, a obsługiwanymi kanałami pozostały instalator powłoki, Docker i Nix.⁵⁶⁵⁵
• Sekrety mogą pochodzić z menedżera haseł. Nowy, rozszerzalny interfejs SecretSource pobiera sekrety z Bitwarden i 1Password (odwołania op://) podczas wczytywania, umożliwiając jednoczesne korzystanie z wielu sejfów, deterministyczne ustalanie pierwszeństwa, ostrzeżenia o konfliktach i śledzenie pochodzenia każdej zmiennej — klucze API nie muszą już znajdować się w jawnym pliku .env. Obsługę kolejnych dostawców sejfów można dodawać w formie wtyczek.⁵⁶
• Inteligentne zatwierdzanie jest teraz domyślne. Gdy Hermes chce uruchomić oznaczone polecenie, niezależny recenzent LLM ocenia je, zamiast za każdym razem prosić o zgodę — każda decyzja dotyczy wyłącznie tego konkretnego polecenia. 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ć działanie, a akcja zatwierdzania pre_tool_call wtyczki (ponownie wprowadzona wraz z kluczami reguł) przekazuje wywołanie narzędzia do akceptacji przez człowieka.⁵⁶
• Rozliczenia w terminalu: /subscription i /topup. Plan Nous Portal można obsługiwać bez opuszczania terminala — sprawdzać plan i pozostały limit, dokładnie podejrzeć koszt przejścia na wyższy plan lub termin wejścia w życie przejścia na niższy, 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ę subagentów, a ukończona odpowiedź nigdy nie przepadnie. Wywołania delegate_task zwracają pliki transkrypcji na żywo, które można śledzić poleceniem tail -f natychmiast po uruchomieniu subagentów — każde wywołanie narzędzia, wynik i strumieniowana odpowiedź trafiają do osobnego, czytelnego dla człowieka dziennika każdego procesu potomnego. Informacje o zakończeniu delegowanych zadań działających w tle pozostają trwałe po ponownym uruchomieniu, a końcowe odpowiedzi gateway są zapisywane w rejestrze zobowiązań dostarczenia w state.db i dostarczane ponownie przy następnym uruchomieniu, jeśli gateway przestanie działać w trakcie 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 z jednego tokenu bota może kierować określone gildie, 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. Indeks routingu przeniesiono do state.db; sessions.json jest teraz opcjonalną starszą kopią lustrzaną.⁵⁶
• Fala nowych dostawców i modeli. Fireworks AI otrzymał pełnoprawną obsługę (szacowanie kosztów i 2. miejsce na liście wyboru dostawcy), podobnie jak DeepInfra i Upstage Solar. W katalogach pojawiły się GPT-5.6 (Sol/Terra/Luna + Pro, z pełną integracją), grok-4.5 (GA), kimi-k3 (wycofano kimi-k2.x) oraz w pełni zintegrowany Claude Sonnet 5. Flaga enabled: false ustawiana osobno dla każdego dostawcy oraz konfiguracja excluded_providers usuwają nieużywanych dostawców z list wyboru /model i mechanizmu rozpoznawania.⁵⁶
• Poziom intensywności rozumowania staje się regulowany. Na wszystkich powierzchniach wprowadzono nowe poziomy intensywności max i ultra, wraz z nadpisaniami dla poszczególnych modeli w konfiguracji, osobnym poziomem dla każdego miejsca w ustawieniach MoA (doradcy analizują dogłębnie, syntezator pozostaje szybki), poziomem dla każdego zadania modeli pomocniczych oraz obowiązującym w ramach sesji poleceniem /reasoning w CLI.⁵⁶
• Zakres funkcji CLI i MCP. hermes sessions export eksportuje dane w formatach Markdown, Quarto, HTML, samych promptów i śladów Hugging Face, z opcjonalnym oczyszczaniem przez --redact; /model --once pozwala jednorazowo zmienić model na jedną turę; wywołania slash-skills można łączyć (/skill-a /skill-b do XYZ); --safe-mode ułatwia rozwiązywanie problemów; hermes config get/unset uzupełniają funkcje zarządzania konfiguracją; hermes serve staje się prawdziwym backendem bez interfejsu; a narzędzia MCP przyjmują konwencję nazewnictwa mcp__server__tool.⁵⁶

Przy aktualizacji z wersji v0.18.x należy przede wszystkim zwrócić uwagę na 2 zmiany: instalacja przez pip lub Homebrew jest teraz oznaczana ostrzeżeniem jako nieobsługiwany starszy sposób instalacji (należy przejść na instalator uruchamiany jednym poleceniem), a max_async_children jest przestarzałe na rzecz ujednoliconych limitów współbieżności delegowania. Wszystkie pozostałe zmiany mają charakter rozszerzający — najważniejszymi powodami aktualizacji są skrócenie opóźnienia pierwszej tury o około 80%, inteligentne zatwierdzanie oraz rejestr dostarczania, dzięki któremu ukończone odpowiedzi są odporne na awarie.

Co nowego w 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 jedynie deklarować sukces, a przebieg zespołowego rozumowania można rzeczywiście prześledzić. Wydanie zamyka również wszystkie zaległości 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 wybierać jak każdy inny model we wszystkich interfejsach, a zespołowe rozumowanie jest widoczne: pełna odpowiedź każdego modelu referencyjnego jest wyświetlana w osobnym, opisanym bloku z transmisją odpowiedzi na żywo — można obserwować tok rozumowania zespołu, zamiast otrzymywać nieprzejrzystą, scaloną odpowiedź.²²
• Kontrakty ukończenia dla /goal. Przed zgłoszeniem ukończenia celu agent weryfikuje własną pracę, uruchamiając mechanizmy kontrolne projektu, zamiast jedynie deklarować sukces — stosuje więc osąd również wobec siebie.²²
• /learn — przekształcanie dowolnego opisu w skill. Proces można zamienić w skill wielokrotnego użytku, po prostu go opisując; wygenerowane skills automatycznie zachowują zgodność z konwencjami CONTRIBUTING.md danego repozytorium.²²
• Oś czasu /journey. Wizualna historia zmian pamięci i skills w czasie, z możliwością edycji, a także 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 rozrósł się do całej floty.²²
• Projekty w aplikacji komputerowej. Pełnoprawne projekty programistyczne z modelem organizacji opartym na projekcie, repozytorium i lane.²²
• Gateway skalowany do zera. Gateways mogą przechodzić w stan uśpienia w okresach bezczynności i koordynować wygaszanie w celu zapewnienia płynnych wdrożeń — ma to znaczenie dla wszystkich osób korzystających 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, umożliwiając wygodne tworzenie wielowierszowych promptów zamiast zmagania się z pojedynczym wierszem wprowadzania.²²

Przy aktualizacji z wersji v0.17.x żadna z tych zmian nie narusza zgodności z CLI. Najważniejsze powody aktualizacji to kontrakty ukończenia (cele, które same się weryfikują), pełnoprawne MoA z możliwym do prześledzenia działaniem zespołu oraz /learn do rejestrowania skills.

Co nowego w v0.17.0 (wydanie Reach)

Nazwa Hermes Agent v0.17.0 (tag v2026.6.19, 19 czerwca 2026) nawiązuje do rozszerzonego zasięgu agenta — nowych kanałów komunikacji, nowych dostawców modeli oraz większych możliwości sterowania aplikacją komputerową i panelem administracyjnym. Jest to wydanie rozszerzające v0.16.x; interfejs CLI pozostaje bez zmian.²¹

• Nowe kanały komunikacji. iMessage działa teraz bez pośredniczącego komputera Mac za pośrednictwem 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 pośredniczącego; SimpleX zyskuje grupy, natywne załączniki, grupowanie tekstu w partie oraz automatyczne akceptowanie; natomiast Raft dołącza jako dołączona wtyczka platformowa z kanałem wybudzania chroniącym prywatność na poziomie kontraktu.²¹
• 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 korzystają teraz ze współczesnego kontraktu rozumowania (nigdy nie wysyłają pola reasoning).²¹
• Aplikacja komputerowa i panel administracyjny. W aplikacji komputerowej dodano subagentów działających w tle wraz z transmitującymi na żywo „oknami obserwacji” aktywności delegowanej (delegate_task(background=true)), selektor modelu w edytorze, konfigurowalne skróty klawiaturowe, natywne powiadomienia systemowe, osobne wersje robocze edytora dla każdego wątku, motywy z VS Code Marketplace oraz interfejs w języku japońskim i chińskim tradycyjnym. Panel administracyjny zyskuje kompletny kreator profili (modele/skills/MCP bez edytowania config.yaml), globalny przełącznik profili, przebudowane Skills Hub ze skanowaniem zabezpieczeń, Automation Blueprints (parametryzowane szablony dostępne przez formularz, polecenie ukośnikowe, konwersację i dokumentację) oraz bezpieczne logowanie, które za bramą OAuth zwraca kod 401.²¹
• Skills i narzędzia. Narzędzie image_generate może teraz edytować i przekształcać obraz źródłowy, a nie tylko tworzyć nowy od podstaw — u każdego obsługiwanego dostawcy obrazów; narzędzie memory zyskało tablicę operations, która umożliwia atomowe, zbiorcze dodawanie, zastępowanie i usuwanie w jednym wywołaniu; nowy skill simplify-code przeprowadza równoległy, trzyagentowy przegląd i porządkowanie kodu, kontrolowane poziomem ryzyka opartym na zasadzie Chesterton’s Fence; natomiast wartość logiczna write_approval zastępuje trójstanowe ustawienie write_mode.²¹
• Architektura. Subagenci działający w tle natychmiast zwracają uchwyt, a następnie wprowadzają swój wynik jako nową turę; procedura pozyskiwania informacji MCP pozwala uzyskać potwierdzenie w trakcie wywołania narzędzia, a narzędzia MCP, które połączą się później, są udostępniane między turami (bez naruszania bezpieczeństwa pamięci podręcznej); cron staje się rozszerzalnym CronScheduler z zarządzanym dostawcą cron Chronos; nowy zakres Managed (/etc/hermes) pozwala administratorowi narzucić użytkownikom niezmienną konfigurację, a przekaźnik Gateway-Gateway umożliwia tworzenie topologii obejmujących wiele gateway.²¹
• Nowe polecenia. /version, /billing (interaktywne rozliczenia w terminalu), hermes photon login (uwierzytelnianie iMessage) oraz hermes curator run --consolidate — konsolidacja wymaga teraz wyraźnego włączenia, dzięki czemu rutynowe porządkowanie w tle nie zużywa tokenów.²¹
• Bezpieczeństwo. W v0.17.0 usunięto możliwość obejścia listy blokad przez sekwencje sterujące powłoki, wprowadzono bezpieczne odrzucanie żądań przy braku modułów zatwierdzania i adapterów gateway korzystających z własnych zasad, oczyszczanie środowiska podprocesów skryptów zadań cron, maskowanie sekretów w zrzutach debugowania żądań, sprawdzanie konfiguracji stdio MCP pod kątem wzorców eksfiltracji oraz zaktualizowano urllib3 i PyJWT w celu usunięcia podatności CVE.²¹

Przejście z v0.16.x nie powoduje żadnych niezgodności w CLI; wydanie dodaje nowe kanały, modele i interfejsy wokół tego samego agenta. Najważniejszymi powodami aktualizacji są iMessage niewymagający przekaźnika, oficjalne adaptery WhatsApp oraz administracyjny zakres Managed.

Co nowego w v0.16.0 (wydanie Surface)

Nazwa Hermes Agent v0.16.0 (tag v2026.6.5, 5 czerwca 2026) nawiązuje do nowych interfejsów udostępnionych agentowi zaprojektowanemu przede wszystkim z myślą o CLI. Najważniejsza zmiana polega na tym, że Hermes nie jest już ograniczony do terminala.²⁰

• Natywna aplikacja komputerowa. Hermes Desktop to nowa aplikacja Electron dla systemów macOS, Linux i Windows, oferująca instalację jednym kliknięciem oraz automatyczne aktualizacje z poziomu aplikacji. Udostępnia okno czatu z transmisją odpowiedzi, 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 bezpieczne WebSocket, uwierzytelniając się za pomocą OAuth albo nazwy użytkownika i hasła, a także obsługuje osobne hosty zdalne dla poszczególnych profili oraz równoczesne sesje wielu profili połączone międzyprofilowymi odwołaniami @session. Interfejs aplikacji zawiera również pełne tłumaczenie na uproszczony język chiński (简体中文), zaimplementowane za pomocą warstwy i18n z kontrolą typów (display.language; język angielski pozostaje domyślny).²⁰
• Panel administracyjny w przeglądarce. Lokalny internetowy panel administracyjny rozbudowano z widoku stanu do kompletnego interfejsu zarządzania: katalogu MCP z przełącznikami włączania i wyłączania, zarządzania danymi uwierzytelniającymi, tworzenia webhooków i hooków, konfiguracji pamięci, sterowania gateway oraz strony System z kontrolą poprzedzającą aktualizację i funkcją Debug Share uruchamianą jednym kliknięciem. Nowa strona Channels pozwala konfigurować w przeglądarce wszystkie platformy komunikacyjne gateway (Telegram, Discord, Slack i pozostałe). Uwierzytelnianie jest teraz rozszerzalne: obsługuje logowanie nazwą użytkownika i hasłem, ogólnego samodzielnie hostowanego dostawcę OIDC, polecenie hermes dashboard register służące do rejestrowania samodzielnie hostowanego klienta OAuth oraz rotację sesji za pomocą tokenów odświeżania.²⁰
• Nowe polecenia CLI i polecenia ukośnikowe. /undo [N] cofa ostatnie N tur użytkownika, korzystając z wstępnego wypełniania i miękkiego usuwania; działa w CLI, TUI oraz na platformach komunikacyjnych. Dodano konfigurowalny interfejs domyślny (cli lub tui) z możliwością zastąpienia go opcją --cli; TUI zyskuje ujednolicone polecenie /model i nakładkę Sessions. hermes portal to czytelny dla człowieka alias procesu wdrażania Nous Portal, obejmującego nowe ścieżki pierwszego uruchomienia Quick Setup i Full Setup; dodano również 2 narzędzia diagnostyczne: hermes prompt-size i 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 obsługuje teraz wyszukiwanie przybliżone we wszystkich interfejsach, dostawcy z wieloma punktami końcowymi są grupowani w jednym wierszu, a katalog jest odświeżany co godzinę zamiast raz dziennie.²⁰ (Od tego czasu w v0.21.1 ponownie zmieniono częstotliwość: zdalne katalogi selektora są odświeżane co 20 minut, model_catalog.ttl_minutes.⁴⁶)
• Odchudzone skills i stopniowe ujawnianie. Z domyślnego zestawu skills usunięto pozycje zbędne i nieaktywne (Spotify przeniesiono do natywnej wtyczki, Linear do hermes mcp install linear, a kilka nieaktualnych pozycji usunięto), więcej z nich przeniesiono do kategorii opcjonalnych oraz dodano warunek istotności environments: w metadanych frontmatter (kanban/docker/s6), który ukrywa zależne od kontekstu skills w indeksie do czasu ich zażądania. NVIDIA/skills jest teraz domyślnym zaufanym źródłem Skills Hub obok OpenAI, Anthropic i HuggingFace. Narzędzia MCP i narzędzia wtyczek zyskały stopniowe (zakresowe) ujawnianie, a błąd MCP, który fałszywie zgłaszał pomyślne uwierzytelnienie OAuth, mimo że nie uzyskano tokenu, został naprawiony.²⁰
• Bezpieczeństwo. W v0.16.0 przypięto poprawioną wersję Starlette (≥1.0.1) ze względu na CVE-2026-48710 (BadHost), przeniesiono sprawdzanie adresów URL pod kątem SSRF poza pętlę zdarzeń w ścieżkach asynchronicznych, usunięto token okaziciela Bedrock inference ze środowiska podprocesów, dodano bws_cache.json do zabezpieczenia odczytu plików, uwzględniono docker restart/stop/kill na liście niebezpiecznych wzorców oraz oczyszczono zatwierdzoną zawartość skills z niewidocznych znaków Unicode. Wydanie usunęło 2 problemy P0 i 62 problemy P1, w tym 16 oznaczonych jako związane z bezpieczeństwem.²⁰

Przejście z v0.15.x nie wprowadza żadnej niezgodnej zmiany w samym CLI; wydanie dodaje interfejsy i dostawców wokół tego samego agenta. Aplikacja komputerowa i panel administracyjny są głównymi powodami aktualizacji, jeśli Hermes ma być udostępniany użytkownikom niekorzystającym z terminala albo zdalny gateway ma być zarządzany z przeglądarki.

Co nowego w v0.14.0 (wydanie Foundation)

W v0.14.0 nie chodzi o jedną sztandarową funkcję, lecz o uproszczenie konfiguracji i rozszerzenie środowisk, w których może działać Hermes.¹⁹ Najważniejsze zmiany operacyjne:

• Lżejsza instalacja i szybsze uruchamianie. Polecenie pip install hermes-agent instaluje pakiet z PyPI, rozbudowane adaptery są instalowane dopiero przy pierwszym użyciu, a odroczenie wystarczającej części pracy podczas uruchamiania skraca zimny start o około 19 sekund. (Od tego czasu w v0.19.0 instalacje przez pip uznano za przestarzałe — zob. Instalacja.)
• Subskrypcje mogą stać się lokalnymi punktami końcowymi API. Polecenie hermes proxy przekształca dostawców opartych na OAuth, takich jak Claude Pro, ChatGPT Pro i SuperGrok, w lokalny punkt końcowy zgodny z OpenAI dla narzędzi takich jak Codex, Aider, Cline i Continue.
• Gateway zyskuje większy zasięg. LINE i SimpleX Chat dołączają do gateway (tabela porównawcza platform w dokumentacji wymienia 28 platform w tagu v2026.8.31; sekcja Messaging Gateway wyjaśnia, co obejmuje ta liczba), Microsoft Teams jest zintegrowany od początku do końca, domyślnie włączono uzupełnianie historii Discord, a monity clarify w Telegram i Discord korzystają teraz z natywnych przycisków.
• Lepsza weryfikacja podczas zapisu. Po wprowadzeniu zmian Hermes może przed następną turą wyświetlić podsumowania modyfikacji plików dla każdej tury oraz diagnostykę semantyczną serwera językowego, co przybliża go do pracy agenta opartej na dowodach.
• Szersze możliwości aplikacji komputerowej i narzędzi multimedialnych. computer_use działa za pośrednictwem cua-driver z dostawcami innymi niż Anthropic, video_generate ujednolicono za rozszerzalnymi mechanizmami wykonawczymi, a vision_analyze przesyła surowe piksele do modeli, które rzeczywiście obsługują analizę obrazu.

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://hermes-agent.nousresearch.com/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 instalacje starszego typu” — gdy Hermes wykryje taką instalację, w każdym interfejsie wyświetla ostrzeżenie (bez blokowania działania), a zaprzestanie publikowania w PyPI i Homebrew jest planowane. W przypadku instalacji przez pip lub brew należy przejść na powyższy instalator.⁵⁶

Działa w systemach Linux, macOS, WSL2 oraz Android/Termux (instalator automatycznie wykrywa Termux i przełącza się na przetestowany pakiet dla Androida).⁷ Natywna wersja dla Windows jest obecnie platformą Tier 1, a nie wczesną wersją beta udostępnioną w v0.14.0 — można ją zainstalować za pomocą iex (irm https://hermes-agent.nousresearch.com/install.ps1). Dokumentacja wyraźnie wskazuje jedno zastrzeżenie: w przypadku macOS obsługiwane są wyłącznie urządzenia z Apple Silicon, a komputery Mac z procesorami Intel nie są obsługiwane.⁵⁵ Historycznie wersja v0.14.0 wprowadziła natywną obsługę Windows we wczesnej fazie beta za pośrednictwem instalatora PowerShell, jednak do zastosowań produkcyjnych WSL2 nadal pozostaje bezpieczniejszym zaleceniem, dopóki natywna wersja dla 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 przygotowuje Python 3.11 za pomocą uv (bez konieczności używania sudo), Node.js 26 (do automatyzacji przeglądarki i mostu WhatsApp), ripgrep oraz ffmpeg. Od wersji v0.20.0 Node 26 jest bezwzględnym minimum — instalator odrzuca każdą starszą wersję i instaluje wersję Node zarządzaną przez Hermes.⁵⁵⁷

Weryfikacja instalacji

hermes --version    # Check version (global flag; there is no `version` subcommand)
hermes doctor       # Diagnose config/dependency issues
hermes status       # Show current configuration + auth state
hermes dump         # Copy-pasteable setup summary for debugging

hermes doctor dokładnie wskazuje, czego brakuje i jak to naprawić.⁷ hermes dump to polecenie diagnostyczne, którego wynik należy wkleić do zgłoszenia w GitHub lub wątku na Discord, prosząc o pomoc — jest to tekstowe podsumowanie całej konfiguracji, w którym dane poufne są zamaskowane.⁸

Instalacja ręczna

Jeśli potrzebna jest pełna kontrola — niestandardowa wersja Python, konkretne dodatki lub integracja z Nix/NixOS — procedurę ręczną 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 — korzysta z pip wraz z plikiem ograniczeń, a nie z 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 wheel ctranslate2, niepublikowanych dla Androida.⁷

Uwierzytelnianie i dostawcy

W tagu v2026.9.7 plik hermes_cli/models_catalog_static.py zawiera w wierszu 311 39 statycznych wpisów CANONICAL_PROVIDERS (w wyniku dekompozycji z września 2026 roku lista została przeniesiona z hermes_cli/models.py; same wpisy nie uległy zmianie i nadal obejmują dodany w wersji v0.21.0 wpis tencent-tokenplan) i automatycznie rozszerza tę listę na podstawie plugins/model-providers/ (39 dołączonych folderów; dziewięć z nich — actual, alibaba-coding-plan, commandcode, deepinfra, meta-ai, nebius-token-factory, opencode-free, router, upstage — nie ma statycznego wpisu i zostaje uwzględnionych przez mechanizm automatycznego rozszerzania, ponieważ używają domyślnego typu uwierzytelniania api_key). Tabele na stronie dokumentacji poświęconej dostawcom obejmują 45 dostawców chmurowych i subskrypcyjnych oraz wiersz dotyczący niestandardowego punktu końcowego, a osobno opisano serwery lokalne i samodzielnie hostowane (Ollama, vLLM, SGLang, llama.cpp, LM Studio, LiteLLM, ClawRouter oraz dowolny punkt końcowy zgodny z OpenAI).²⁶ W tagu v2026.9.24 statyczna lista nadal zawiera 39 wpisów, natomiast plugins/model-providers/ obejmuje 38 folderów: niewymagający klucza dostawca opencode-free został usunięty 18 września, ponieważ bezpłatny plan OpenCode odrzuca obecnie anonimowy ruch pochodzący spoza własnego klienta.⁵³ Ponad tym funkcjonują niestandardowe punkty końcowe i trzy odrębne ścieżki uwierzytelniania. Poniżej przedstawiono pełny zakres możliwości uwierzytelniania, uporządkowany według ścieżek, aby ułatwić znalezienie wariantu odpowiadającego posiadanym danym dostępowym.

Trzy ścieżki uwierzytelniania

Każdy dostawca w Hermes korzysta z jednego z trzech wzorcó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 (oraz MiniMax China), Alibaba Cloud/DashScope, Kilo Code, OpenCode Zen, OpenCode Go, DeepSeek, Hugging Face, Google/Gemini i większość zewnętrznych dostawców.² Od wersji v0.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 i informacje o pochodzeniu poszczególnych zmiennych — .env pozostaje rozwiązaniem awaryjnym. (Jest to mechanizm odrębny od wprowadzonego w wersji v0.15.0 tokenu rozruchowego Bitwarden Secrets Manager, który pozwalał skonsolidować klucze dostawców za jednym tokenem; SecretSource zastępuje sam plik tekstowy, a kolejnych dostawców sejfów można dodawać jako wtyczki.)⁵⁶

Ścieżka 2 — OAuth przez hermes model lub hermes auth. Uruchamia przepływ z kodem urządzenia, otwiera przeglądarkę i zapisuje dane uwierzytelniające w ~/.hermes/auth.json (może również 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 punkt końcowy w config.yaml. Przeznaczona dla dowolnego API zgodnego z OpenAI — Ollama, vLLM, SGLang, llama.cpp, LM Studio, proxy LiteLLM, Together AI, Groq, Azure OpenAI lub własnego, samodzielnie hostowanego serwera. Konfigurację przeprowadza się jednorazowo przez hermes model → Custom endpoint, po czym zostaje ona zapisana w config.yaml.²

Pełna macierz dostawców

Macierz obejmuje dostawców uwzględnionych w tabelach na stronie dokumentacji wraz z dokładną procedurą konfiguracji każdego z nich; selektor w tym tagu zawiera więcej pozycji niż dokumentacja (patrz liczba powyżej), a każdy punkt końcowy zgodny z OpenAI można obsłużyć za pomocą wiersza dotyczącego niestandardowego punktu końcowego.²²⁶

Anthropic: trzy metody uwierzytelniania

Anthropic wymaga osobnej sekcji, ponieważ Hermes obsługuje trzy różne sposoby dostępu do Claude, a wybór właściwego ma znaczenie. Zgodnie z dokumentacją projektu źródłowego:²

# 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 Anthropic OAuth za pomocą hermes model Hermes w pierwszej kolejności korzysta z własnego magazynu poświadczeń Claude Code, zamiast kopiować token do ~/.hermes/.env. Dzięki temu poświadczenia Claude korzystające z OAuth zachowują możliwość odświeżania.² Jeśli Claude Code jest już używany na tym samym komputerze, jest to najprostsze rozwiązanie.

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

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

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

GitHub Copilot: dwa tryby

Copilot jest obsługiwany w dwóch trybach: bezpośredniego API Copilot (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ą projektu źródłowego 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 OAuth za pomocą hermes model

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

Chińscy providerzy AI (pełne wsparcie)

Hermes ma wbudowane wsparcie dla z.ai/GLM, Kimi/Moonshot, MiniMax (endpointy globalne i chińskie) oraz Alibaba Cloud z dedykowanymi identyfikatorami provideró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 nadpisać 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 providera z.ai/GLM Hermes sprawdza wiele endpointów (globalnych, chińskich i przeznaczonych do programowania), 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 pamięć podręczną promptów. Gdy bazowy adres URL zawiera x.ai, Hermes wysyła nagłówek x-grok-conv-id z każdym żądaniem, aby w ramach sesji konwersacji kierować je do tego samego serwera i ponownie wykorzystywać zapisane w pamięci podręcznej prompty systemowe oraz historię.² Działa automatycznie; konfiguracja nie jest wymagana.

Polecenie hermes auth

hermes auth to polecenie do zarządzania pulami poświadczeń i poświadczeniami 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 poświadczeń umożliwiają rotację wielu kluczy API lub tokenów OAuth dla tego samego providera — przydaje się to do rozłożenia limitów żądań między wiele kluczy bez zmieniania kodu.⁶ Starsze polecenia hermes login / hermes logout zostały usunięte; zamiast nich należy używać hermes auth.⁶

Niestandardowe i samodzielnie hostowane endpointy

Hermes działa z każdym endpointem API zgodnym z OpenAI. Jeśli 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

Obie metody zapisują ustawienia w config.yaml, który jest jedynym źródłem prawdy dla głównego modelu, providera i bazowego adresu URL.² Starsze zmienne środowiskowe OPENAI_BASE_URL i LLM_MODEL nie są już odczytywane podczas konfigurowania głównego modelu — należy użyć hermes model albo bezpośrednio edytować config.yaml.² (OPENAI_BASE_URL + OPENAI_API_KEY nadal są honorowane jako mechanizm awaryjny dla pomocniczej ścieżki routingu provider: "main", dlatego nie należy usuwać ich 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 /v1/models API punktu końcowego i automatycznie wybiera model, jeśli załadowany jest dokładnie jeden — jest to przydatne w przypadku lokalnych serwerów obsługujących pojedynczy model.²

Lokalne serwery LLM (szablony konfiguracji)

Dokumentacja projektu zawiera kompletne instrukcje konfiguracji Ollama, vLLM, SGLang, llama.cpp i LM Studio. Poniżej przedstawiono najważniejsze polecenia, których faktycznie trzeba użyć. Każde z nich pozwala uruchomić działający punkt końcowy, z którym może się połączyć Hermes.²

Ollama — najprostszy sposób na lokalne uruchomienie, bez konieczności 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 związana z Ollama: Ollama domyślnie używa bardzo krótkich okien kontekstu (4096 tokenów przy mniej niż 24 GB pamięci VRAM). Należy je zwiększyć za pomocą OLLAMA_CONTEXT_LENGTH lub pliku Modelfile — interfejs API zgodny z OpenAI nie przyjmuje długości kontekstu od klienta, dlatego Hermes nie może jej ustawić.² Do zastosowań agentowych należy ustawić co najmniej 16–32 tys. tokenów.

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 flag --enable-auto-tool-choice i --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, umożliwiające ponowne wykorzystanie 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 związana z SGLang: Domyślna wartość max_tokens wynosi 128. Jeśli odpowiedzi są ucinane, należy ustawić --default-max-tokens na serwerze lub skonfigurować model.max_tokens w config.yaml.²

llama.cpp / llama-server — procesor 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

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

LM Studio — aplikacja komputerowa z interfejsem graficznym:

Należy uruchomić serwer w aplikacji LM Studio (karta Developer → Start Server) albo 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 związana z LM Studio: LM Studio odczytuje długość kontekstu z metadanych modelu, ale wiele modeli GGUF zgłasza wartość domyślną 2048 lub 4096. Długość kontekstu należy zawsze ustawić jawnie 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

W przypadku korzystania z wielu niestandardowych punktów końcowych (na przykład lokalnego serwera deweloperskiego i zdalnego serwera GPU) należy zdefiniować je w config.yaml jako nazwanych niestandardowych dostawców:²

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ą składni z trzema elementami:

/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 (v0.13.0+)

Wersja v0.13.0 wprowadza klasę abstrakcyjną ProviderProfile oraz katalog plugins/model-providers/, dzięki którym zewnętrznych dostawców inferencji można dodawać bez modyfikowania podstawowego kodu.¹⁸ Jeśli dostawca obsługuje tryb API zgodny z OpenAI, Anthropic lub Codex, można zaimplementować podklasę ProviderProfile, która deklaruje metodę 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 v0.13.0: zamiast edytować podstawowy kod w celu dodania dostawcy, udostępnia się plugin.

Lokalny serwer proxy zgodny z OpenAI (v0.14.0+)

hermes proxy udostępnia lokalny punkt końcowy zgodny z OpenAI, obsługiwany przez dostawcę OAuth, u którego Hermes jest już uwierzytelniony — Claude Pro, ChatGPT Pro, SuperGrok lub innego zgodnego, skonfigurowanego dostawcę.¹⁹ Dzięki temu narzędzia oczekujące interfejsu API w stylu OpenAI, w tym Codex CLI, Aider, Cline, Continue lub niestandardowe skrypty, mogą ponownie wykorzystać uwierzytelnianie Hermes powiązane z subskrypcją, bez osobnego klucza API. Serwer proxy należy traktować jako lokalną infrastrukturę deweloperską: świadomie wybrać adres nasłuchiwania, nie udostępniać go szeroko i uwzględnić warunki poszczególnych dostawców.

Wykrywanie długości kontekstu

Zgodnie z dokumentacją projektu często mylone są dwa ustawienia:²

• context_length — całkowite 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 korzysta z tej wartości, aby ustalić, kiedy skompresować historię.
• model.max_tokens — limit danych wyjściowych (maksymalna liczba tokenów, które model może wygenerować w jednej odpowiedzi). Nie ma związku z długością historii.

Jeśli mechanizm automatycznego wykrywania błędnie określa 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 rozstrzygania: nadpisanie w konfiguracji → ustawienie dla modelu u niestandardowego dostawcy → trwała pamięć podręczna → /models punktu końcowego → Anthropic /v1/models → API OpenRouter → Nous Portal → models.dev (rejestr utrzymywany przez społeczność, obejmujący ponad 3800 modeli) → wartości domyślne (128 tys.).² System uwzględnia dostawcę, dlatego ten sam model może mieć różne limity kontekstu zależnie od tego, kto go udostępnia (np. claude-opus-4.6 ma okno 1 mln tokenów bezpośrednio w Anthropic, ale 128 tys. w GitHub Copilot).²

Inteligentne kierowanie modeli: rotacja dostawców i mechanizm rezerwowy

Hermes nie ogranicza użytkownika do jednego modelu u jednego dostawcy. Inteligentne kierowanie modeli obejmuje mechanizmy decydujące o tym, który dostawca i model faktycznie obsłuży dane żądanie: pule danych uwierzytelniających rozkładają obciążenie między klucze, skonfigurowany model rezerwowy przejmuje obsługę w razie awarii modelu głównego, a opisane poniżej role pomocnicze kierują zadania poboczne do tańszych modeli, niezależnie od modelu głównego.²⁶ Te trzy elementy należy skonfigurować łącznie – od tego zależy, czy agent zatrzyma się po osiągnięciu limitu żądań, czy będzie kontynuować pracę.

Pule danych uwierzytelniających. Jeśli dla tego samego dostawcy dostępnych jest kilka kluczy API, strategię rotacji należy skonfigurować za pomocą hermes auth. Pozwala to rozłożyć limity żądań między wiele kluczy.⁶

Model rezerwowy. Należy skonfigurować zapasową parę provider:model, na którą Hermes automatycznie przełączy się w razie awarii modelu głównego (osiągnięcia limitów żądań, błędów serwera lub błędów 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ługiwani przez 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 korzysta z modeli „pomocniczych” do zadań pobocznych: analizy obrazów (widzenie), klasyfikowania zatwierdzeń niebezpiecznych poleceń, kompresji kontekstu, generowania tytułów sesji, wstawiania znaczników audio TTS, dopasowywania skill, wysyłania narzędzi MCP oraz obsługi rodziny komponentów specyfikujących i dekomponujących Kanban.⁴³⁴ Domyślnie (auxiliary.*.provider: "auto") każde zadanie pomocnicze jest wykonywane przez główny model czatu – tego samego dostawcę i model, które wybrano w hermes model. Dokumentacja wyraźnie wskazuje, że zastąpiło to poprzedni mechanizm automatycznego wykrywania taniego dostawcy: „Wcześniejsze wersje kierowały użytkowników agregatorów (OpenRouter, Nous Portal) do taniego, domyślnego modelu po stronie dostawcy. Było to zaskakujące… auto korzysta teraz z modelu głównego w przypadku wszystkich użytkowników, a ustawienia poszczególnych zadań w config.yaml nadal mają pierwszeństwo”.³⁴ Aby rozpocząć pracę, nie trzeba niczego konfigurować; wiąże się to jednak z wyższymi kosztami – w przypadku drogich modeli rozumujących zadania pomocnicze mogą generować znaczące wydatki, dlatego w razie potrzeby warto przypisać poszczególne zadania do tanich i szybkich modeli. Dwa dawne zadania pomocnicze w ogóle nie korzystają już z LLM: ekstrakcja treści internetowych („web_extract i migawki przeglądarki deterministycznie skracają długie treści i przechowują pełny tekst do stronicowania za pomocą read_file — bez udziału LLM”) oraz przeszukiwanie sesji (narzędzie o jednym formacie zwraca bezpośrednio zawartość bazy danych). Ich stare bloki auxiliary.web_extract.* i auxiliary.session_search.* usunięto z ustawień domyślnych — wartości pozostałe w istniejącym pliku config.yaml są „nieszkodliwymi pozostałościami i są ignorowane” — a w wersji oznaczonej tym tagiem w ustawieniach domyślnych nie ma również pozycji flush_memories.³⁴

Można skonfigurować model i dostawcę używane przez każde zadanie pomocnicze. Każda pozycja pomocnicza korzysta z tych samych ustawień: provider, model, base_url (oraz api_key, timeout, extra_body i osobnego dla każdego zadania ustawienia reasoning_effort).⁴³⁴

auxiliary:
  vision:                          # vision_analyze + browser screenshots
    provider: "auto"               # "auto" (= main model), "openrouter", "nous", "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: 120
    download_timeout: 30
  approval:                        # dangerous-command approval classifier
    provider: "auto"
    model: ""
    timeout: 30
  compression:                     # summarizer -- legacy compression.summary_* keys migrate here (config v17)
    provider: "auto"
    model: ""
    base_url: ""
    timeout: 120
  title_generation:                # auto-generated session titles after the first exchange
    enabled: true                  # set false to disable auto-titles
    provider: "auto"
    model: ""
    language: ""                   # empty follows the conversation; e.g. "English" pins titles to one language
  tts_audio_tags:    { provider: "auto", model: "" }  # Gemini 3.1 TTS hidden audio-tag insertion
  skills_hub:        { provider: "auto", model: "" }  # skill matching and search
  mcp:               { provider: "auto", model: "" }  # MCP tool dispatch
  triage_specifier:  { provider: "auto", model: "" }  # hermes kanban specify: rough one-liner into a concrete spec, promoted to todo
  kanban_decomposer: { provider: "auto", model: "" }  # hermes kanban decompose: triage task into a graph of child tasks routed to specialist profiles
  profile_describer: { provider: "auto", model: "" }  # hermes profile describe --auto: 1-2 sentence profile descriptions

Kolejne specjalistyczne pozycje mają taką samą strukturę — goal_judge (ocenia spełnienie kontraktu /goal), curator (odgałęzienie przeglądu użycia skill), background_review (odgałęzienie samodoskonalenia uruchamiane po turze), review (subagent recenzujący dla /review), moa_reference i moa_aggregator (Mixture-of-Agents), memory_query_rewrite oraz monitor — a ręczna edycja YAML nie jest w ogóle konieczna: wystarczy uruchomić hermes model i wybrać opcję „Configure auxiliary models”, aby skorzystać z interaktywnego wyboru osobno dla każdego zadania.³⁴

Opcja dostawcy "main" oznacza „użyj dostawcy, z którego korzysta mój główny agent” — jest prawidłowa wyłącznie wewnątrz auxiliary:, compression: oraz głównych wpisów rezerwowych (fallback_providers: lub starszego fallback_model:). Nie jest prawidłowa w ustawieniu najwyższego poziomu model.provider. Jeśli główny model korzysta z niestandardowego punktu końcowego zgodnego z OpenAI, w sekcji model: należy ustawić provider: custom.⁴

Dlaczego ma to znaczenie: ponieważ auto już korzysta z głównego modelu, dawny problem polegający na tym, że „bez skonfigurowania OpenRouter jakość zadań pomocniczych po cichu spada”, przestał istnieć — kompromisem jest teraz koszt. Jeśli główny model jest kosztownym modelem rozumującym, warto skierować intensywnie używane zadania poboczne do taniego i szybkiego modelu:

auxiliary:
  vision:
    provider: "openrouter"
    model: "google/gemini-2.5-flash"
  compression:
    provider: "openrouter"
    model: "google/gemini-2.5-flash"

System konfiguracji

Hermes ma warstwowy system konfiguracji. Zrozumienie kolejności priorytetów jest kluczowe, ponieważ wyższe warstwy zastępują ustawienia z niższych, a jedną z nich jest globalny rejestr dostawców, którego nie widać w pliku config.yaml.

Układ plików konfiguracyjnych

Zgodnie z dokumentacją projektu Hermes konfigurację tworzą następujące pliki:⁴

~/.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 — gdy ustawienie znajduje się w obu plikach, w przypadku danych niebędących sekretami pierwszeństwo ma config.yaml.⁴ Obowiązuje następująca zasada: - Sekrety (klucze API, tokeny botów, hasła) → .env - Wszystko inne (model, backend terminala, ustawienia kompresji, limity pamięci, toolsets) → config.yaml

Do sekretów można odwoływać się z 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 należy uruchamiać po każdym wykonaniu hermes update — polecenia te wykrywają nowo dodane opcje konfiguracji, których nie ma jeszcze w używanym pliku.⁶

Kolejność priorytetów konfiguracji

Hermes wczytuje konfigurację z kilku źródeł. Jeśli ta sama wartość została ustawiona 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 (ustawienie zastępcze dla pojedynczego wywołania)
2. Zmienne środowiskowe — stosowane podczas uruchamiania procesu
3. config.yaml — główny plik ustawień
4. .env — wyłącznie sekrety
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 jest 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 lokalizuje wszystkie polecenia gateway oraz panel internetowy, dodaje kolejnych 8 wersji językowych i zwiększa ich łączną liczbę do 16.¹⁹ W tagu v2026.8.31 drzewo locales/ zawiera 17 katalogów komunikatów — angielski oraz 16 tłumaczeń (af, ar, de, es, fr, ga, hu, it, ja, ko, pt, ru, tr, uk, zh-hant, zh).³³ Dokumentacja jest obecnie dostępna tylko w lokalizacji zh-Hans. Wersja językowa jest ustalana na podstawie zmiennych środowiskowych LC_ALL / LANG albo jawnego klucza locale: w pliku config.yaml. Angielski pozostaje językiem domyślnym i źródłem prawdy dla każdego ciągu znaków, którego nie uwzględniono jeszcze w tłumaczeniu.

Profile — wiele odizolowanych instancji Hermes

Profile umożliwiają korzystanie z wielu odizolowanych instancji Hermes, z których każda ma własną konfigurację, sesje, skills, pamięć i identyfikator PID gateway. W ten sposób można równolegle uruchamiać „służbowy Hermes” i „prywatny Hermes”, bez wzajemnego dostępu do ich stanów.⁶

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 gateway może działać równocześnie dla wielu profili bez powodowania między nimi konfliktów.⁶³

Od wersji v0.21.2 granica izolacji jest egzekwowana bardziej rygorystycznie: seria poprawek usunęła rzeczywiste wycieki między profilami w konfiguracjach ze współdzielonym gateway, w których profile dodatkowe mogły dziedziczyć listy dozwolonych elementów profilu domyślnego, wysyłać dane uwierzytelniające do jego hosta, przekazywać jego sekrety ze skarbca serwerom MCP działającym przez stdio albo dołączać pliki .env/auth.json/state.db innego profilu podczas dostarczania przez MEDIA: (#107609-#107630). Jeśli korzysta się ze współdzielenia wielu profili, dopiero od tagu v0.21.2 deklarowana izolacja rzeczywiście działa — zob. Co nowego w wersji v0.21.2.⁴⁸

Polecenia CLI

Ta sekcja stanowi praktyczny przewodnik po poleceniach najwyższego poziomu CLI. Wiążące informacje oparte na kodzie zawiera źródłowa dokumentacja poleceń 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 otwiera interaktywny czat. hermes chat jest jego jawną postacią z opcjami:⁶

hermes chat -q "Summarize the latest PRs" --oneshot # Answer and exit (without --oneshot, a TTY seeds an interactive session)
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 — strukturalne odpytywanie dzienników

hermes logs oferuje większe możliwości niż tail -f uruchomione dla plików 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, kierowanie narzędzi, cykl życia sesji, poziom INFO i wyższe) - errors.log — tylko ostrzeżenia i błędy (odfiltrowany podzbiór agent.log) - gateway.log — aktywność gateway wiadomości (połączenia z platformami, kierowanie, webhooki)

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

hermes doctor — diagnostyka

hermes doctor [--fix] to pierwsze polecenie, które należy uruchomić, gdy coś nie działa. Sprawdza poprawność konfiguracji, obecność zależności, dostępność klucza API i stan usług, a po użyciu --fix może podjąć próbę automatycznej naprawy.⁶

Aby udostępnić diagnostykę innej osobie, należy użyć hermes dump — polecenie tworzy zwięzłe podsumowanie w zwykłym tekście, z ukrytymi kluczami API, gotowe do wklejenia do zgłoszenia GitHub lub wątku na Discord.⁶

Polecenia slash

Polecenia slash działają w ramach aktywnej sesji czatu (CLI lub platformy komunikacyjnej). Są wywoływane ze wspólnego rejestru COMMAND_REGISTRY w pliku hermes_cli/commands.py, dlatego większość poleceń działa identycznie we wszystkich interfejsach.⁹

Sterowanie sesją

Konfiguracja i model

Polecenie /model jest podstawowym narzędziem do zmiany dostawcy 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

W v0.19.0 dodano /model --once — jednorazową zmianę modelu na jedną turę, po której odpowiedzi automatycznie przywracany jest poprzedni model.⁵⁶ Od wydania v0.20.5 selektor /model obsługuje również wyszukiwanie rozmyte: filtruje wyniki podczas wpisywania.²³³⁵

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 v0.19.0 wywołania skills za pomocą poleceń slash można łączyć: /skill-a /skill-b do XYZ ładuje oba skills po kolei w ramach jednej tury, z autouzupełnianiem i tekstem podpowiedzi dla połączonych nazw.⁵⁶

W config.yaml można również definiować szybkie polecenia, które przypisują krótkiej nazwie dłuższy prompt:⁹

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 można wpisać /review, /deploy lub /morning.

Dopasowywanie prefiksów

Polecenia obsługują dopasowywanie prefiksów: wpisanie /h wywołuje /help, a /mod — /model. Jeśli prefiks jest niejednoznaczny, obowiązuje 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 (nie jest już ograniczone do platform komunikacyjnych; zob. Sterowanie sesją)
• /sethome (alias /set-home) — oznaczenie bieżącego czatu jako głównego dla danej platformy
• /approve [session|always] — zatwierdzenie oczekującego niebezpiecznego polecenia
• /deny [reason] — odrzucenie oczekującego niebezpiecznego polecenia. Od v0.19.0 /deny <reason> przekazuje agentowi powód odmowy, aby mógł skorygować działanie zamiast ponawiać próbę bez informacji zwrotnej⁵⁶
• /update — aktualizacja Hermes Agent do najnowszej wersji
• /commands [page] — przeglądanie wszystkich poleceń i skills (z podziałem na strony)

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

Narzędzia i toolsets

Hermes zawiera 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 wiele innych funkcji.¹⁰ Narzędzia są uporządkowane w logiczne toolsets, które można włączać lub wyłączać osobno dla każdej platformy.

Kategorie ogólne

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> i /tools enable <name>. Powoduje to zresetowanie sesji, aby nowy zestaw narzędzi zaczął obowiązywać.⁹

Backendy terminala

Narzędzie terminalowe zawiera siedem wbudowanych backendów wykonawczych — a od wersji 0.20.6 zestaw ten można rozszerzać za pomocą pluginów, podobnie jak listę wyboru dostawców (zob. niżej):¹⁰²⁴

Backend można zmienić za pomocą hermes config set terminal.backend <name> lub w pliku config.yaml:

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

Backendy pluginów (od wersji 0.20.6). Zewnętrzni dostawcy środowisk sandbox nie muszą już trafiać do głównego repozytorium: podczas ładowania plugin rejestruje TerminalEnvironmentProvider za pomocą PluginContext.register_terminal_environment_provider, a zarejestrowaną nazwę można wybrać przez terminal.backend dokładnie tak samo jak nazwę wbudowaną. Nazwy wbudowane są zarezerwowane — rejestr odrzuca dostawcę, którego nazwa koliduje z backendem obecnym w repozytorium — a zarejestrowany backend automatycznie pojawia się we wszystkich podstawowych elementach systemu (wyborze backendu w hermes setup, stanie testu połączenia w panelu, kontrolach hermes doctor, obsłudze ścieżek i katalogu cwd kontenera oraz usuwaniu sekretów), ponieważ każdy punkt klasyfikacji korzysta z rejestru zamiast zakodowanej na stałe listy nazw.³²

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 pozostają zachowane między sesjami.¹⁰

Wszystkie backendy kontenerowe korzystają ze wzmocnionych zabezpieczeń: system plików głównego katalogu tylko do odczytu (Docker), usunięte wszystkie uprawnienia systemu Linux poza DAC_OVERRIDE, CHOWN i FOWNER, brak możliwości podnoszenia uprawnień, limity PID (256 procesów), pełna izolacja przestrzeni nazw oraz trwały obszar roboczy oparty na woluminach.¹⁰

Procesy w tle

Narzędzie terminalowe obsługuje wykonywanie w tle wraz 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 interaktywną obsługę narzędzi CLI, takich jak Codex i Claude Code.¹⁰

Sudo

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

Wieloagentowa tablica Kanban (od wersji 0.13.0)

Wersja 0.13.0 przekształca współpracę wielu agentów w pełnoprawny mechanizm: trwałą tablicę Kanban, która śledzi zadania, ich stan oraz tożsamość workerów między agentami i po ponownych uruchomieniach.¹⁸ Dzięki tablicy rój workerów Hermes rzeczywiście kończy pracę, zamiast zatrzymywać się przez nieudane przekazanie 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 uruchamiania workerów. W rezultacie powstaje wzorzec roju, w którym każdy agent korzysta z jednego źródła prawdy o tym, co należy zrobić dalej, kto się tym zajmuje i co jest zablokowane.

Czym jest rój Hermes?

Rój to kilku workerów Hermes działających równolegle na jednej współdzielonej tablicy Kanban. Nie jest to osobny podsystem, który trzeba włączyć — stanowi możliwość zapewnianą przez tablicę. Tablica dostarcza jednej rzeczy, której równolegli agenci nie mogą zapewnić samodzielnie: jednej autorytatywnej odpowiedzi na pytanie: co należy podjąć w następnej kolejności i czy ktoś już nad tym pracuje?

W wersji 0.15.0 wzorzec ten stał się oficjalnie obsługiwaną topologią. Dodano topologię roju do równoległej koordynacji workerów, automatyczny podział ogólnego celu na podzadania, nadpisywanie modelu dla poszczególnych zadań, zaplanowane zadania oraz zarządzanie worktree, dzięki któremu równolegli workerzy nie powodują konfliktów w tej samej kopii roboczej.⁵⁹

W praktyce należy przekazać rojowi cel, pozwolić mechanizmowi automatycznego podziału rozbić go na zadania na tablicy, a następnie umożliwić workerom podejmowanie i wykonywanie zadań oraz zwracanie wyników. Limit ponownych prób jest określany dla każdego zadania (max_retries), dlatego jedno podatne na błędy podzadanie nie wyczerpuje tolerancji całego przebiegu. Ponieważ tablica jest trwała, rój może wznowić działanie po ponownym uruchomieniu — workery ponownie się dołączają i kontynuują pracę na tym samym stanie.

Rój jest tylko tak dobry, jak jego podział zadań. Tablica koordynuje workery, ale nie zmieni źle podzielonego celu w dobry. Zadania współdzielące ukryty stan nadal będą ze sobą kolidować, niezależnie od użycia worktree.

System skills

Skills to dokumenty wiedzy ładowane na żądanie, z których agent może korzystać w razie potrzeby. Wykorzystują model 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. Podczas nowej instalacji skills dołączone do pakietu są kopiowane z repozytorium. Trafiają tam również skills zainstalowane z huba 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 dopiero 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 pełniących funkcję rozwiązania awaryjnego — bezpłatnych lub lokalnych alternatyw, które powinny pojawiać się wyłącznie wtedy, gdy narzędzie premium jest niedostępne:¹¹

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

Skills zarządzane przez agenta

Agent może tworzyć, aktualizować i usuwać własne skills za pomocą narzędzia skill_manage. Stanowi to pamięć proceduralną agenta — gdy opracuje on nietrywialny sposób realizacji zadania, zapisuje to podejście jako skill do wykorzystania w przyszłości.¹¹

Kiedy agent tworzy skills:¹¹ - Po pomyślnym wykonaniu złożonego zadania (wymagającego 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 sposób realizacji zadania

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 huba:¹¹

Domyślne źródła GitHub (dostępne do przeglądania bez konfiguracji): openai/skills, anthropics/skills, huggingface/skills, NVIDIA/skills, garrytan/gstack. Źródło claude-marketplace usunięto w wersji v0.20.0; na liście źródeł zastąpiło je browse-sh.¹¹⁵⁵

Skanowanie zabezpieczeń

Wszystkie skills instalowane z huba 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 pozwala pominąć blokady wynikające z zasad dla społecznościowych skills, o ile nie uznano ich za niebezpieczne. Nie pozwala ona pominąć werdyktu skanowania dangerous.¹¹

Zewnętrzne katalogi skills

Można wskazać Hermes dodatkowe katalogi skills, które będą skanowane wraz 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ą przeznaczone wyłącznie do odczytu — gdy agent tworzy lub edytuje skill, zawsze zapisuje go w ~/.hermes/skills/. Jeśli skill o tej samej nazwie występuje w obu miejscach, pierwszeństwo ma wersja lokalna.¹¹

Przypięte skills: skills.auto_load (okres wersji v0.21.4)

Nazwy skills wymienione w sekcji skills.auto_load pliku config.yaml są przypinane i w pełni ładowane w każdej nowej sesji — zarówno w CLI, TUI, gateway, cron, jak i API:⁵¹

skills:
  auto_load:
    - team-conventions
    - deploy-checklist

Lista jest rozwiązywana jednokrotnie podczas pierwszego tworzenia promptu agenta. Brakująca lub wyłączona nazwa powoduje wyświetlenie ostrzeżenia i jest pomijana, zamiast przerywać sesję. Z kolei HERMES_IGNORE_RULES (mechanizm wykorzystywany przez --ignore-rules) wyłącza tę listę podobnie jak pozostały automatycznie wstrzykiwany kontekst. Jest to odpowiednik stałych poleceń uzupełniający -s/--skills, które wstępnie ładuje skills tylko na czas jednej sesji.⁵¹

Pamięć trwała

Hermes ma ograniczoną, starannie zarządzaną pamięć, która zachowuje dane między sesjami. Pamięć agenta tworzą dwa pliki, oba przechowywane w ~/.hermes/memories/:¹²

Oba są wstrzykiwane do promptu systemowego jako zamrożony stan z początku sesji. Agent sam zarządza swoją pamięcią za pomocą narzędzia memory — add, replace lub remove.¹²

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

Co zapisywać

Należy zapisywać poniższe informacje (agent robi to proaktywnie):¹² - Preferencje użytkownika: „Wolę TypeScript od JavaScript” → user - Informacje o środowisku: „Na tym serwerze działa Debian 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, wierszy o maksymalnej długości 120 znaków i docstringów w stylu Google” → memory - Ukończone prace: „Przeprowadzono migrację bazy danych z MySQL do PostgreSQL 15 stycznia 2026” → 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

Wyszukiwanie sesji

Oprócz plików MEMORY.md i USER.md agent może przeszukiwać wcześniejsze rozmowy za pomocą narzędzia session_search. Wszystkie sesje CLI i sesje komunikatorów są przechowywane w SQLite (~/.hermes/state.db) z pełnotekstowym wyszukiwaniem FTS5. Od przeprojektowania w wersji v0.15.0 narzędzie w ogóle nie korzysta z LLM — bezpośrednio zwraca zapisaną treść rozmów (zgodnie z określeniem użytym w źródle: „narzędzie o jednym formacie zwraca bezpośrednio zawartość bazy danych”), dzięki czemu działa 4 500 razy szybciej i nie generuje kosztu API.¹²⁵⁹³⁴

W okresie wydania v0.21.4 dodano dwie funkcje, obie zweryfikowane dla tagu v2026.9.21. Pierwszą są granice czasowe: format wyszukiwania przyjmuje after (dolną granicę czasu rozpoczęcia sesji, włącznie) oraz before (górną granicę, wyłącznie). Każda z nich może być datą lub datą i godziną w formacie ISO — sama data oznacza północ czasu UTC danego dnia — albo względnym okresem (7d, 24h, 2w). Parametry te są przeznaczone wyłącznie do zapytań, które rzeczywiście określają ramy czasowe; sort pozostaje mechanizmem wpływającym na ranking, a nie granicą. Drugą funkcją jest ponowienie wyszukiwania po uzyskaniu zerowej liczby wyników: niejawny operator AND między terminami w FTS5 sprawia, że parafrazowane zapytanie wielowyrazowe może nie znaleźć zapisanego zdania, jeśli brakuje w nim choć jednego słowa z zapytania. Dlatego gdy dokładne zapytanie i wszystkie warianty wyszukiwania podciągów nie zwrócą wyników, indeks jest ponownie przeszukiwany pod kątem DOWOLNEGO terminu, a wyżej w rankingu umieszczane są wiersze zawierające więcej terminów. Trafienia zachowują semantykę dokładnego dopasowania (ponowienie następuje wyłącznie po wyszukiwaniu bez wyników), natomiast zapytania z jawnymi operatorami OR/NOT, zapytania jednoterminowe oraz zapytania kierowane ścieżką CJK pozostają bez zmian.⁵¹

Zewnętrzni dostawcy pamięci

Aby zapewnić rozbudowaną pamięć trwałą wykraczającą poza MEMORY.md i USER.md, Hermes udostępnia 7 wtyczek zewnętrznych dostawców pamięci: Honcho, OpenViking, Mem0, Holographic, RetainDB, ByteRover i Supermemory. Kolejne, takie jak Hindsight, można zainstalować z katalogu wtyczek.¹²

Hindsight znajdował się w głównym drzewie projektu do wersji v0.21.4, a w wersji v0.21.5 został przeniesiony do katalogu i jest utrzymywany przez Vectorize. Istniejące konfiguracje migrują automatycznie: jeśli ustawiono memory.provider: hindsight, polecenie hermes update instaluje wtyczkę z katalogu w katalogu domowym każdego profile, który z niej korzysta, a pierwsze uruchomienie agenta instaluje ją, jeśli nadal jej brakuje. Przy ustawieniu security.allow_lazy_installs: false podczas uruchamiania agenta zapisywany jest jedynie komunikat w dzienniku, dlatego należy samodzielnie uruchomić hermes plugins install hindsight. Wtyczka trafia do ~/.hermes/plugins/hindsight/ i zostaje dodana do plugins.enabled; ustawienia memory.provider, memory.hindsight.*, HINDSIGHT_API_KEY oraz dane pamięci pozostają bez zmian. Stan można sprawdzić za pomocą hermes memory status i hermes plugins list. Dodatek pip hermes-agent[hindsight] został usunięty.⁵³

Zewnętrzni dostawcy działają równolegle z wbudowaną pamięcią (nigdy jej nie zastępują) i zapewniają dodatkowe możliwości, takie jak 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+)

Wersja v0.13.0 umożliwia przetrwanie przerwania pracy agenta. Po ponownym uruchomieniu gateway automatycznie wznawia przerwane sesje; ponowne uruchomienia wywołane przez /update zachowują stan sesji podczas aktualizacji; przeładowanie plików źródłowych w trakcie programowania utrzymuje aktywną sesję zamiast wymuszać rozpoczęcie nowej.¹⁸ W praktyce oznacza to, że długotrwałe zadania wykonywane przez gateway oraz zadania uruchamiane przez cron nie resetują już swojego okna kontekstowego po ponownym uruchomieniu procesu.

Checkpoint v2 (v0.13.0+)

W wersji v0.13.0 mechanizm utrwalania stanu został przepisany jako rozwiązanie oparte na jednym magazynie, z rzeczywistym oczyszczaniem, zabezpieczeniami przestrzeni dyskowej i bez osieroconych repozytoriów pomocniczych.¹⁸ Poprzedni system checkpoint gromadził stan na dysku w przypadku długo działających profile; magazyn v2 nakłada twardy limit na lokalną przestrzeń zajmowaną przez checkpoint i usuwa powielone dane ewidencyjne, które powodowały ten wzrost. Nie trzeba zmieniać konfiguracji widocznej dla użytkownika; kolejny zapis checkpoint skorzysta ze ścieżki v2.

Osobowość i SOUL.md

SOUL.md stanowi główną 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 profile). 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 wypowiedzi 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 reagować na niepewność, brak zgody i niejednoznaczność

W mniejszym stopniu służy do zapisywania:¹³ - jednorazowych instrukcji dotyczących projektu - ścieżek plików - konwencji repozytorium - tymczasowych szczegółów przepływu pracy

Takie informacje powinny znaleźć się 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 zachowania na poziomie osobowości.

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

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

Wbudowane osobowości

Hermes udostępnia wbudowane osobowości, między którymi można przełączać się 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 przełączyć osobowość za pomocą /personality codereviewer.

SOUL.md a /personality

SOUL.md określa bazowy sposób wypowiedzi. /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 rozmowy edukacyjnej 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 Hermes CLI nadal jest objęty licencją MIT i pozostaje w pełni otwartoźródłowy. Zmiana polega na tym, że uwierzytelnienie w Portal zapewnia teraz dostęp nie tylko do wnioskowania modeli.

Najszybszym sposobem rozpoczęcia pracy jest hermes setup --portal, które README przedstawia jako „jedno polecenie po świeżej instalacji”: loguje ono użytkownika za pośrednictwem OAuth, ustawia Nous jako dostawcę i włącza Tool Gateway. Od tego momentu relacją tą zarządza hermes portal. Polecenie hermes portal login (domyślne, gdy nie podano podpolecenia) przeprowadza ten sam jednorazowy proces wdrożenia; hermes portal info wyświetla „podsumowanie uwierzytelnienia Portal i routingu Tool Gateway”; hermes portal open otwiera stronę subskrypcji w domyślnej przeglądarce; hermes portal tools wyświetla narzędzia gateway oraz wskazuje, które z nich są kierowane przez Nous. hermes portal status pozostało jako ukryty alias zgodności wstecznej dla info, a dokumentacja CLI w tym tagu nadal podaje podpolecenie status, dlatego działają obie formy.²⁸

Co zawiera gateway

Jak to działa

Gateway jest włączany osobno dla każdego narzędzia za pomocą nowego pola konfiguracji use_gateway. Jeśli w hermes auth zapisano dane uwierzytelniające Portal i włączono gateway dla danego narzędzia, jego wywołania są kierowane przez Portal. W przeciwnym razie używany jest bezpośredni klucz API (jeśli jest dostępny).

# 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 w czasie działania: gdy gateway jest dostępny, a narzędzie ma ustawienie use_gateway: true, Hermes wybiera gateway, nawet jeśli skonfigurowano również bezpośredni klucz API. Ma to znaczenie dla rozliczeń — wywołania przez gateway korzystają z subskrypcji Portal, a nie z salda bezpośredniego klucza API.

Włączanie gateway

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 do Portal, które są już zapisane w hermes auth — osobne logowanie nie jest potrzebne. Od wersji v0.19.0 subskrypcją można również zarządzać bezpośrednio podczas sesji: /subscription pokazuje plan i pozostały limit, przedstawia dokładny koszt przejścia na wyższy plan lub termin wejścia w życie obniżenia planu oraz wprowadza zmianę wraz z banerami informującymi o zaplanowanej zmianie i możliwością jej cofnięcia; /topup umożliwia doładowanie środków. Aplikacja na komputery ma odpowiadającą temu kartę ustawień rozliczeń.⁵⁶

Ceny i dostęp

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

Bezpłatny plan Nous i prowadzony pierwszy start (v0.21.2+)

Od wersji v0.21.2 świeża instalacja nie wymaga płatnego planu ani klucza API, aby uruchomić działającego agenta: bezpłatne wnioskowanie i konektory są dostępne od razu, do zalogowania wystarczy jedno polecenie, a /login rozpoczyna proces logowania z poziomu czatu. Narzędzia konektorów (Gmail, Linear, Notion i pozostałe) można wyszukiwać za pomocą tool_search tak samo jak każde inne narzędzie. Aplikacja na komputery oferuje prowadzony pierwszy start kontrolowany przez HERMES_GUEST_ONBOARDING=1; włącza go wyłącznie dosłowna wartość 1 – test samej aplikacji potwierdza, że wartości 'true', '0' oraz wartość pusta pozostawiają go wyłączonym, a decyzja o uruchomieniu zostaje zapisana w środowisku uruchamianego backendu, dzięki czemu odziedziczona wartość nigdy nie przenika do procesu.⁴⁸

Od okresu wydania v0.21.4 łączenie tych konektorów jest pojedynczą operacją należącą do backendu, a nie logiką rozproszoną między poszczególnymi frontendami: wywołanie narzędzia manage_connections steruje na backendzie maszyną stanów połączenia operującą wyłącznie na danych (ze stałym, 300-sekundowym limitem czasu operacji – celowo niebędącym kluczem konfiguracji), a Desktop, TUI i CLI wyświetlają ją jako tę samą kartę konfiguracji. Karta tworzy pole dla każdego brakującego poświadczenia (nazwa, komunikat, wymagane) i utrzymuje przycisk działania w stanie nieaktywnym, dopóki wszystkie wymagane pola nie zawierają tekstu, natomiast backend wymusza ten sam podział ograniczony wyłącznie do sekretów we wszystkich frontendach.⁵¹

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 za pomocą pola konfiguracji use_gateway ustawianego osobno dla każdego narzędzia, a ich dostępność zależy od stanu subskrypcji Portal.⁶¹

Kontekst: czym to wydanie nie jest

Hermes Agent CLI nie wymaga subskrypcji. Projekt nadal jest objęty licencją MIT, a wszystkie podstawowe funkcje (CLI, skills, pamięć, gateway komunikatorów, cron, MCP, lokalny dashboard oraz 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ż płacą za Nous Portal — nie usuwa niczego ze ścieżki bezpłatnej.

Messaging Gateway

Hermes może działać jako stale aktywny proces gateway, który w ramach jednego procesu łączy się z 28 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, Photon (iMessage), WhatsApp Cloud API, WeCom Callback, Raft, IRC, ntfy, Buzz oraz ogólnym adapterem Webhook.^360171819 Liczba 28 pochodzi z tabeli porównawczej platform w dokumentacji dla tagu v2026.8.31; tymczasem gateway/config.py definiuje 24 wbudowane elementy wyliczenia Platform (w tym pozycje niezwiązane z czatem, takie jak local, api_server, webhook, msgraph_webhook i relay), a każdą inną nazwę dynamicznie przypisuje do jednego z 22 dołączonych katalogów adapterów w plugins/platforms/, dlatego samo zliczenie elementów wyliczenia lub katalogów nie da liczby podanej w dokumentacji.²⁵ Wersja v0.9.0 dodała obsługę iMessage za pośrednictwem BlueBubbles (automatyczna rejestracja webhooka, kreator konfiguracji i odporność na awarie) oraz natywną obsługę WeChat przez iLink Bot API, wraz z trybem wywołań zwrotnych WeCom dla aplikacji firmowych.¹⁶ Wersja v0.11.0 dodała QQBot.⁶⁰ Wersja v0.12.0 dodał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 na nowy wzorzec adapterów z ogólnymi hakami pluginów env_enablement_fn / cron_deliver_env_var.¹⁸ Wersja v0.14.0 dodaje LINE i SimpleX Chat oraz uzupełnia kompleksową obsługę 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 obsługę iMessage bez pośrednika przez Photon Spectrum (OAuth za pomocą kodu urządzenia i polecenia hermes photon login — bez konieczności używania Maca ani pośrednika BlueBubbles), oficjalny adapter WhatsApp Business Cloud API (zastępujący wymóg korzystania z procesu pośredniczącego), grupy i natywne załączniki w SimpleX oraz Raft jako dołączony plugin platformy.²¹ W tabeli dokumentacji znajdują się jeszcze dwie pozycje, którym nie poświęcono szczególnej uwagi w informacjach o wydaniach: ntfy to lekki kanał powiadomień push typu publish-subscribe oparty na HTTP (można zasubskrybować temat w aplikacji mobilnej ntfy, wysłać do niego wiadomość, aby porozmawiać z agentem, i otrzymać odpowiedź na telefonie; działa z publicznym serwerem ntfy.sh lub instancją hostowaną samodzielnie, bez potrzeby używania SDK ani demona), natomiast Buzz łączy Hermes ze społecznością Buzz — rozwijaną przez Block platformą open source do współpracy ludzi i agentów, działającą w protokole Nostr — wywołując buzz CLI w celu wysyłania wiadomości oraz korzystając z natywnej subskrypcji przychodzącej Nostr WebSocket. Obie platformy konfiguruje się przez hermes gateway setup.²⁵

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 łączenia 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. Właśnie dlatego polecenia z ukośnikiem działają identycznie w obu miejscach, a zadanie cron zaplanowane w Telegramie może dostarczyć swoje wyniki do Discorda — 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 ustawień przez GATEWAY_MULTIPLEX_PROFILES. Wzmocnienie odporności sprawia też, że jeden błędnie skonfigurowany profil nie może już wyłączyć całego gateway. Wewnętrznie indeks routingu przeniesiono do state.db (sessions.json jest teraz opcjonalną starszą kopią), a odpowiedzi końcowe są rejestrowane w trwałym rejestrze zobowiązań do dostarczenia, obejmującym operację wysłania przez platformę — jeśli po przygotowaniu odpowiedzi gateway ulegnie awarii, zostanie ona ponownie dostarczona przy następnym uruchomieniu, zamiast bezpowrotnie zniknąć.⁵⁶ Izolację między kierowanymi profilami wzmocniono w wersji v0.21.2, usuwając zestaw wycieków między profilami występujących właśnie w tej konfiguracji multipleksowanej: dziedziczone listy dozwolonych użytkowników, dane uwierzytelniające wysyłane do hosta profilu domyślnego, sekrety ze skarbca profilu domyślnego trafiające do serwerów stdio MCP, załączniki MEDIA: przenikające między profilami oraz token bearer Nous sąsiedniego profilu pozostający w pamięci podręcznej procesu (#107609-#107630).⁴⁸

Wersja v0.21.1 sprawia, że granice konwersacji są wyznaczane wyłącznie jawnie. Dokument dotyczący cyklu życia sesji dla tagu v2026.9.7 określa tę zasadę w czterech zdaniach: „Brak aktywności ani upływ czasu zegarowego nigdy nie powodują zmiany konwersacji. /new i /reset tworzą jawną granicę; kompresja kontekstu nadal służy do zarządzania długimi historiami. Starsza konfiguracja czasomierza jest ignorowana. Istniejący typ danych SessionResetPolicy stanowi nieaktywną warstwę zgodności, a nie zasadę środowiska wykonawczego”. Jawne zawieszenie nadal tworzy granicę przy następnej wiadomości przychodzącej, odzyskiwanie respektuje sfinalizowane granice, zamiast ponownie je otwierać, a usunięcie wyłącznie zasobów pozostawia możliwość wznowienia konwersacji. Jeśli sesja w używanym gateway zdaje się „nigdy nie wygasać”, jest to obecnie zachowanie zamierzone; należy samodzielnie rozpocząć nową za pomocą /new.⁴³

Od okresu wydania v0.21.4 drugi proces hermes gateway run dołącza do istniejącego procesu albo odmawia uruchomienia, zamiast ponownie wiązać ten sam zasób. Obowiązuje zasada jednego procesu hermes serve i jednego hermes gateway run na hosta oraz użytkownika systemu operacyjnego, przy czym każdy z nich multipleksuje wszystkie profile. Uruchomienie gateway dla profilu już obsługiwanego przez działający multiplekser powoduje jedynie dołączenie i zakończenie z kodem 0; jeśli multiplekser nie obsługuje jeszcze tego profilu, Hermes prosi go o ponowne przeskanowanie profiles/ i dołącza, gdy profil zostanie wykryty; jeżeli uruchomionego procesu nie da się skłonić do obsługi profilu, polecenie odmawia wykonania, zamiast po cichu uruchamiać drugi gateway. Opcja --replace wskazuje teraz proces hosta niezależnie od tego, który profil go uruchomił, natomiast --force całkowicie pomija pytanie, gdy proces właściciela przestał odpowiadać. Samodzielne procesy gateway nadal mogą działać równolegle: jeśli aktywny gateway jest samodzielnym (niemultipleksowanym) procesem innego profilu, używany profil uruchamia obok niego własny proces tak jak wcześniej, dopóki migracja nie zostanie wymuszona (#109417). Jeśli dwa procesy gateway zostaną uruchomione jednocześnie, ten, który nie uzyska blokady hosta, kończy działanie z kodem 75, a każdy supervisor generowany przez Hermes ponawia taką próbę; do tego czasu istnieje już rekord zwycięskiego procesu, więc ponowiona próba dołącza do niego albo odmawia wykonania zgodnie z powyższymi zasadami. Blokady i rekord punktu koordynacyjnego znajdują się w $HERMES_GATEWAY_LOCK_DIR, a jeśli ta zmienna nie jest ustawiona — w $XDG_STATE_HOME/hermes/gateway-locks (domyślnie ~/.local/state/hermes/gateway-locks) i są ograniczone do użytkownika systemu operacyjnego; rekord, którego PID już nie istnieje lub został ponownie wykorzystany przez inny proces, jest uznawany za nieaktualny i ignorowany, dlatego awaria gateway nie blokuje kolejnego uruchomienia. Aplikacja Desktop przestrzega tej samej zasady, dołączając do działającego backendu hosta, zamiast uruchamiać drugi proces.⁵¹

Od wersji v0.21.5 multipleksowanie nie jest już opcjonalne. gateway.multiplex_profiles ma jedną prawidłową wartość: true. Brak klucza jest interpretowany jako włączenie tej funkcji, a klucz zostaje zapisany w config.yaml profilu domyślnego; jawna wartość false jest natomiast zastępowana w miejscu wartością true, czemu towarzyszy jednorazowy komunikat w ramce podczas uruchamiania gateway oraz ponownie w podsumowaniu kolejnego polecenia hermes update. Stary mechanizm rezygnacji zastępują dwa elementy sterujące. Aby wyłączyć jeden profil bez zatrzymywania botów pozostałych użytkowników, należy uruchomić hermes -p <name> gateway stop: host parkuje profil (tworząc znacznik profiles/<name>/gateway.parked), a hermes -p <name> gateway start usuwa stan zaparkowania; przyciski Stop/Start w dashboardzie i aplikacji Desktop działają tak samo. Profil nazwany, który nadal wymaga własnego gateway, ustawia gateway.standalone: true we własnym pliku config.yaml; host nigdy go nie obsługuje, a jego polecenia stop/start odnoszą się do jego własnego procesu. Dokumentacja określa ten klucz jako „tymczasową warstwę zgodności”, a nie obsługiwaną topologię; w profilu domyślnym jest on ignorowany z ostrzeżeniem. Rozdzielenie między użytkowników systemu operacyjnego lub użycie HERMES_HOME poza katalogiem profiles/ domyślnego katalogu domowego nadal wymaga opcji --force.⁵³

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 komunikowanie się z używanym gateway. Użytkownik wysyła kod parowania ze swojej platformy komunikacyjnej, a następnie należy zatwierdzić go poleceniem hermes pairing approve; od tej chwili użytkownik jest autoryzowany.⁶

unauthorized_dm_behavior określa, co przed sparowaniem otrzyma nieznana osoba wysyłająca wiadomość prywatną: pair odsyła kod parowania w wiadomości prywatnej, ignore po cichu odrzuca wiadomość, natomiast decline — wartość dodana w okresie wydania v0.21.4 — wysyła jedną uprzejmą odmowę, po czym przez 24 godziny nie odpowiada danemu nadawcy (#88028). Odmowa jest deduplikowana dla każdej pary platformy i nadawcy, również między aliasami, a jej treść pochodzi z unauthorized_dm_decline_message (klucza globalnego; pusta wartość oznacza użycie wbudowanej odpowiedzi: „Cześć! Jestem osobistym asystentem i mogę rozmawiać tylko z moim właścicielem, więc nie mogę bezpośrednio Ci pomóc. Przepraszam!”). Zachowanie można ustawić globalnie albo osobno dla każdej platformy, gdzie zapisuje je kreator konfiguracji:

# ~/.hermes/config.yaml
unauthorized_dm_behavior: decline      # global; gateway.unauthorized_dm_behavior also works
unauthorized_dm_decline_message: ""    # empty = built-in reply
platforms:
  telegram:
    unauthorized_dm_behavior: pair     # per-platform value always wins

Jeśli niczego nie ustawiono, efekślna wartość domyślna zależy od list dozwolonych użytkowników. Gdy nie skonfigurowano żadnej takiej listy, jest nią pair; po ustawieniu dowolnej listy (GATEWAY_ALLOWED_USERS albo zmiennej dozwolonych użytkowników, użytkowników grupowych lub czatów grupowych określonej platformy) wartością staje się ignore, ponieważ lista sygnalizuje celowo ograniczony gateway, a wysyłanie kodów nieznanym kontaktom generuje zbędne wiadomości i może ujawniać informacje (#9337). Globalne ustawienie ignore lub decline zastępuje tę regułę, lecz globalne pair nie może tego zrobić, ponieważ jest interpretowane tak samo jak wartość domyślna; aby zachować parowanie przy aktywnej liście dozwolonych użytkowników, należy ustawić pair osobno dla każdej platformy. (Własna wartość dm_policy adaptera platformy, jeśli została ustawiona, jest sprawdzana przed regułą listy dozwolonych użytkowników). Email ma charakter skrzynki odbiorczej i domyślnie używa ignore, chyba że włączono inną opcję za pomocą jego własnego klucza właściwego dla platformy; wartość globalna go nie obejmuje. Podczas konfigurowania platformy bez listy dozwolonych użytkowników hermes gateway setup udostępnia odmowę jako jedną z możliwych odpowiedzi.⁵¹

Zaplanowane zadania (cron)

Hermes oferuje rozbudowany 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ą być dostarczane 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

Można je również utworzyć konwersacyjnie na czacie w komunikatorze:

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 przechowywane w JSON i zachowywane po ponownym uruchomieniu.³

Wersja v0.21.0 wyposażyła zaplanowane zadania w pamięć i zdolność oceny sytuacji. Cztery mechanizmy, wszystkie zweryfikowane dla tagu v2026.8.31:³⁵³⁷

• Ciągłość. continuity=true dołącza do każdego uruchomienia własny najnowszy wynik danego zadania, dzięki czemu agent rozpoznawczy lub monitorujący „budzi się, widząc swój poprzedni raport, może usuwać duplikaty i kontynuować od miejsca, w którym zakończył pracę” — dołączona instrukcja brzmi „unikaj powtarzania informacji, które już zgłoszono”, pierwsze uruchomienie pozostaje bez zmian, a wewnętrznie flaga jest przechowywana jako zarezerwowany wpis self w context_from. Można ją przełączać za pomocą hermes cron create ... --continuity oraz hermes cron edit <job_id> --continuity / --no-continuity.³⁷
• Trwałe notatniki. Każde zadanie otrzymuje niewielki magazyn roboczy KV na kursory, znaczniki postępu i listy obserwowanych elementów (16 KB na wartość, 64 KB na zadanie — jego zawartość jest dołączana do promptu przy każdym uruchomieniu, dlatego limity są celowe). Dane zapisuje się za pomocą hermes cron notepad <job_id> set <key> <value>, które działający agent wywołuje przez swoje narzędzie terminalowe.³⁷
• Tryb monitorowania. Do zadania można dołączyć niedrogie źródło monitor_script/monitor_url, uruchamiane jako pierwsze przy każdym cyklu: niezmieniony wynik (porównywany bajt po bajcie) całkowicie wstrzymuje uruchomienie agenta — bez wywołania LLM, bez dostarczenia wyniku, z dyskretnym statusem uruchomienia no_change — natomiast wykrycie zmiany powoduje dołączenie bloku różnic i zwykłe uruchomienie agenta. Skrypty monitorujące powinny generować stabilne wyniki, w przeciwnym razie każdy cykl będzie wyglądał jak zmiana.³⁷
• Poziom intensywności rozumowania dla poszczególnych zadań i dostarczanie do Bot Chat. --reasoning-effort ustala poziom rozumowania zadania (od none do ultra), zastępując ustawienia globalne i ustawienia modelu dla uruchomień tego zadania; z kolei deliver=bot-chat dostarcza wynik jako prawdziwą wiadomość przychodzącą do kanonicznej sesji Bot Chat profilu, gdzie bot „podejmuje wszelkie niezbędne działania i odpowiada na swoim czacie”, zamiast ograniczać się do wyświetlenia wiadomości człowiekowi w kanale.³⁷

Integracja z MCP

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

Jako klient — można połączyć Hermes z zewnętrznymi serwerami MCP, aby rozszerzyć zestaw dostępnych 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
hermes mcp login <name>       # Force re-auth for an OAuth server (--flow browser|device)
hermes mcp reauth [--all]     # Re-authenticate one OAuth server, or every one

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 dziennika serwera MCP trafiają do agent.log.⁵⁶

Wersja v0.21.1 dodaje do OAuth w MCP obsługę kodu urządzenia: hermes mcp login <name> przyjmuje --flow {browser,device} — browser oznacza dotychczasowy przepływ PKCE, a device logowanie kodem urządzenia zgodne z RFC 8628, przeznaczone dla maszyn bez interfejsu graficznego lub maszyn zdalnych — przy czym flaga zastępuje konfigurację oauth.flow serwera. Ta sama wersja wymusza własność profilu przez cały czas trwania sesji OAuth, ignoruje uszkodzone pamięci podręczne metadanych OAuth, zamiast blokować serwer, oraz przekazuje desktopowe OAuth w MCP przez lokalne wywołania zwrotne klienta; -t/--toolsets filtruje teraz również uruchamiane skonfigurowane serwery MCP, dzięki czemu wywołanie o ograniczonym zakresie pomija zimny start serwerów, których nie potrzebuje.⁴⁴

Wersja v0.21.0 przekształca desktopowy interfejs MCP w centrum sterowania: serwery i katalog są połączone na jednej stronie, dostępny jest import metodą „wklej cokolwiek” przez przeciągnięcie, kontrole stanu w tle ostrzegają o wygasającym uwierzytelnieniu, zanim wywołanie narzędzia zakończy się niepowodzeniem, nakładka kosztów i użycia całej floty pokazuje szacowaną liczbę tokenów schematu oraz 30-dniowe użycie każdego serwera, a głębokie linki hermes:// instalują serwer MCP po wyraźnym potwierdzeniu.³⁵

Wersja v0.21.4 dodaje mcp.discovery_concurrency (domyślnie 4; 0 = bez ograniczeń, #117373): limit liczby skonfigurowanych serwerów MCP, z którymi proces wykrywania może łączyć się jednocześnie. Nadal nawiązywane jest połączenie z każdym serwerem — limit zapobiega jedynie ich jednoczesnemu połączeniu — a wartość niecałkowita lub ujemna powoduje zapisanie ostrzeżenia w dzienniku i przywrócenie wartości domyślnej.⁵¹

Jako serwer — można udostępnić rozmowy Hermes innym agentom:

hermes mcp serve
hermes mcp serve -v    # Verbose

Kompresja kontekstu

Hermes automatycznie kompresuje długie rozmowy, aby mieściły się w oknie kontekstu modelu. Model podsumowujący używany do kompresji wykonuje osobne wywołanie LLM — można skierować je do dowolnego dostawcy lub endpointu.⁴ Od wersji v0.20.6 zasada zachowywania końcowej części rozmowy domyślnie korzysta z trybu lean (compression.tail_mode: lean), a w przypadku tego tagu ustawienia modelu, dostawcy i endpointu modelu podsumowującego znajdują się w auxiliary.compression.*, zamiast w starszych kluczach compression.summary_* — starsze klucze są automatycznie migrowane przy pierwszym wczytaniu (wersja konfiguracji 17).³⁰³¹

compression:
  enabled: true
  threshold: 0.50          # Compress at this % of context limit
  threshold_tokens: null   # Optional absolute token cap -- trigger fires at the lower of ratio vs cap
  target_ratio: 0.20       # Fraction of threshold to preserve as recent tail (legacy tail mode)
  tail_mode: lean          # Tail retention: "lean" (default) or "legacy"
  protect_last_n: 20       # Min recent messages to keep uncompressed
  protect_first_n: 3       # Non-system head messages pinned across compactions

auxiliary:
  compression:
    model: ""              # Empty = main chat model; e.g. "google/gemini-3-flash-preview"
    provider: "auto"       # "auto", "openrouter", "nous", "codex", "main", etc.
    base_url: null         # Custom OpenAI-compatible endpoint (overrides provider)

O czym decyduje tail_mode. legacy zachowuje dosłowną końcową część o rozmiarze określonym przez target_ratio — w konfiguracjach z dużym oknem lub podniesionym progiem oznacza to gromadzenie 100–240 tys. tokenów podczas każdej kompresji. lean zachowuje dosłowną końcową część o rozmiarze 2,5% okna kontekstu, ograniczonym do przedziału od 10 tys. do 25 tys. tokenów, a ciągłość przenosi do podsumowania: szczegółowego dziennika sesji zachowującego identyfikatory ze skompresowanego obszaru (jedno pomocnicze wywołanie modelu podsumowującego na próbę), automatycznie wyodrębnionego indeksu punktów odniesienia (numery PR, SHA, ścieżki, komunikaty błędów — wyrażenia regularne, bez parafrazowania), wszystkich rzeczywistych wiadomości użytkownika cytowanych dosłownie oraz wskaźnika odzyskiwania session_search, dzięki któremu agent może ponownie uzyskać dostęp do wszystkich treści usuniętych z kontekstu na rzecz podsumowania. Wynik zmierzony w dokumentacji dla rzeczywistych sesji liczących 500 tys. tokenów: zachowano około 49 tys. tokenów zamiast około 162 tys. Stare wyniki narzędzi w końcowej części trybu lean są redukowane do jednowierszowych skrótów zawierających wskaźnik odzyskiwania, a nieznane wartości tail_mode powodują powrót do lean.³¹

Opcje dostawcy:⁴³¹

Model podsumowujący musi obsługiwać okno kontekstu co najmniej tak duże jak model główny, ponieważ otrzymuje pełną środkową część rozmowy w jednym wywołaniu — jeśli jego okno jest mniejsze, wywołanie kończy się niepowodzeniem, a środkowe tury są usuwane bez podsumowania.⁴³¹

Ostrzeżenia o wyczerpywaniu budżetu

Gdy agent wykonuje złożone zadanie wymagające wielu wywołań narzędzi, może nieświadomie wyczerpać swój budżet iteracji (od wersji v0.20.0 domyślnie 500 tur zamiast 90). 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 sieci LAN):⁴

Limit czasu odczytu z gniazda jest zwiększany do 30 minut dla lokalnych endpointów, ponieważ lokalne modele LLM mogą potrzebować kilku minut na wstępne przetworzenie dużych kontekstów, zanim wygenerują pierwszy token.⁴

Lokalny panel internetowy (v0.9.0+)

Panel działający w przeglądarce, przeznaczony 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łatwiejsza ścieżka wdrożenia dla nowych użytkowników preferujących GUI.

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 obserwować logi kompilacji — wszystko bez odpytywania. W połączeniu z notify_on_complete z wersji v0.8.0 (funkcją powiadamiającą o zakończeniu zadania w tle) Hermes oferuje teraz pełną warstwę obserwowalności procesów działających w tle.¹⁵

Wymienny context engine (v0.9.0+)

Zarządzanie kontekstem jest teraz wymiennym komponentem konfigurowanym za pomocą hermes plugins. Można zastosować niestandardowe context engine, które kontrolują, co agent widzi w każdej turze — poprzez filtrowanie, podsumowywanie lub wstrzykiwanie kontekstu właściwego dla danej dziedziny.¹⁶ Oddziela to strategię kontekstu od głównej pętli agenta, umożliwiając dostosowanie kontekstu do konkretnego projektu lub dziedziny.

Tworzenie i przywracanie kopii zapasowych (v0.9.0+)

hermes backup tworzy pełne archiwum konfiguracji, sesji, skills i pamięci. hermes import przywraca dane z archiwum kopii zapasowej.¹⁶ Funkcji tej można używać do migracji między urządzeniami, tworzenia migawek przed wprowadzeniem istotnych zmian lub udostępniania członkom zespołu sprawdzonej konfiguracji.

Obsługa Termux / Androida (v0.9.0+)

Hermes działa natywnie na Androidzie za pośrednictwem Termux. Dostosowane ścieżki instalacji, optymalizacje TUI dla ekranów urządzeń mobilnych, obsługa mechanizmu głosowego i 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 oraz zmieniono jedno ustawienie domyślne na korzystniejsze dla użytkownika.¹⁸ Wersja v0.14.0 usuwa kolejne 12 problemów klasy P0 i 50 klasy P1, w tym wzmacnia ochronę przed atakami brute force na sudo oraz nadużyciami sudo-stdin, eliminuje sposoby omijania zabezpieczeń przed niebezpiecznymi poleceniami, oczyszcza błędy narzędzi przed ich ponownym przekazaniem do modelu, zabezpiecza uwierzytelnianie API wtyczek panelu, rozszerza ochronę skills-hub przed SSRF i wprowadza podczas instalacji skanowanie pod kątem ostrzeżeń dotyczących łańcucha dostaw.¹⁹

Jeśli utrzymuje się wdrożenie Hermes, wersje v0.13.0 i v0.14.0 należy traktować jako aktualizacje istotne dla bezpieczeństwa, a nie tylko wydania nowych funkcji. Wersja v0.13.0 eliminuje obejście zabezpieczeń między serwerami Discord oraz dwa okna TOCTOU; v0.14.0 wprowadza kolejną serię wzmocnień obejmujących obsługę sudo, ponowne przekazywanie błędów narzędzi, APIs wtyczek, ochronę skills-hub przed SSRF oraz ostrzeżenia dotyczące zależności.

Wersja v0.21.0 wprowadza czwartą serię zabezpieczeń. Zapisy do chronionych plików instrukcji agenta – AGENTS.md, CLAUDE.md, SOUL.md, .cursorrules, skills i magazynów pamięci – zawsze wymagają teraz zatwierdzenia, dzięki czemu agent poddany wstrzyknięciu promptu nie może niepostrzeżenie zmienić własnych stałych instrukcji. Mechanizm jest domyślnie włączony (security.protected_instruction_files: true, z listą dodatkowych wzorców nazw bazowych zgodnych z fnmatch w protected_instruction_extra_patterns), a źródło precyzyjnie określa eliminowany wektor ataku: „wstrzyknięta instrukcja edytująca AGENTS.md / CLAUDE.md / SOUL.md”. Zwraca również uwagę, że pliki instrukcji są wczytywane z drzew katalogu cwd, dlatego „plik AGENTS.md znajdujący się w dowolnym miejscu, z którego agent może później zostać uruchomiony, stanowi aktywny cel”.³⁵³⁹ To samo wydanie usuwa luki umożliwiające wyciek sekretów przez błędy terminala, odczyty plików .env, checkpointy i logi ACP; rozszerza system zatwierdzania o destrukcyjne polecenia i ścieżki Windows; sprawia, że uprawnienia nadane w macOS pozostają zachowane po aktualizacjach dzięki stabilnej tożsamości podpisu TCC (jednorazowa konfiguracja: hermes desktop --setup-tcc-identity, wyłącznie w systemie macOS, wymaga openssl/security/codesign); usuwa pozycję Blender MCP z katalogu oraz powiązany skill po naruszeniu bezpieczeństwa projektu źródłowego; a także dodaje skanowanie zabezpieczeń Tier-1 podczas instalowania wtyczek.³⁵³⁹

Architektura dla praktyków

Ta sekcja jest przeznaczona dla osób, które chcą zrozumieć działanie systemu od środka, aby móc diagnozować problemy, rozszerzać go lub analizować 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 opracowany na podstawie dokumentacji architektury projektu źródłowego.³

„47 narzędzi / 20 toolsets” a „28 narzędzi” w banerze. Liczba „47 narzędzi” oznacza cały rejestr narzędzi w repozytorium źródłowym — wszystkie narzędzia, których kod źródłowy jest dostarczany z Hermes, ze wszystkich toolsets. Faktycznie 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 trzeba je jawnie włączyć w config.yaml w sekcji toolsets: — między innymi adaptery platform komunikacyjnych, automatyzację przeglądarki i bardziej zaawansowane narzędzia do pozyskiwania danych. Łączna liczba w rejestrze oznacza „co jest dostępne”, natomiast liczba w banerze — „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 ~/.hermes/config.yaml (albo za pomocą /tools list / /tools enable <name> / /tools disable <name> w działającej sesji — usunięcie narzędzia powoduje zresetowanie sesji, aby agent ponownie utworzył manifest narzędzi).

Trzy tryby API

Hermes abstrahuje różnice między dostawcami za pomocą trzech trybów API, wybieranych automatycznie podczas działania:³

Mechanizm rozpoznawania w runtime_provider.py odwzorowuje 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()
    → agent.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 — albo 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ściwego 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. System śledzi pochodzenie sesji (relacje nadrzędne i podrzędne między kompresjami), izoluje je według platform oraz wykonuje zapisy atomowe z obsługą współbieżnego dostępu.³

Jeśli magazyn sprawia problemy w instalacji z serii v0.21.x, należy korzystać co najmniej z wersji v0.21.2: usunięto w niej całą klasę problemów z niestabilnością state.db występujących w czasach v0.21.0 (dodatkowe procesy zapisujące wzajemnie anulowały swoje blokady, prawidłowe bazy danych były zgłaszane jako uszkodzone, a jeden wadliwy wiersz powodował awarię sessions list). Koordynację hostowanych pokojów przeniesiono ponadto z głównego magazynu do osobnego pliku shared-state.db, dzięki czemu profile gateways nigdy nie otwierają głównego magazynu sesji w trybie zapisu. hermes doctor osobno wskazuje teraz uszkodzenia strukturalne i uszkodzenia indeksu FTS; w razie uszkodzenia FTS pogarsza się jakość wyszukiwania, zamiast dochodzić do przerwania tury. Z kolei hermes sessions recover --inspect-only (działający offline, niedestrukcyjny i przypisany do profile) raportuje możliwość odczytu tabel kanonicznych bez tworzenia wyjściowej bazy danych — to podpolecenie istniało już przed omawianym okresem, lecz nie było dotąd udokumentowane w tym miejscu. Więcej informacji zawiera sekcja Co nowego w v0.21.2.⁴⁸ W przypadku magazynu zablokowanego w niewłaściwym trybie dziennika SQLite w okresie wydania v0.21.4 dodano konwerter offline hermes sessions set-journal-mode delete|wal (zob. wiersz hermes sessions w sekcji Polecenia najwyższego poziomu).⁵¹

System pluginów

Dostępne są trzy źródła wykrywania: ~/.hermes/plugins/ (użytkownika), .hermes/plugins/ (projektu) oraz punkty wejścia pip. Plugins rejestrują narzędzia, hooks oraz polecenia CLI za pośrednictwem kontekstowego API. Dostawcy pamięci stanowią wyspecjalizowany typ pluginu w plugins/memory/.³ Od wersji v0.21.2 dostępny jest również starannie wyselekcjonowany katalog pluginów przypiętych za pomocą SHA, który można przeglądać i z którego można instalować plugins według nazw, a także hermes plugins pack przeznaczony do „deklaratywnych zestawów pluginów nadających się do udostępniania”: jeden plik hermes-pack.yaml przypina zestaw pluginów do dokładnych identyfikatorów SHA commitów, instalacje pakietów rozwijają się w zwykłe przypięte instalacje, natomiast zgoda na uprawnienia pozostaje udzielana osobno dla każdego pluginu.⁴⁸

W okresie wydania v0.21.4 katalog przekształcono z powierzchni CLI w dostarczany artefakt. Katalog plugin-catalog/ w repozytorium rozrósł się z 9 wpisów w v2026.9.14 do 228 w v2026.9.21 — po jednym zweryfikowanym YAML na każdy plugin (nazwa, repozytorium, opiekun, poziom, kategoria, możliwości), przypiętym do dokładnego 40-znakowego SHA commitu, przy czym obecność w katalogu oznacza dopuszczenie — publikowanych jako plugin-catalog.json dla CLI (pobierany na bieżąco i zapisywany w pamięci podręcznej w ~/.hermes/cache/). Witryna dokumentacji tworzy teraz na podstawie tych samych danych osobną stronę dla każdego pluginu (/docs/plugins/<name>) oraz każdego autora (/docs/plugins/by/<slug>). Każda strona renderuje README pluginu pobrany z przypiętego commitu — nigdy z najnowszego stanu gałęzi — za pośrednictwem stosowanej podczas kompilacji listy dozwolonych elementów, która odrzuca surowe HTML. Kolejność według dat dodania i aktualizacji jest określana na podstawie dat autorów commitów. Dziesięć społecznościowych pluginów wymienionych w wydaniu v0.21.4 figuruje w katalogu dla tego tagu pod faktycznymi identyfikatorami katalogowymi: hermes-tailscale, hermes-ssh, shodan, hermes-terminal, hermes-rss (oraz osobny rss-reader), hermes-resetwatch, done-bell, kiwi, cognee i web-octen. W aplikacji komputerowej centrum Plugins umożliwia teraz odinstalowanie pluginu po potwierdzeniu w oknie dialogowym — plugins z katalogu za pośrednictwem plugins.manage remove, a samodzielne plugins aplikacji komputerowej przez mechanizm ładujący Electron.⁵¹

hermes plugins                       # Interactive enable/disable UI
hermes plugins browse                # List every curated plugin catalog entry (v0.21.2+)
hermes plugins search <query>        # Search the curated plugin catalog (v0.21.2+)
hermes plugins install <name|repo>   # Install from the curated catalog, a Git URL, or owner/repo
hermes plugins enable <name>
hermes plugins disable <name>
hermes plugins list
hermes plugins pack install <src>    # Shareable SHA-pinned plugin sets; also: pack export, pack show (v0.21.2+)

Okres zgodności (v0.21.1), obecnie zakończony: zewnętrzne plugins musiały zrezygnować ze ścieżek importu sprzed dekompozycji do 2026-09-14. W ramach dekompozycji z września 2026 (PR #102117) przeniesiono wewnętrzne elementy często importowane przez plugins, a tymczasowa warstwa COMPAT_MANIFEST.md ponownie eksportowała 1 148 przeniesionych nazw publicznych z ich dawnych modułów, wyświetlając ostrzeżenie raz dla każdej nazwy w danym procesie (HermesPluginCompatWarning). Usunięcie nastąpiło zgodnie z harmonogramem 2026-09-14 za pośrednictwem warunku daty w dostarczanym kodzie (COMPAT_REMOVAL_DATE w hermes_cli/plugin_compat.py; nie był potrzebny żaden commit wycofujący kod): od tego dnia plugin, którego dotyczy problem, jest wyłączany — nie zostaje załadowany, a czerwony komunikat pojawia się w banerze CLI, w hermes doctor i hermes update; jednorazowo wyświetla się również okno modalne w aplikacji komputerowej, a przyczyna jest widoczna w hermes plugins list. Autorzy: hermes plugins compat <path> nadal wypisuje każde file:line ze starą i nową ścieżką w formacie stara ścieżka -> nowa ścieżka oraz kończy działanie z kodem 1, dopóki pozostają jakiekolwiek wystąpienia (można dodać --json, aby uzyskać dane w formacie przeznaczonym do przetwarzania maszynowego). Użytkownicy zależni od nieutrzymywanego pluginu nadal mogą ustawić plugins.allow_deprecated_imports: true w config.yaml — musi to być dosłowna wartość logiczna YAML, a nie ciąg znaków w cudzysłowie — i rozwiązanie to wciąż działa, ponieważ commit wycofujący, który usuwa stare ścieżki, nie został jeszcze wdrożony: manifest i shims są obecne w v2026.9.14, v2026.9.21, v2026.9.24 oraz w main według stanu na 24 września (w okresie v0.21.4 moduł zgodności zmieniono jedynie w celu buforowania skanów pluginów i normalizowania ścieżek systemu Windows; w okresie v0.21.5 plik hermes_cli/plugin_compat.py pozostał bez zmian, a usunięto wyłącznie wpisy manifestu dotyczące skasowanego modułu Hindsight). Ta furtka przestanie działać w chwili wdrożenia tego commitu wycofującego, ponieważ same stare ścieżki znikną. Uwzględniono wyłącznie publiczne nazwy najwyższego poziomu; nazwy prywatne i punkty zaczepienia używane przez monkeypatch w testach nigdy nie stanowiły obsługiwanej powierzchni i nie są przywracane.⁴²⁵³

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 foldery ~/.clawdbot i ~/.moldbot) i zapisuje je w ~/.hermes.⁶

Importowane bezpośrednio (ponad 30 kategorii): SOUL.md, MEMORY.md, USER.md, AGENTS.md, umiejętności z 4 folderów źródłowych, model domyślny, niestandardowi dostawcy, serwery MCP, tokeny i listy dozwolonych użytkowników platform komunikacyjnych (Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), domyślne ustawienia agenta (poziom wnioskowania, kompresja, opóźnienie imitujące człowieka, strefa czasowa, sandbox), zasady resetowania sesji (obecnie nieaktywne: od wersji v0.21.1 liczniki czasu nigdy nie przełączają konwersacji⁴³), 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 przeglądu: zadania cron, wtyczki, hooki/webhooki, backend pamięci (QMD), konfiguracja rejestru umiejętności, interfejs/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

„Nie skonfigurowano dostawcy wnioskowania. Uruchom polecenie ‘hermes model’, aby wybrać dostawcę i model”

To pierwszy błąd pojawiający się po każdej nowej instalacji: Hermes nie ma jeszcze ustalonego dostawcy. Komunikat oznacza dokładnie to, co mówi — żadna z trzech ścieżek uwierzytelniania nie zapewniła działającego dostawcy. Należy uruchomić:

hermes model

Interaktywny selektor prowadzi przez wszystkich obsługiwanych dostawców, w tym procedury z kodem urządzenia OAuth (Nous Portal, GitHub Copilot, Anthropic, OpenAI Codex) oraz niestandardowe punkty końcowe dla samodzielnie hostowanych serwerów. Jeśli dostawca miał być już skonfigurowany, 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 przez hermes config set, a nie w profilu powłoki), wygasłe dane uwierzytelniające OAuth w ~/.hermes/auth.json albo niestandardowy punkt końcowy w config.yaml, który utracił wartość base_url. Szczegółowe informacje o ścieżkach uwierzytelniania znajdują się w sekcji Uwierzytelnianie i dostawcy.²⁷

„Nie ustawiono klucza API”

Aby interaktywnie skonfigurować dostawcę, należy uruchomić hermes model albo wykonać polecenie hermes config set OPENROUTER_API_KEY your_key. Polecenie hermes doctor dokładnie wskaże brakujące klucze.⁷

„Limit kontekstu: 2048 tokenów” podczas uruchamiania (modele lokalne)

Hermes automatycznie wykrywa długość kontekstu za pośrednictwem punktu końcowego /v1/models serwera, jednak wiele lokalnych serwerów zgłasza niskie wartości domyślne. Należy ustawić ją 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 się wykonywać

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

Odpowiedzi urywają się w połowie zdania

Możliwe są dwie przyczyny:²

1. Niski limit wyjściowy (max_tokens) na serwerze — SGLang domyślnie 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.

„Odmowa połączenia” z WSL2 do serwera modelu działającego w systemie Windows

WSL2 korzysta z wirtualnej karty sieciowej z własną podsiecią — localhost wewnątrz WSL2 odnosi się do maszyny wirtualnej z systemem Linux, a nie do hosta Windows. Dostępne są dwie możliwości:²

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

[wsl2]
networkingMode=mirrored

Następnie należy wykonać wsl --shutdown i uruchomić środowisko ponownie. localhost będzie odtąd działać w obu kierunkach.

Zastępczy adres IP hosta (starsze wersje 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 — dla Ollama należy ustawić OLLAMA_HOST=0.0.0.0, dla llama-server/SGLang dodać --host 0.0.0.0, a w LM Studio włączyć opcję „Serve on Network”.²

Budżet iteracji ignoruje agent.max_turns

Jeśli wiersz aktywności pokazuje N/90 (lub inny nieaktualny limit), mimo że w config.yaml widnieje agent.max_turns: 500, prawdopodobną przyczyną jest nieaktualny wpis HERMES_MAX_ITERATIONS w ~/.hermes/.env: kreator konfiguracji zapisywał wcześniej budżet w obu miejscach, a jeśli mechanizm pomostowy podczas uruchamiania przerwie działanie z powodu wcześniejszego błędu analizy konfiguracji, pozostałość w .env po cichu zyskuje pierwszeństwo. Od wersji v0.21.1 polecenie hermes doctor wykrywa tę kolizję, a hermes doctor --fix usuwa wpis z .env, pozostawiając config.yaml jako źródło nadrzędne.⁴¹

Gdzie wszystko się znajduje?

Pomocne są 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.⁶

Najczęściej 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 framework agenta typu open source opracowany przez Nous Research, który współpracuje z dowolnym dostawcą zgodnym z OpenAI — Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Hugging Face, Google lub własnym, samodzielnie hostowanym endpointem.¹² Hermes zawiera również gateway komunikacyjny dla Telegram/Discord/Slack/WhatsApp/Signal, którego Claude Code nie oferuje.

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

Tak. Można to zrobić na 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 konfiguracji lub token OAuth) jako rozwiązanie zapasowe

Jeśli Claude Code jest już używany na tym samym komputerze, zalecana jest opcja 2 — zachowuje ona możliwość odświeżania danych uwierzytelniających Claude.

Jak zmienić dostawcę bez utraty rozmowy?

W 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 obsługi obrazu, sieci i kompresji nie działają

W aktualnych kompilacjach ten dawny problem w zasadzie nie powinien już występować. Domyślnie (auxiliary.*.provider: "auto") każde zadanie pomocnicze — obsługa obrazu, klasyfikacja zatwierdzeń, kompresja i tytuły sesji — jest wykonywane przez główny model czatu, dlatego konfiguracja oparta wyłącznie na Anthropic obsługuje je za pomocą posiadanego już OAuth. Stary mechanizm domyślny (Gemini Flash przez OpenRouter → Nous → automatyczne wykrywanie Codex, z cichym ograniczeniem funkcjonalności, gdy żadnego z nich nie skonfigurowano) został usunięty: „auto używa teraz głównego modelu dla wszystkich zadań, a ustawienia poszczególnych zadań w config.yaml nadal mają pierwszeństwo”.³⁴

Jeśli zadanie pomocnicze nadal kończy się niepowodzeniem, należy sprawdzić, czy jawne ustawienie danego zadania nie wskazuje na nieskonfigurowanego dostawcę (auxiliary.<task>.provider / .model w config.yaml) albo czy nie pozostały nieaktualne klucze ze starszych wersji. Od tagu v2026.8.31 moduł podsumowujący na potrzeby kompresji konfiguruje się tak samo jak każde inne zadanie pomocnicze — przez auxiliary.compression.provider — a starsze klucze compression.summary_* są tam automatycznie migrowane (wersja konfiguracji 17).³¹ Wyodrębnianie treści z sieci nie jest już w ogóle zadaniem LLM („bez udziału LLM”), dlatego w aktualnych kompilacjach błąd podsumowywania treści internetowych nie wynika z problemu z modelem pomocniczym.³⁴ Aby jawnie przypisać zadanie z powrotem do głównego dostawcy:

auxiliary:
  vision:      { provider: "main" }
  compression: { 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 jest właściwy dla konkretnego projektu — opisuje architekturę, konwencje, polecenia i ścieżki — i znajduje się w katalogu projektu.¹³ Jeśli ustawienia mają obowiązywać wszędzie, należy użyć SOUL.md. Jeśli dotyczą konkretnego projektu — AGENTS.md.

Jak uruchomić obok siebie wiele instancji Hermes?

Za pomocą 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 LLM?

Tak, za pośrednictwem niestandardowego endpointu. Hermes współpracuje z dowolnym serwerem zgodnym z OpenAI: Ollama, vLLM, SGLang, llama.cpp/llama-server, LM Studio, LocalAI, Jan lub własnym.² Instrukcje konfiguracji poszczególnych serwerów zawiera sekcja Niestandardowe i samodzielnie hostowane endpointy.

Dlaczego baner startowy pokazuje mniej narzędzi, niż według przewodnika oferuje Hermes?

W przewodniku podano 47 narzędzi / 20 toolsets z rejestru architektury projektu źródłowego — jest to pełna liczba narzędzi, których kod źródłowy Hermes dostarcza we wszystkich toolsets. Uruchomiona instalacja pokazuje na banerze mniejszą liczbę (instalacja referencyjna użyta w tym przewodniku zgłasza 28 narzędzi), ponieważ podczas uruchamiania Hermes włącza wyłącznie domyślny zestaw toolsets. Wiele toolsets wymaga osobnego włączenia: adaptery gateway dla komunikatorów, automatyzacja przeglądarki, bardziej rozbudowane mechanizmy pozyskiwania danych oraz kilka wyspecjalizowanych integracji muszą zostać jawnie 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 na banerze = „co rzeczywiście załadowano w bieżącym profile”. Aby sprawdzić, które toolsets są aktywne, a które dostępne, lecz wyłączone, należy użyć hermes tools --list. Poszczególne toolsets można przełączać w czasie działania za pomocą /tools enable <name> i /tools disable <name> (wyłączenie powoduje zresetowanie sesji, aby agent odbudował manifest narzędzi zgodnie z nowym zestawem).

Jak Hermes obsługuje przełączanie na model zapasowy po awarii głównego dostawcy?

W config.yaml należy skonfigurować blok fallback_model:²

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

Gdy główny dostawca zawiedzie (limit zapytań, błąd serwera lub błąd uwierzytelniania), Hermes przełączy się na model zapasowy w trakcie sesji bez utraty historii rozmowy. Następuje to najwyżej raz na sesję.

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

Tak — właśnie na tym polega „samodoskonalenie” Hermes Agent. Agent może tworzyć, aktualizować i usuwać skills za pomocą narzędzia skill_manage. Gdy opracuje nietrywialny proces, zapisuje go 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), gdy napotka błędy i znajdzie skuteczne rozwiązanie, gdy jego sposób działania zostanie skorygowany lub gdy odkryje nietrywialny proces.

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

Historia zmian