Hermes Agent: przewodnik praktyka (2026)

TL;DR: Hermes Agent to otwartoźródłowy, samodoskonalący się agent AI od Nous Research. Działa jako CLI i jako wieloplatformowy gateway komunikacyjny, zapisuje na dysku trwałą tożsamość i trwałą pamięć, gromadzi skille ulepszające się w miarę użycia oraz współpracuje z dowolnym dostawcą LLM zgodnym z OpenAI — Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Qwen Cloud, Hugging Face, Google, xAI/SuperGrok lub własnym, samodzielnie hostowanym endpointem.¹²¹⁹ Od wersji v0.14.0 (16 maja 2026) Hermes dodaje SuperGrok OAuth z kontekstem grok-4.3 1M, lokalne proxy zgodne z OpenAI dla dostawców OAuth (hermes proxy), natywne x_search, obsługę instalacji z PyPI (wycofaną od v0.19.0 — obsługiwaną ścieżką jest instalator jednoliniowy), leniwą instalację zależności, 28 platform komunikacyjnych z LINE i SimpleX Chat, /handoff, semantyczną diagnostykę LSP po zapisach, ujednolicone video_generate, computer_use przez cua-driver dla dostawców innych niż Anthropic, natywną betę dla Windows oraz zamknięcie 12 problemów P0 / 50 P1.¹⁹ Najtrudniejszym elementem dla większości nowych użytkowników jest uwierzytelnianie dostawcy: Hermes obsługuje około 20 dostawców pierwszej klasy oraz niestandardowe endpointy, a także trzy odrębne ścieżki uwierzytelniania (klucz API w .env, OAuth przez hermes model lub niestandardowy endpoint w config.yaml). Model uwierzytelniania należy poznać najpierw — wszystko inne zależy od tego, który dostawca zostanie rozpoznany.

Hermes Agent działa jako pełne środowisko uruchomieniowe agenta, a nie nakładka do czatu. Odczytuje system plików, wykonuje polecenia w sandboxowanych backendach, przeszukuje internet, uruchamia subagentów, wykonuje zaplanowane zadania cron, komunikuje się z Telegram/Discord/Slack/WhatsApp/Signal/Email z jednego procesu gateway i tworzy własne skille na podstawie doświadczeń.¹ CLI to terminalny interfejs użytkownika zbudowany na pętli konwersacji w run_agent.py; gateway to długo działający proces, który kieruje wiadomości z platform komunikacyjnych przez tę samą pętlę konwersacji.³

Różnicę między okazjonalnym a eksperckim użyciem Hermes wyznacza pięć systemów. Po opanowaniu ich Hermes staje się mnożnikiem produktywności:

1. Rozpoznawanie dostawcy: sposób, w jaki przepływy uwierzytelniania są mapowane na wywołania API
2. Hierarchia konfiguracji: config.yaml + .env + auth.json + SOUL.md + AGENTS.md
3. System tool + toolset: co agent może zrobić, z ograniczeniami zależnymi od platformy
4. System skilli: pamięć proceduralna, którą agent tworzy i rozwija
5. Gateway + cron + profile: uruchamianie Hermes tam, gdzie się przebywa, a nie tylko tam, gdzie aktualnie się jest

Najważniejsze wnioski

• Uwierzytelnianie dostawcy to trzy ścieżki, a nie jedna. Klucz API w .env, OAuth przez hermes model/hermes auth albo niestandardowy endpoint w config.yaml. Należy wybrać ścieżkę pasującą do dostawcy, a nie tę, która wydaje się znajoma.
• Zmiana dostawców wymaga jednego polecenia. hermes model interaktywnie prowadzi przez wszystkich obsługiwanych dostawców, w tym logowania OAuth, a /model provider:model pozwala przełączyć się w trakcie sesji bez utraty historii.²
• Dwa pliki stanowią powierzchnię konfiguracji edytowalną przez użytkownika. ~/.hermes/config.yaml zawiera ustawienia, a ~/.hermes/.env przechowuje sekrety. auth.json, SOUL.md, MEMORY.md i skills/ są zarządzane bezpośrednio przez Hermes — SOUL.md można edytować ręcznie, ale pozostałe elementy są modyfikowane przez samego agenta.⁴
• Hermes jest następcą OpenClaw. Podczas migracji hermes claw migrate automatycznie importuje ponad 30 kategorii stanu.⁵
• Jakość działania zależy od modelu pomocniczego. Wizja, podsumowywanie internetu, kompresja i opróżnianie pamięci korzystają z oddzielnego pomocniczego LLM. Domyślnie jest to Gemini Flash wykrywany automatycznie (OpenRouter → Nous → Codex) — jeśli żaden z nich nie jest skonfigurowany, te funkcje działają gorzej bez wyraźnego komunikatu, dopóki sloty pomocnicze nie zostaną skierowane na głównego dostawcę.⁴

Co zmienia v0.14

v0.14.0 koncentruje się mniej na jednej funkcji nagłówkowej, a bardziej na ograniczaniu tarcia podczas konfiguracji i poszerzaniu środowisk, w których Hermes może działać.¹⁹ Główne zmiany operacyjne:

• Instalacja i uruchamianie są lżejsze. pip install hermes-agent działa z PyPI, ciężkie adaptery są instalowane leniwie przy pierwszym użyciu, a ścieżka uruchamiania odracza wystarczająco dużo pracy, by skrócić zimny start o około 19 sekund. (Od v0.19.0 instalacje przez pip zostały wycofane — zobacz Instalacja.)
• Subskrypcje mogą stać się lokalnymi endpointami API. hermes proxy przekształca dostawców opartych na OAuth, takich jak Claude Pro, ChatGPT Pro i SuperGrok, w lokalny endpoint zgodny z OpenAI dla narzędzi takich jak Codex, Aider, Cline i Continue.
• Zasięg gateway się poszerza. LINE i SimpleX Chat zwiększają liczbę platform do 22, Microsoft Teams jest podłączony od początku do końca, uzupełnianie historii Discord jest domyślnie włączone, a prompty clarify w Telegram/Discord używają teraz natywnych przycisków.
• Weryfikacja podczas zapisu ulega poprawie. Po edycjach Hermes może wyświetlać podsumowania zmian plików dla każdej tury oraz semantyczną diagnostykę serwera językowego przed następną turą, co przybliża go do pracy agentowej opartej na dowodach.
• Narzędzia desktopowe i multimedialne zyskują szerszy zakres. computer_use działa przez cua-driver dla dostawców innych niż Anthropic, video_generate jest ujednolicone za wymiennymi backendami, a vision_analyze wysyła surowe piksele do modeli, które faktycznie potrafią widzieć.

Każda poniższa sekcja opiera się na dokumentacji źródłowej dostępnej pod adresem hermes-agent.nousresearch.com/docs oraz na drzewie źródłowym github.com/NousResearch/hermes-agent. Każde stwierdzenie faktyczne ma przypis prowadzący do konkretnej strony źródłowej, z której pochodzi.

Wybierz ścieżkę

Jak działa Hermes: model mentalny

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

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

Zrozumienie tej pętli jest istotne, ponieważ każda funkcja — osobowości, pamięć, skills, kompresja i mechanizm rezerwowy — jest powiązana z jednym z tych etapów. Gdy podczas przeglądania klucza konfiguracji pojawia się pytanie o jego działanie, odpowiedź zwykle brzmi: „jest to parametr sterujący etapem 1, 2, 3 lub 4 powyższej pętli”.

Rdzeń niezależny od platformy. Jedna klasa AIAgent obsługuje CLI, gateway, ACP, tryb wsadowy i serwer API. Różnice między platformami znajdują się w punktach wejścia, a nie w samym agencie.³ Dlatego te same polecenia ukośnikowe działają zarówno w terminalu, jak i w Telegram — są obsługiwane przez wspólny COMMAND_REGISTRY w hermes_cli/commands.py.⁶

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

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

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

Co nowego w wersji v0.20.0 (wydanie The Herald)

Hermes Agent v0.20.0 (tag v2026.8.3, 3 sierpnia 2026) jest bieżącym wydaniem funkcjonalnym; v0.20.1 (13 sierpnia) i v0.20.2 (16 sierpnia) to kolejne tagi stabilizacyjne, natomiast v0.20.3 (tag v2026.8.16.2, opublikowany 17 sierpnia) i v0.20.4 (tag v2026.8.18, 18 sierpnia) podtrzymują serię wydań zbiorczych, wprowadzając własne zestawy funkcji — opisano je w podsekcji poniżej. Okres od wersji v0.19.0 obejmuje około 3 650 commitów, 1 400 scalonych PR-ów i 1 200 zamkniętych zgłoszeń, przy udziale ponad 650 współtwórców.²⁴

Trzy zmiany unieważniają instrukcje podawane we wcześniejszych wersjach tego przewodnika. Warto zapoznać się z nimi w pierwszej kolejności:

• Node 26 jest teraz wymagany. Instalator przypina NODE_VERSION="26" i odrzuca starsze środowiska wykonawcze, wyświetlając komunikat „Node.js … is too old (Hermes requires Node >=26)”. Instalatory, heal i upgrade bez wyjątku egzekwują ten wymóg. Warto zauważyć, że strona instalacyjna w dokumentacji nadal wskazuje Node v22 — skrypt instalacyjny oraz informacje o wydaniu są nowszymi i wiążącymi źródłami.²⁴
• pip i Homebrew zostały wycofane, a nie jedynie oznaczone jako przestarzałe. Dosłownie: „brew + pip/PyPI wheel channels retired (shell installer / Docker / Nix are the supported channels)”. Instalacje wykonane przez pip lub brew nie otrzymują już nowych wydań.²⁴
• Domyślny limit iteracji wywołań narzędzi zwiększono z 90 do 500. Długie autonomiczne przebiegi przestały napotykać sztuczną barierę, a wszystkie opisane poniżej progi presji na budżet są obliczane względem nowego limitu. read_file również domyślnie odczytuje teraz 2 000 wierszy zamiast 500.²⁴

Pozostałe elementy wydania:

• Głos konwersacyjny. Strumieniowe TTS z możliwością przerwania wypowiedzi oraz słowami wybudzającymi rozpoznawanymi na urządzeniu.²⁴
• A2A v1.0. Plugin protokołu komunikacji między agentami, realizujący długo oczekiwaną funkcję ze zgłoszenia nr 514.²⁴
• Podpisane wychodzące webhooki. Wcześniej hermes webhook obsługiwał wyłącznie ruch przychodzący; wersja 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 funkcji CLI dla zaawansowanych użytkowników. !command natychmiast uruchamia polecenie powłoki bez zużywania tury modelu; /init skanuje projekt i tworzy lub aktualizuje AGENTS.md; /diff pokazuje z dowolnego interfejsu zmiany przygotowane do zatwierdzenia, wszystkie zmiany albo zmiany z sesji; /context przedstawia szczegółowo zawartość wypełniającą okno kontekstu; /focus zapewnia widok z ograniczoną 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 zarządzania sekretami. Źródło sekretów wykorzystujące pomocnicze polecenie i współpracujące z każdym sejfem, rotacja tokenów jednym poleceniem wraz 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 profilu oraz zgodność SecretRef ${env:VAR} między config.yaml a konfiguracją MCP. Opisany poniżej trójścieżkowy model uwierzytelniania pozostaje bez zmian.²⁴
• Szybszy start po rozgrzaniu. Zimny start hermes -w skrócono z około 14 s do 1,8 s.²⁴
• Środowisko desktopowe stało się platformą. Artefakty z wersjonowanymi kartami i izolowanym podglądem na żywo, Plugin SDK z Kanban jako pierwszym pluginem desktopowym, globalny skrót klawiszowy szybkiego wprowadzania, wiele okien GUI, tryb zdalnego backendu SSH oraz natywne logowanie zgodne z RFC 8252.²⁴

Wydania zbiorcze v0.20.3 i v0.20.4 (17–18 sierpnia)

Po wersji v0.20.0 projekt przyjął rytm częstych tagowanych wydań zbiorczych, a dwa najnowsze obejmują więcej niż samą stabilizację. W obu zaznaczono, że „full curated release notes for this window will ship with v0.21.0” — dlatego poniższe podsumowania pochodzą z opisów zakresu zamieszczonych w samych wydaniach, a nie z opracowanej listy funkcji.²³

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

• Migracja SDK do MCP 2.x z obsługą bezstanowego protokołu z 2026-07-28. Hermes przechodzi na obecną generację MCP SDK 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, a także wzmocniona kontrola własności środowiska wykonawczego Python w podprocesach (izolacja PYTHONHOME/PYTHONPATH).²³
• Niezawodność: samonaprawiający się harmonogram cron (odzyskiwanie po EMFILE, uzgadnianie nieaktualnych przejęć, ponowne uruchamianie zablokowanych zadań), poprawki zapobiegające utracie danych podczas przekazywania sesji, samonaprawiające się połączenie desktopowe ze zdalnym gateway oraz fala przeniesionych funkcji ekosystemu (skanowanie bezpieczeństwa podczas instalacji pluginów, /worktree, zachowywanie ręcznych zmian przy /rollback, odczyt plików UTF-16).²³

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

• Szklana powierzchnia interfejsu desktopowego: matowe szkło i efekty przezroczystości z selektorem oszronienia oraz wstępnym wyborem dla macOS.²³
• Pasek boczny z kartami SESSIONS|BOTS i możliwością ukrywania oraz odkrywania poszczególnych botów, a także poprawki czatów grupowych Bot Mode (długotrwałe tury uczestników, renderowanie Markdown, trasowanie między maszynami).²³
• Doradcze skanowanie NVIDIA SkillEvaluator Tier 1 podczas instalowania skills — przy instalacji skill przeprowadzane są kontrole licencji i bezpieczeństwa.²³
• Wzmocnienie wysyłania multimediów przez cron (konfigurowalny limit czasu, załączniki przy ręcznym uruchomieniu, ujawnianie pominiętych wywołań), poprawki dotyczące wątku pętli zdarzeń i rywalizacji o zasoby w SessionDB, rzetelne informowanie o zaparkowanych gałęziach przez hermes update oraz natywne powiadomienia systemowe Kanban.²³

Sposób aktualizacji pozostaje bez zmian: hermes update w istniejącej instalacji albo instalator powłokowy w przypadku nowych instalacji.²³

Co nowego w v0.19.0 (wydanie Quicksilver)

Hermes Agent v0.19.0 (tag v2026.7.20, 20 lipca 2026) nosi nazwę na cześć szybkości samego boga posłańców: podstawą wydania jest czysta responsywność, z redukcją czasu do pierwszego tokena w pierwszej turze o ~80% na każdej platformie. Wokół tej podstawy znalazły się rozliczenia w terminalu, źródła sekretów z menedżerów haseł, inteligentne zatwierdzanie domyślnie, obserwowalne subagenty oraz odporne na awarie dostarczanie odpowiedzi. Okres od v0.18.0 jest jak dotąd największy w historii projektu: ~2 245 commitów, ~1 065 scalonych PR-ów, ~3 300 zamkniętych zgłoszeń i ponad 450 współtwórców ze społeczności.²⁵

• ~80% szybsze uzyskanie pierwszego tokena, wszędzie. Czas od zimnego wysłania do dyspozycji spadł z ~4,3 s do ~0,9 s w CLI, gateway, TUI, aplikacji desktopowej i cron — wykrywanie możliwości Discord usunięto ze ścieżki krytycznej, sprawdzanie Ollama jest pomijane dla znanych dostawców innych niż Ollama, a z inicjalizacji agenta usunięto blokujące operacje. Osobno dopracowano też odczuwalne opóźnienie: modele rozumujące domyślnie strumieniują teraz swoje rozumowanie na żywo (display.show_reasoning jest WŁĄCZONE), a pole odpowiedzi renderuje się na token, a nie na linię.²⁵
• Fala usprawnień renderowania w desktopie i TUI. Aplikacja desktopowa otrzymała przebudowę wydajnościową obejmującą ~20 PR-ów: 14× mniejsze użycie CPU przez dzielnik streamowanego Markdown dzięki przyrostowemu analizowaniu bloków, zwirtualizowane różnice w panelu przeglądu, szybkie przełączanie sesji w dużych transkrypcjach oraz brak ponownego renderowania paska bocznego i wierszy narzędzi dla każdego tokena. TUI renderuje teraz streamowany Markdown przyrostowo, blok po bloku.²⁵
• Instalacje przez pip i Homebrew są przestarzałe. Obie ścieżki oznaczono jako instalacje „nieobsługiwane, starszego typu”, z planowanym usunięciem. Usunięcie nastąpiło już w v0.20.0 — kanały brew oraz pip/PyPI wheel zostały wycofane, a obsługiwane pozostały instalator shell, Docker i Nix.²⁵²⁴
• Sekrety mogą pochodzić z menedżera haseł. Nowy rozszerzalny interfejs SecretSource pobiera podczas ładowania sekrety z Bitwarden i 1Password (odwołania op://), obsługując jednocześnie wiele sejfów, deterministyczny priorytet, ostrzeżenia o konfliktach oraz informacje o pochodzeniu każdej zmiennej — klucze API nie muszą już znajdować się w jawnym pliku .env. Przyszłych dostawców sejfów można dodawać jako pluginy.²⁵
• Inteligentne zatwierdzanie jest teraz domyślne. Gdy Hermes chce uruchomić oznaczone polecenie, niezależny recenzent LLM ocenia je zamiast pytać o każde z osobna — a każdy werdykt obejmuje wyłącznie to dokładne polecenie. Zdefiniowane przez użytkownika reguły odmowy blokują pasujące polecenia nawet w trybie YOLO, /deny <reason> przekazuje powód odmowy, aby agent skorygował działanie, a akcja zatwierdzania pre_tool_call pluginu (ponownie wdrożona z kluczami reguł) eskaluje wywołanie narzędzia do zatwierdzenia przez człowieka.²⁵
• Rozliczenia w terminalu: /subscription i /topup. Planem Nous Portal można zarządzać bez opuszczania terminala — sprawdzać plan i pozostały limit, dokładnie podejrzeć koszt ulepszenia lub moment wejścia w życie obniżenia planu, a następnie zastosować zmianę z możliwością cofnięcia. Aplikacja desktopowa otrzymuje odpowiadającą temu kartę ustawień rozliczeń.²⁵
• Obserwuj pracę subagentów; nigdy nie trać gotowej odpowiedzi. Zwracane przez delegate_task dyspozycje zapisują transkrypcje na żywo, które można śledzić za pomocą tail -f natychmiast po uruchomieniu subagentów — każde wywołanie narzędzia, wynik i streamowana odpowiedź, po jednym czytelnym dla człowieka dzienniku na każde dziecko. Zakończenia delegacji w tle są trwałe po ponownym uruchomieniu, a końcowe odpowiedzi gateway są zapisywane w rejestrze obowiązków dostarczenia w state.db i dostarczane ponownie przy następnym uruchomieniu, jeśli gateway ulegnie awarii w trakcie wysyłania. Opcja konfiguracji max_async_children jest przestarzała na rzecz ujednoliconych limitów współbieżności delegacji.²⁵
• Jeden gateway, wiele profili. Pojedynczy multipleksowany gateway współdzielący jeden token bota może kierować konkretne gildie, kanały lub wątki do różnych profili — każdy z całkowicie odizolowaną konfiguracją, skillami, pamięcią i sekretami — z zastąpieniem GATEWAY_MULTIPLEX_PROFILES. Indeks routingu przeniesiono do state.db; sessions.json jest teraz opcjonalnym starszym lustrem.²⁵
• Fala dostawców i modeli. Fireworks AI zyskuje obsługę pierwszej klasy (szacowanie kosztów, pozycja nr 2 w selektorze dostawców), a dołączają DeepInfra oraz Upstage Solar. Katalogi wzbogacają się o GPT-5.6 (Sol/Terra/Luna + Pro, podłączone kompleksowo), grok-4.5 (GA), kimi-k3 (kimi-k2.x wycofano) oraz w pełni podłączony Claude Sonnet 5. Flaga enabled: false dla każdego dostawcy oraz konfiguracja excluded_providers usuwają nieużywanych dostawców z selektorów i rozwiązywania /model.²⁵
• Wysiłek rozumowania staje się pokrętłem. Nowe poziomy wysiłku max i ultra trafiają do każdego interfejsu, z zastąpieniami dla poszczególnych modeli w konfiguracji, wysiłkiem dla każdego slotu w ustawieniach MoA (doradcy intensywnie rozumują, syntezator pozostaje szybki), wysiłkiem dla pomocniczych modeli na zadanie oraz /reasoning w CLI ograniczonym do bieżącej sesji.²⁵
• Powierzchnia CLI i MCP. hermes sessions export zapisuje formaty Markdown, Quarto, HTML, zawierający wyłącznie prompt oraz ślad Hugging Face z opcjonalnym czyszczeniem --redact; /model --once zapewnia zastąpienie modelu na jedną turę; wywołania slash-skill można łączyć w stos (/skill-a /skill-b do XYZ); --safe-mode pomaga w rozwiązywaniu problemów; hermes config get/unset uzupełniają zarządzanie konfiguracją; hermes serve staje się prawdziwym backendem bez interfejsu; a narzędzia MCP przyjmują konwencję nazewnictwa mcp__server__tool.²⁵

W przypadku aktualizacji z v0.18.x, przed wszystkim innym uwagi wymagają dwie zmiany: instalacja przez pip lub Homebrew jest teraz ostrzegana jako nieobsługiwana, starsza metoda (należy przejść na jednoliniowy instalator), a max_async_children jest przestarzałe na rzecz ujednoliconych limitów współbieżności delegacji. Wszystko pozostałe ma charakter addytywny — główne powody aktualizacji to redukcja opóźnienia pierwszej tury o ~80%, inteligentne zatwierdzanie oraz rejestr dostarczeń, który czyni gotowe odpowiedzi odpornymi na awarie.

Co nowego w v0.18.0 (wydanie Judgment)

Hermes Agent v0.18.0 (tag v2026.7.1, 1 lipca 2026) nosi nazwę na cześć osądu: agent weryfikuje własną pracę zamiast deklarować sukces, a rozumowanie zespołowe można faktycznie zbadać. Wydanie zamyka też cały backlog P0/P1 — około 692 elementy o najwyższym priorytecie rozwiązane w dwanaście dni.²²

• Mixture-of-Agents jako model pierwszej klasy. MoA można teraz wybierać jak każdy inny model we wszystkich interfejsach, a rozumowanie zespołowe jest widoczne: pełny wynik każdego modelu referencyjnego renderuje się jako własny opisany blok z odpowiedzią streamowaną na żywo — można obserwować myślenie zespołu zamiast otrzymywać nieprzejrzystą, scaloną odpowiedź.²²
• Kontrakty ukończenia dla /goal. Agent weryfikuje własną pracę, uruchamiając kontrole projektu przed zgłoszeniem ukończenia celu, zamiast deklarować sukces — osąd zastosowany wobec samego siebie.²²
• /learn — opisz dowolny proces jako skill. Proces pracy można przekształcić w wielokrotnie używany skill, opisując go; wygenerowane skille automatycznie przestrzegają konwencji CONTRIBUTING.md repozytorium.²²
• Oś czasu /journey. Wizualna historia pamięci i skilli w czasie, z możliwością edycji, oraz graf pamięci w aplikacji desktopowej.²²
• Rozproszenie zadań subagentów w tle. Można delegować wiele zadań wykonywanych równocześnie bez blokowania rozmowy — pojedynczy subagent działający w tle z v0.17.0 staje się całą flotą.²²
• Desktop Projects. Projekty programistyczne pierwszej klasy z modelem organizacji projekt/repozytorium/pas.²²
• Gateway skalowany do zera. Gateway może przechodzić w stan uśpienia podczas bezczynności i koordynować opróżnianie, aby wdrożenia przebiegały płynnie — istotne dla osób uruchamiających Hermes jako stale działającą usługę.²²
• Obsługa Google Vertex AI. Dostęp do Gemini przez konta usługi GCP z automatycznym odświeżaniem tokena OAuth2, dołączający do katalogu dostawców.²²
• Polecenie edytora /prompt. Otwiera $EDITOR do tworzenia wielowierszowych promptów zamiast zmagania się z linią wejściową.²²

W przypadku aktualizacji z v0.17.x nic tutaj nie narusza CLI. Główne powody aktualizacji to kontrakty ukończenia (cele, które weryfikują się same), MoA pierwszej klasy z możliwymi do zbadania zespołami oraz /learn do przechwytywania skilli.

Co nowego w v0.17.0 (wydanie Reach)

Hermes Agent v0.17.0 (tag v2026.6.19, 19 czerwca 2026 r.) nazwano tak ze względu na to, jak daleko sięga teraz agent — nowe kanały komunikacji, nowi dostawcy modeli oraz głębsza kontrola nad aplikacją desktopową i dashboardem. To rozszerzenie względem v0.16.x; powierzchnia CLI pozostaje bez zmian.²¹

• Nowe kanały komunikacji. iMessage działa teraz bez przekaźnika Mac za pośrednictwem Photon Spectrum (kod urządzenia OAuth, hermes photon login); WhatsApp Business Cloud API to oficjalny adapter Meta, który zastępuje wymóg procesu mostka; SimpleX zyskuje grupy, natywne załączniki, grupowanie tekstu i automatyczną akceptację; a Raft dołącza jako dołączona wtyczka platformy z kanałem wybudzania zaprojektowanym zgodnie z zasadą privacy-by-contract.²¹
• Nowe modele i dostawcy. Katalog zyskuje 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 przez xAI OAuth, kontekst 200k). Domyślny model xAI zmieniono na grok-build-0.1, a adaptacyjne modele Anthropic stosują teraz nowoczesny kontrakt myślenia (nigdy nie wysyłają pola reasoning).²¹
• Aplikacja desktopowa i dashboard. Aplikacja desktopowa dodaje subagentów w tle ze strumieniowaniem na żywo „watch-windows” delegowanej aktywności (delegate_task(background=true)), selektor modelu Composer, możliwość ponownego przypisywania skrótów klawiaturowych, natywne powiadomienia systemu operacyjnego, wersje robocze kompozytora dla poszczególnych wątków, motywy z VS Code Marketplace oraz interfejs po japońsku i tradycyjnym chińsku. Dashboard zyskuje pełny kreator profili (modele/skills/MCP bez edycji config.yaml), globalny przełącznik profili, przeprojektowany Skills Hub ze skanowaniem bezpieczeństwa, Automation Blueprints (sparametryzowane szablony dla formularzy, poleceń slash, rozmów i dokumentacji) oraz bezpieczne logowanie zwracające 401 za bramą OAuth.²¹
• Skills i narzędzia. image_generate potrafi teraz edytować i przekształcać obraz źródłowy, a nie tylko tworzyć go od podstaw, u każdego obsługiwanego dostawcy obrazów; narzędzie memory zyskało tablicę operations do atomowego wsadowego dodawania/zastępowania/usuwania w jednym wywołaniu; nowy skill simplify-code uruchamia równoległy, trzyagentowy etap przeglądu i czyszczenia, kontrolowany przez poziom ryzyka Chesterton’s Fence; a wartość logiczna write_approval zastępuje trójstanowe write_mode.²¹
• Architektura. Subagenci w tle natychmiast zwracają uchwyt, a następnie wprowadzają wynik ponownie jako nową turę; obsługa pozyskiwania danych MCP umożliwia potwierdzenie w trakcie wywołania narzędzia, a narzędzia MCP podłączające się z opóźnieniem są udostępniane między turami (bezpiecznie dla pamięci podręcznej); cron staje się wtyczkowym CronScheduler z dostawcą zarządzanego crona Chronos; a nowy zakres Managed (/etc/hermes) pozwala administratorowi przypinać konfigurację niezmienialną dla użytkownika, wraz z przekaźnikiem Gateway-Gateway dla topologii z wieloma gatewayami.²¹
• Nowe polecenia. /version, /billing (interaktywne rozliczenia w terminalu), hermes photon login (uwierzytelnianie iMessage) oraz hermes curator run --consolidate — konsolidacja jest teraz opcjonalna, więc rutynowa kuracja w tle nie kosztuje żadnych tokenów.²¹
• Bezpieczeństwo. v0.17.0 zamyka obejście denylisty sekwencji escape powłoki, bezpiecznie odmawia działania przy brakujących modułach zatwierdzania i adapterach gatewaya z własnymi zasadami, oczyszcza środowisko dla podprocesów skryptów zadań cron, redaguje sekrety w zrzutach debugowania żądań, sprawdza konfiguracje stdio MCP pod kątem wzorców eksfiltracji oraz aktualizuje urllib3 i PyJWT, aby usunąć CVE.²¹

W przypadku aktualizacji z v0.16.x nic tutaj nie psuje CLI; są to nowe kanały, modele i powierzchnie wokół tego samego agenta. Najważniejszymi powodami aktualizacji są iMessage bez przekaźnika, oficjalne adaptery WhatsApp oraz administratorski zakres Managed.

Co nowego w v0.16.0 (wydanie Surface)

Hermes Agent v0.16.0 (tag v2026.6.5, 5 czerwca 2026 r.) nazwano tak ze względu na nowe powierzchnie, które udostępnia przed agentem opartym przede wszystkim na CLI. Najważniejsza zmiana: Hermes nie jest już dostępny wyłącznie w terminalu.²⁰

• Natywna aplikacja desktopowa. Hermes Desktop to nowa aplikacja Electron dla macOS, Linux i Windows, z instalacją jednym kliknięciem oraz samodzielną aktualizacją w aplikacji. Udostępnia okno czatu ze strumieniowaniem, przeciąganie i upuszczanie plików, wklejanie obrazów ze schowka, paletę Cmd+K, listę sesji z archiwizacją i wyszukiwaniem oraz selektor modeli na pasku stanu. Może łączyć się ze zdalnym gatewayem Hermes przez bezpieczny WebSocket, uwierzytelniając się przez OAuth lub nazwę użytkownika i hasło, z hostami zdalnymi dla każdego profilu oraz równoczesnymi sesjami wielu profili połączonymi referencjami @session między profilami. Interfejs desktopowy zawiera również pełne tłumaczenie na uproszczony chiński (简体中文) przez typowaną warstwę i18n (display.language; angielski pozostaje językiem domyślnym).²⁰
• Panel administracyjny w przeglądarce. Lokalny dashboard webowy rozwinął się z widoku stanu w pełnoprawny panel administracyjny: katalog MCP z przełącznikami włączania/wyłączania, zarządzanie poświadczeniami, tworzenie webhooków i hooków, konfigurację pamięci, kontrolki gatewaya oraz stronę System ze sprawdzaniem przed aktualizacją i Debug Share jednym kliknięciem. Nowa strona Channels konfiguruje z poziomu przeglądarki każdą platformę komunikacyjną gatewaya (Telegram, Discord, Slack i pozostałe). Uwierzytelnianie jest teraz wtyczkowe: logowanie nazwą użytkownika i hasłem, ogólny samodzielnie hostowany dostawca OIDC, hermes dashboard register dla samodzielnie hostowanego klienta OAuth oraz rotacja sesji za pomocą refresh tokenów.²⁰
• Nowe CLI i polecenia slash. /undo [N] tworzy kopię zapasową ostatnich N tur użytkownika z uprzednim wypełnieniem i miękkim usunięciem oraz działa w CLI, TUI i na wszystkich platformach komunikacyjnych. Konfigurowalny domyślny interfejs (cli lub tui) pojawia się wraz z nadpisaniem --cli; TUI zyskuje ujednolicone polecenie /model i nakładkę Sessions. hermes portal to czytelny dla człowieka alias przepływu wdrażania Nous Portal, z nowymi ścieżkami pierwszego uruchomienia Quick Setup i Full Setup, a także dwoma narzędziami diagnostycznymi: hermes prompt-size i hermes sessions optimize.²⁰
• Nowe modele i dostawcy. Selektor zyskuje deepseek-v4-flash, MiniMax-M3 (kontekst 1M, natywni dostawcy MiniMax), qwen3.7-plus (Nous + OpenRouter) oraz gemini-3.5-flash (Gemini OAuth + klucz API). Pierwszorzędny dostawca xAI Grok OAuth dołącza do launchera desktopowego, selektor modeli otrzymuje wyszukiwanie przybliżone na każdej powierzchni, dostawcy z wieloma endpointami są grupowani w jednym wierszu, a odświeżanie katalogu zmieniono z codziennego na cogodzinne.²⁰
• Lżejsze skills i progresywne ujawnianie. Domyślny zestaw skills pozbył się redundantnych i martwych skills (Spotify przeniesiono do natywnej wtyczki, Linear do hermes mcp install linear, a kilka nieaktualnych pozycji usunięto), więcej przeniesiono do opcjonalnych i dodano bramę trafności environments: we frontmatterze (kanban/docker/s6), która utrzymuje zależne od kontekstu skills poza indeksem 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 wtyczek zyskały progresywne (zakresowe) ujawnianie narzędzi, a błąd MCP, który zgłaszał fałszywy sukces OAuth, gdy nie uzyskano tokenu, został naprawiony.²⁰
• Bezpieczeństwo. v0.16.0 przypina poprawioną wersję Starlette (≥1.0.1) dla CVE-2026-48710 (BadHost), przenosi kontrole adresów URL SSRF poza pętlę zdarzeń w ścieżkach asynchronicznych, usuwa bearer token wnioskowania Bedrock ze środowiska podprocesu, dodaje bws_cache.json do zabezpieczenia odczytu plików, dodaje docker restart/stop/kill do listy niebezpiecznych wzorców oraz oczyszcza niewidoczny Unicode w sprawdzonej zawartości skills. Wydanie zamknęło 2 problemy P0 i 62 problemy P1, z czego 16 oznaczono jako związane z bezpieczeństwem.²⁰

W przypadku aktualizacji z v0.15.x nic z tego nie stanowi zmiany niezgodnej w samym CLI; są to dodatkowe powierzchnie i dostawcy wokół tego samego agenta. Aplikacja desktopowa i panel administracyjny są powodem aktualizacji, jeśli Hermes ma obsługiwać użytkowników nieterminalowych lub jeśli zachodzi potrzeba administrowania zdalnym gatewayem z przeglądarki.

Instalacja

Jednolinijkowy instalator jest obsługiwaną ścieżką instalacji. Obsługuje Python, uv, Node.js, ripgrep, ffmpeg, klonowanie repozytorium, środowisko wirtualne i globalne polecenie hermes.⁷

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Instalacje przez pip i Homebrew są wycofane od wersji v0.19.0. Pakiet PyPI wprowadzony w v0.14.0 (pip install hermes-agent) oraz formuła Homebrew są teraz oznaczone jako instalacje „unsupported legacy” — każda powierzchnia wyświetla ostrzeżenie (bez blokowania), gdy Hermes wykryje jedną z nich, a zaprzestanie publikowania w PyPI/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 Android).⁷ Natywny Windows jest teraz platformą Tier 1, a nie wczesną betą dostarczoną w v0.14.0 — można go zainstalować przez iex (irm https://hermes-agent.nousresearch.com/install.ps1). Dokumentacja wyraźnie wskazuje jedno zastrzeżenie: obsługa macOS dotyczy wyłącznie Apple Silicon, a komputery Intel Mac nie są obsługiwane.²⁴ Historycznie v0.14.0 dodała natywną obsługę Windowsa we wczesnej becie za pomocą instalatora PowerShell, ale WSL2 pozostaje bezpieczniejszą rekomendacją do zastosowań produkcyjnych, dopóki ścieżka dla Windowsa nie dojrzeje.¹⁹

Po zakończeniu:

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

Jedynym wymaganiem wstępnym jest git. Instalator automatycznie zapewnia Python 3.11 przez uv (bez potrzeby używania sudo), Node.js 26 (do automatyzacji przeglądarki i mostka WhatsApp), ripgrep oraz ffmpeg. Node 26 jest bezwzględnym minimum od v0.20.0 — instalator odrzuca każdą starszą wersję i instaluje Node zarządzany przez Hermes.²⁴⁷

Weryfikacja instalacji

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

hermes doctor dokładnie wskazuje, czego brakuje i jak to naprawić.⁷ hermes dump to polecenie diagnostyczne, które należy wkleić do zgłoszenia GitHub lub wątku na Discordzie podczas prośby o pomoc — jest to tekstowe podsumowanie całej konfiguracji z usuniętymi sekretami.⁸

Instalacja ręczna

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

Polecenie instalacji Termux jest inne — używa pip z plikiem ograniczeń, a nie uv pip:

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

Wynika to z faktu, że .[all] w Androidzie pobiera faster-whisper przez dodatek voice, który zależy od pakietów ctranslate2 niepublikowanych dla Androida.⁷

Uwierzytelnianie i dostawcy

Hermes obsługuje około 22 dostawców pierwszej klasy oraz własne endpointy (v0.19.0 dodaje Fireworks AI, DeepInfra i Upstage Solar), a także trzy odrębne ścieżki uwierzytelniania. Poniżej przedstawiono cały obszar uwierzytelniania, uporządkowany według ścieżek, aby łatwo znaleźć tę odpowiadającą posiadanej konfiguracji.

Trzy ścieżki uwierzytelniania

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

Ścieżka 1 — klucz API w .env. Klucz należy umieścić w ~/.hermes/.env; Hermes odczyta go podczas uruchamiania. Ta metoda jest używana przez 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ść dostawców zewnętrznych.² Od v0.19.0 klucz nie musi już znajdować się w pliku tekstowym: rozszerzalny interfejs SecretSource może podczas ładowania pobierać sekrety z Bitwarden lub 1Password (odwołania op://), z równoczesną obsługą wielu sejfów, deterministycznym pierwszeństwem, ostrzeżeniami o konfliktach i pochodzeniem każdej zmiennej — .env pozostaje rozwiązaniem awaryjnym. (Różni się to od tokenu bootstrap Bitwarden Secrets Manager z v0.15.0, który konsolidował klucze dostawców za jednym tokenem; SecretSource zastępuje sam plik tekstowy, a przyszli dostawcy sejfów będą dodawani jako pluginy.)²⁵

Ścieżka 2 — OAuth przez hermes model lub hermes auth. Uruchamia przepływ kodu urządzenia, otwiera przeglądarkę i zapisuje poświadczenia w ~/.hermes/auth.json (może również zaimportować istniejące poświadczenia z narzędzi takich jak Claude Code lub Codex CLI). Korzystają z niej Nous Portal, OpenAI Codex (konto ChatGPT), GitHub Copilot i Anthropic (Claude Pro/Max).²

Ścieżka 3 — własny endpoint w config.yaml. Dla każdego zgodnego z OpenAI API — Ollama, vLLM, SGLang, llama.cpp, LM Studio, proxy LiteLLM, Together AI, Groq, Azure OpenAI lub własnego serwera hostowanego samodzielnie. Konfigurowany jednokrotnie przez hermes model → Custom endpoint, a następnie utrwalany w config.yaml.²

Pełna macierz dostawców

Poniżej znajduje się kompletna lista dostawców pierwszej klasy wraz z dokładnym procesem konfiguracji każdego z nich.²

Od v0.19.0 można także ukryć nieużywanych dostawców: flaga enabled: false dla każdego dostawcy oraz klucz konfiguracji excluded_providers usuwają ich z selektorów /model i wbudowanego rozpoznawania dostawców.²⁵

Anthropic: trzy metody uwierzytelniania

Anthropic ma własną sekcję, ponieważ Hermes obsługuje trzy odrębne ścieżki do Claude, a wybór właściwej ma znaczenie. Z dokumentacji źródłowej:²

# 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 przez hermes model, Hermes preferuje własny magazyn poświadczeń Claude Code zamiast kopiowania tokenu do ~/.hermes/.env. Dzięki temu odnawialne poświadczenia Claude pozostają odnawialne.² Jeśli Claude Code jest już używany na tym samym komputerze, jest to najczystsza ścieżka.

Aby na stałe przypiąć 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średni Copilot API (zalecany) oraz Copilot ACP (który uruchamia lokalny Copilot CLI 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

Uwierzytelnianie jest sprawdzane w następującej kolejności, zgodnie z dokumentacją źródłową:² 1. Zmienna środowiskowa COPILOT_GITHUB_TOKEN 2. Zmienna środowiskowa GH_TOKEN 3. Zmienna środowiskowa GITHUB_TOKEN 4. Awaryjnie: CLI gh auth token 5. Logowanie kodem urządzenia OAuth przez hermes model

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

Chińscy dostawcy AI (obsługa pierwszej klasy)

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

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

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

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

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

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

Bazowe URL-e 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 dostawcy z.ai/GLM Hermes sonduje wiele endpointów (globalne, China i warianty coding), aby znaleźć taki, który akceptuje klucz API. Działający endpoint jest automatycznie zapisywany w pamięci podręcznej — dla większości użytkowników GLM_BASE_URL nie jest potrzebny.²

xAI (Grok) automatycznie włącza cache promptów. Gdy bazowy URL zawiera x.ai, Hermes wysyła nagłówek x-grok-conv-id z każdym żądaniem, aby kierować je do tego samego serwera w ramach sesji rozmowy i ponownie wykorzystywać cache promptów systemowych oraz historii.² Działa automatycznie; konfiguracja nie jest wymagana.

Polecenie hermes auth

hermes auth to polecenie do zarządzania poświadczeniami dla pul 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ą rotowanie wielu kluczy API lub tokenów OAuth dla tego samego dostawcy — jest to przydatne do rozkładania limitów szybkości między wiele kluczy bez zmiany kodu.⁶ Starsze polecenia hermes login / hermes logout zostały usunięte; należy używać zamiast nich hermes auth.⁶

Własne endpointy i endpointy hostowane samodzielnie

Hermes działa z każdym endpointem API zgodnym z OpenAI. Jeśli serwer implementuje /v1/chat/completions, można wskazać go Hermes.²

Konfiguracja interaktywna (zalecana):

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

Ręczny config.yaml:

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

Oba podejścia zapisują konfigurację w config.yaml, który jest pojedynczym źródłem prawdy dla głównego modelu, dostawcy i bazowego URL-a.² Starsze zmienne środowiskowe OPENAI_BASE_URL i LLM_MODEL nie są już odczytywane do konfiguracji głównego modelu — należy użyć hermes model lub bezpośrednio edytować config.yaml.² (OPENAI_BASE_URL + OPENAI_API_KEY są nadal respektowane jako rozwiązanie awaryjne dla pomocniczej ścieżki routingu provider: "main", dlatego nie należy usuwać ich bez zastanowienia, jeśli są tam używane.)⁴

Przełączanie własnych 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 argumentu, bez nazwy modelu) odpytuje API /v1/models endpointu i automatycznie wybiera model, jeśli załadowano dokładnie jeden — przydatne dla lokalnych serwerów uruchamiających pojedynczy model.²

Lokalne serwery LLM (szablony konfiguracji)

Dokumentacja źródłowa zawiera kompletne przewodniki konfiguracji dla Ollama, vLLM, SGLang, llama.cpp i LM Studio. Poniżej znajdują się kluczowe polecenia, które rzeczywiście trzeba uruchomić. Każde z nich ma utworzyć działający endpoint, na który można wskazać Hermes.²

Ollama — najprostsza lokalna ścieżka, bez konfiguracji:

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

Kluczowy problem z Ollama: Ollama domyślnie używa bardzo małych długości kontekstu (4096 tokenów przy mniej niż 24 GB VRAM). Należy je zwiększyć przez OLLAMA_CONTEXT_LENGTH lub Modelfile — zgodny z OpenAI API nie akceptuje długości kontekstu od klienta, więc Hermes nie może ustawić jej za użytkownika.² Do pracy agentowej należy ustawić co najmniej 16k–32k.

vLLM — wysokowydajne serwowanie GPU:

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

Wywoływanie narzędzi wymaga --enable-auto-tool-choice 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 serwowanie z RadixAttention do ponownego używania cache 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

Problem z SGLang: domyślne max_tokens wynosi 128. Należy ustawić --default-max-tokens na serwerze lub skonfigurować model.max_tokens w config.yaml, jeśli odpowiedzi są obcinane.²

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

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

--jinja jest wymagane do wywoływania narzędzi. Bez tej flagi llama-server całkowicie ignoruje parametr tools, a model próbuje wywoływać narzędzia, zapisując JSON w tekście odpowiedzi — czego Hermes nie może zinterpretować jako rzeczywistych wywołań narzędzi.²

LM Studio — aplikacja desktopowa z GUI:

Serwer należy uruchomić z aplikacji LM Studio (karta Developer → Start Server) albo przez CLI: lms server start (uruchamia na porcie 1234) i lms load qwen2.5-coder --context-length 32768.² Następnie należy wskazać hermes model na http://localhost:1234/v1.

Kluczowy problem z LM Studio: LM Studio odczytuje długość kontekstu z metadanych modelu, lecz wiele modeli GGUF zgłasza domyślne wartości 2048 lub 4096. Zawsze należy ustawić długość kontekstu jawnie w ustawieniach modelu LM Studio — kliknąć ikonę koła zębatego obok selektora modelu, ustawić „Context Length” na co najmniej 16384 (najlepiej 32768) i ponownie załadować model.²

Nazwane własne dostawcy

Jeśli pracuje się z wieloma własnymi endpointami (na przykład lokalnym serwerem deweloperskim i zdalnym serwerem GPU), należy zdefiniować je jako nazwanych własnych dostawców w config.yaml:²

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

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

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

Nazwane własne dostawcy można również wybrać z interaktywnego menu hermes model.²

Architektura rozszerzalnych dostawców (v0.13.0+)

v0.13.0 dostarcza ABC ProviderProfile oraz katalog plugins/model-providers/, dzięki czemu zewnętrzni dostawcy inferencji mogą być dodawani bez modyfikacji rdzenia.¹⁸ Jeśli dostawca obsługuje tryb API zgodny z OpenAI, Anthropic lub Codex, można zaimplementować podklasę ProviderProfile, która deklaruje ścieżkę uwierzytelniania, bazowy URL, katalog modeli i nagłówki cache; Hermes rozpoznaje ją przez tę samą ścieżkę runtime_provider.py, której używają wbudowani dostawcy. To zmiana architektoniczna stojąca za rozszerzeniem dostawców w v0.13.0: zamiast edytować kod rdzenia, aby dodać dostawcę, dostarcza się plugin.

Lokalny proxy zgodny z OpenAI (v0.14.0+)

hermes proxy udostępnia lokalny endpoint zgodny z OpenAI, oparty na dostawcy OAuth, do którego Hermes jest już zalogowany — Claude Pro, ChatGPT Pro, SuperGrok lub innym zgodnym skonfigurowanym dostawcy.¹⁹ Oznacza to, że narzędzia oczekujące API w stylu OpenAI, w tym Codex CLI, Aider, Cline, Continue lub własne skrypty, mogą ponownie wykorzystywać uwierzytelnianie Hermes oparte na subskrypcji bez oddzielnego klucza API. Proxy należy traktować jako lokalną infrastrukturę deweloperską: wiązać go świadomie, nie udostępniać szeroko i pamiętać o warunkach specyficznych dla dostawcy.

Wykrywanie długości kontekstu

Zgodnie z dokumentacją źródłową stale 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 używa go, aby zdecydować, kiedy skompresować historię.
• model.max_tokens — limit wyjścia (maksymalna liczba tokenów, które model może wygenerować w pojedynczej odpowiedzi). Nie ma związku z długością historii.

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

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

Hermes używa wieloźródłowego łańcucha rozpoznawania okien kontekstu: nadpisanie konfiguracji → własny dostawca dla modelu → trwały cache → endpoint /models → Anthropic /v1/models → OpenRouter API → Nous Portal → models.dev (rejestr społecznościowy zawierający ponad 3800 modeli) → wartości awaryjne (128K).² System uwzględnia dostawcę, dlatego ten sam model może mieć inne limity kontekstu zależnie od tego, kto go udostępnia (np. claude-opus-4.6 ma 1M bezpośrednio w Anthropic, lecz 128K w GitHub Copilot).²

Inteligentne routowanie modeli: rotacja dostawców i fallback

Hermes nie przypisuje użytkownika na stałe do jednego modelu u jednego dostawcy. Inteligentne routowanie modeli to zbiór mechanizmów decydujących, który dostawca i model faktycznie obsługuje dane żądanie: pule poświadczeń rozpraszają obciążenie między kluczami, skonfigurowany fallback przejmuje obsługę, gdy podstawowy model zawiedzie, a opisane niżej sloty pomocnicze niezależnie kierują zadania poboczne do tańszych modeli zamiast głównego modelu.²⁶ Te trzy elementy należy skonfigurować razem — to różnica między agentem, który zatrzymuje się na limicie szybkości, a takim, który nadal pracuje.

Pule poświadczeń. Gdy dla tego samego dostawcy dostępnych jest wiele kluczy API, strategię rotacji należy skonfigurować za pomocą hermes auth. Tak rozkłada się limity szybkości między wiele kluczy.⁶

Model fallback. Należy skonfigurować zapasowe provider:model, na które Hermes automatycznie przełączy się, gdy podstawowy model zawiedzie (limity szybkości, błędy serwera, błędy uwierzytelniania):²

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

Fallback zmienia model i dostawcę w trakcie sesji bez utraty rozmowy. Uruchamia się najwyżej raz na sesję.² Obsługiwani dostawcy fallback: openrouter, nous, openai-codex, copilot, copilot-acp, anthropic, huggingface, zai, kimi-coding, minimax, minimax-cn, deepseek, ai-gateway, opencode-zen, opencode-go, kilocode, alibaba, custom.²

Modele pomocnicze

Hermes używa lekkich modeli „pomocniczych” do zadań pobocznych: analizy obrazów, podsumowywania stron internetowych, analizy zrzutów ekranu przeglądarki, klasyfikacji zatwierdzania niebezpiecznych poleceń, kompresji kontekstu, podsumowywania wyszukiwania sesji, dopasowywania skillów, wysyłania narzędzi MCP oraz opróżniania pamięci.⁴ Domyślnie korzystają one z Gemini Flash przez automatyczne wykrywanie (OpenRouter → Nous → Codex).

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

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

Opcja dostawcy "main" oznacza „użyj dostawcy mojego głównego agenta” — jest prawidłowa wyłącznie w konfiguracjach auxiliary:, compression: i fallback_model:. Nie jest prawidłowa dla ustawienia model.provider najwyższego poziomu. W przypadku używania własnego endpointu zgodnego z OpenAI jako głównego modelu należy ustawić provider: custom w sekcji model:.⁴

Dlaczego to ważne: jeśli skonfigurowano wyłącznie Anthropic OAuth (bez klucza OpenRouter), analiza obrazu, podsumowywanie sieci i kompresja ulegną pogorszeniu lub przestaną działać, ponieważ domyślny łańcuch fallback zadań pomocniczych najpierw próbuje OpenRouter. Należy dodać OPENROUTER_API_KEY dla zadań pomocniczych albo skonfigurować każdy slot pomocniczy tak, aby używał głównego dostawcy:

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

To najczęstszy problem typu „moje funkcje po cichu nie działają” u nowych użytkowników Hermes.

System konfiguracji

Hermes ma warstwowy system konfiguracji. Zrozumienie kolejności pierwszeństwa jest niezbędne, ponieważ warstwy wyższe zastępują niższe, a jedną z warstw jest globalny rejestr dostawców, którego nie widać w config.yaml.

Układ plików konfiguracyjnych

Zgodnie z dokumentacją upstream są to pliki tworzące konfigurację Hermes:⁴

~/.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 ustawiono oba, dla ustawień innych niż sekrety pierwszeństwo ma config.yaml.⁴ Zasada jest następująca: - Sekrety (klucze API, tokeny botów, hasła) → .env - Wszystko pozostałe (model, backend terminala, ustawienia kompresji, limity pamięci, toolsety) → config.yaml

Do sekretów można odwoływać się z poziomu config.yaml, używając interpolacji w stylu powłoki:⁴

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

Zarządzanie konfiguracją

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

Przykłady:⁴

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

hermes config check i hermes config migrate to polecenia, które należy uruchamiać po każdej aktualizacji hermes update — wykrywają nowo dodane opcje konfiguracji, których plik jeszcze nie zawiera.⁶

Kolejność pierwszeństwa konfiguracji

Hermes ładuje konfigurację z kilku źródeł. Gdy wiele źródeł ustawia tę samą wartość, wygrywa źródło o wyższym priorytecie:⁴

1. Argumenty CLI — hermes chat --model anthropic/claude-sonnet-4 (nadpisanie dla pojedynczego wywołania)
2. Zmienne środowiskowe — stosowane podczas uruchamiania procesu
3. config.yaml — główny plik ustawień
4. .env — wyłącznie sekrety
5. Wbudowane wartości domyślne — stosowane, gdy żadne inne źródło nie ustawia wartości

Flagi CLI zawsze mają pierwszeństwo dla tego pojedynczego wywołania. config.yaml stanowi długoterminowe źródło prawdy.

Lokalizacja (v0.13.0+)

Wersja v0.13.0 dodała 7 lokalizacji dla 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 i panel webowy, dodaje 8 kolejnych lokalizacji oraz zwiększa łączną liczbę do 16.¹⁹ Dokumentacja jest obecnie zlokalizowana wyłącznie w zh-Hans. Lokalizacja jest ustalana na podstawie zmiennych środowiskowych LC_ALL / LANG albo jawnego klucza locale: w config.yaml. Angielski pozostaje domyślnym językiem i źródłem prawdy dla każdego ciągu, którego tłumaczenie jeszcze nie obejmuje.

Profile — wiele odizolowanych instancji Hermes

Profile zapewniają wiele odizolowanych instancji Hermes, z których każda ma własną konfigurację, sesje, skille, pamięć oraz PID gateway. W ten sposób można uruchomić obok siebie „służbowy Hermes” i „prywatny Hermes”, bez możliwości wglądu każdej z nich w stan drugiej.⁶

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 profil otrzymuje własny HERMES_HOME (domyślnie ~/.hermes-<name>/), dzięki czemu wiele profili może jednocześnie uruchamiać gateway, nie kolidując ze sobą.⁶³

Polecenia CLI

Ta sekcja stanowi praktyczne kompendium poleceń CLI najwyższego poziomu. Autorytatywne odniesienie oparte na kodzie znajduje się w źródłowym dokumencie CLI Commands Reference.⁶

Opcje globalne

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

Polecenia najwyższego poziomu

hermes chat — Główny punkt wejścia

hermes bez argumentów otwiera interaktywny czat. hermes chat to jawna forma z opcjami:⁶

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

Najważniejsze opcje:

hermes setup — Pełny kreator

Uruchamia pełny kreator konfiguracji lub przechodzi bezpośrednio do jednej 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 — Ustrukturyzowane zapytania do logów

hermes logs jest bardziej zaawansowane niż tail -f dla plików logów, ponieważ jednocześnie obsługuje filtrowanie według poziomu, ID 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 logów znajdują się w ~/.hermes/logs/:⁶ - agent.log — cała aktywność agenta (wywołania API, wysyłanie tools, cykl życia sesji, INFO+) - errors.log — tylko ostrzeżenia i błędy (filtrowany podzbiór agent.log) - gateway.log — aktywność messaging gateway (połączenia z platformami, wysyłanie, 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 warto uruchomić, gdy coś nie działa. Sprawdza poprawność konfiguracji, obecność zależności, dostępność kluczy API, stan usługi i może próbować automatycznych napraw przy użyciu --fix.⁶

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

Polecenia slash

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

Sterowanie sesją

Konfiguracja i model

Polecenie /model stanowi podstawowe narzędzie do przełączania providerów w trakcie sesji:⁹

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

v0.19.0 dodaje /model --once — jednorazowe nadpisanie modelu na jedną turę, które po odpowiedzi automatycznie przywraca poprzedni model.²⁵

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 slash-skill można łączyć: /skill-a /skill-b do XYZ ładuje oba skills w kolejności w jednej turze, z autouzupełnianiem i tekstem podpowiedzi dla połączonych nazw.²⁵

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

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

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

Dopasowywanie prefiksów

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

Polecenia specyficzne dla komunikatorów

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

• /status — pokaż informacje o sesji
• /sethome (alias /set-home) — oznacz bieżący czat jako katalog domowy platformy
• /approve [session|always] — zatwierdź oczekujące niebezpieczne polecenie
• /deny [reason] — odrzuć oczekujące niebezpieczne polecenie. Od v0.19.0 /deny <reason> przekazuje agentowi powód odmowy, aby skorygował działanie zamiast bezmyślnie ponawiać próbę²⁵
• /update — zaktualizuj Hermes Agent do najnowszej wersji
• /commands [page] — przeglądaj wszystkie polecenia i skills (stronicowane)

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

Narzędzia i zestawy narzędzi

Hermes oferuje szeroki wbudowany rejestr narzędzi obejmujący wyszukiwanie w sieci, automatyzację przeglądarki, wykonywanie poleceń w terminalu, edycję plików, pamięć, delegowanie, trenowanie RL, wysyłanie wiadomości, integrację z Home Assistant i nie tylko.¹⁰ Narzędzia są zorganizowane w logiczne toolsets, które można włączać lub wyłączać dla każdej platformy.

Kategorie wysokiego poziomu

Typowe nazwy toolset obejmują web, terminal, file, browser, vision, image_gen, moa, skills, tts, todo, memory, session_search, cronjob, code_execution, delegation, clarify, homeassistant i 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 także przełączać w trakcie sesji za pomocą /tools disable <name> i /tools enable <name>, co resetuje sesję, aby nowy zestaw narzędzi zaczął obowiązywać.⁹

Backendy terminala

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

Backendy można przełączać za pomocą hermes config set terminal.backend <name> albo w config.yaml:

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

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

terminal:
  backend: ssh

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

Backend Docker:

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

Zasoby kontenera (dotyczy docker, singularity, modal, 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 kontenerów działają z utwardzonymi zabezpieczeniami: system plików roota tylko do odczytu (Docker), usunięte wszystkie możliwości Linux poza DAC_OVERRIDE, CHOWN i FOWNER, brak eskalacji uprawnień, limity PID (256 procesów), pełna izolacja przestrzeni nazw, trwały obszar roboczy przez woluminy.¹⁰

Procesy w tle

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

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

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

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

Sudo

Jeśli polecenie wymaga sudo, Hermes poprosi o hasło (zapamiętane w pamięci podręcznej na czas sesji). Można też ustawić SUDO_PASSWORD w ~/.hermes/.env.¹⁰

Kanban dla wielu agentów (v0.13.0+)

Wersja v0.13.0 czyni współpracę wielu agentów prymitywem pierwszej klasy: trwałą tablicą Kanban, która śledzi zadania, status i tożsamość workerów między agentami oraz po restartach.¹⁸ To właśnie tablica sprawia, że rój workerów Hermes rzeczywiście kończy pracę, zamiast zatrzymywać się na zerwanych przekazaniach.

Tablica Kanban naturalnie współpracuje z /goal (pętlą Ralph z zablokowanym celem) po stronie celu oraz z istniejącym narzędziem delegate_task dla semantyki uruchamiania. Rezultatem jest wzorzec roju, w którym każdy agent współdzieli jedno źródło prawdy o tym, co zrobić dalej, kto się tym zajmuje i co utknęło.

Czym jest rój Hermes?

Rój to kilka workerów Hermes działających równolegle względem jednej współdzielonej tablicy Kanban. Nie jest to osobny podsystem, który należy włączyć — to właśnie tablica go umożliwia. Tablica zapewnia jedną rzecz, której równoległe agenty nie potrafią zapewnić samodzielnie: pojedynczą autorytatywną odpowiedź na pytanie: co należy przejąć jako następne i czy ktoś już nad tym pracuje?

Wersja v0.15.0 podniosła ten wzorzec do rangi wspieranej topologii, dodając topologię roju do koordynacji równoległych workerów, automatyczną dekompozycję celu wysokiego poziomu na podzadania, nadpisywanie modelu dla każdego zadania, zadania zaplanowane oraz zarządzanie worktree, aby równolegli workerzy nie kolidowali w tym samym checkout.²⁸

Praktyczny schemat jest taki: należy przekazać rojowi cel, pozwolić automatycznej dekompozycji podzielić go na zadania na tablicy, a następnie pozwolić workerom je przejmować, wykonywać i zwracać wyniki. Budżet ponownych prób jest ustalany dla każdego zadania (max_retries), więc jedno podatne na błędy podzadanie nie zużywa tolerancji całego uruchomienia. Ponieważ tablica jest trwała, rój przetrwa restarty — workery ponownie się dołączają i wznawiają działanie względem tego samego stanu.

Rój jest tylko tak dobry, jak jego dekompozycja. Tablica koordynuje workery; nie zamienia źle podzielonego celu w dobrze podzielony. Zadania współdzielące ukryty stan nadal będą ze sobą kolidować, niezależnie od worktree.

System skills

Skills to dokumenty wiedzy ładowane na żądanie, które agent może wczytać w razie potrzeby. Stosują wzorzec stopniowego ujawniania, aby minimalizować użycie tokenów, i są zgodne z otwartym standardem agentskills.io.¹¹

Wszystkie skills znajdują się w ~/.hermes/skills/ — to główny katalog i źródło prawdy. Przy świeżej instalacji do tego miejsca kopiowane są dołączone skills z repozytorium. Trafiają tu również skills instalowane z Hub oraz tworzone przez agenta.¹¹

Stopniowe ujawnianie

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 wczytuje pełną zawartość 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ą pokazywać się lub ukrywać w zależności od dostępnych narzędzi. Jest to najbardziej przydatne w przypadku fallback skills — bezpłatnych lub lokalnych alternatyw, które powinny pojawiać się tylko wtedy, gdy narzędzie premium jest niedostępne:¹¹

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

Skills zarządzane przez agenta

Agent może tworzyć, aktualizować i usuwać własne skills za pomocą narzędzia skill_manage. To pamięć proceduralna agenta — gdy odkryje nietrywialny przepływ pracy, zapisuje to podejście jako skill do ponownego wykorzystania w przyszłości.¹¹

Kiedy agent tworzy skills:¹¹ - Po pomyślnym ukończeniu złożonego zadania (ponad 5 wywołań narzędzi) - Gdy napotkał błędy lub ślepe zaułki i znalazł działającą ścieżkę - Gdy użytkownik skorygował jego podejście - Gdy odkrył nietrywialny przepływ pracy

Działania:¹¹

Hub skills

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

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

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

Skanowanie bezpieczeństwa

Wszystkie skills instalowane z Hub przechodzą przez skaner bezpieczeństwa, który sprawdza eksfiltrację danych, prompt injection, destrukcyjne polecenia, sygnały dotyczące łańcucha dostaw oraz inne zagrożenia.¹¹

Poziomy zaufania:¹¹

--force może nadpisać niedangerous blokady zasad dla skills społecznościowych. Nie nadpisuje werdyktu skanowania dangerous.¹¹

Zewnętrzne katalogi skills

Można wskazać Hermes dodatkowe katalogi skills 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}. Zewnętrzne katalogi są tylko do odczytu — gdy agent tworzy lub edytuje skill, zawsze zapisuje go w ~/.hermes/skills/. W przypadku skill o tej samej nazwie w obu miejscach pierwszeństwo ma wersja lokalna.¹¹

Trwała pamięć

Hermes ma ograniczoną, starannie dobraną pamięć, która jest zachowywana między sesjami. Na pamięć agenta składają się dwa pliki przechowywane w ~/.hermes/memories/:¹²

Oba pliki są wstrzykiwane do system prompt jako zamrożony snapshot na początku sesji. Agent zarządza własną pamięcią za pomocą narzędzia memory — add, replace lub remove.¹²

Wzorzec zamrożonego snapshotu: zawartość wstrzykiwana do system prompt jest przechwytywana jednorazowo na początku sesji i nie zmienia się w jej trakcie. Jest to celowe — pozwala zachować cache prefiksu LLM dla wydajności. Zmiany wprowadzone podczas sesji są natychmiast zapisywane na dysku, lecz nie pojawiają się w system prompt aż do kolejnej sesji.¹²

Co zapisywać

Należy zapisywać następujące informacje (agent robi to proaktywnie):¹² - Preferencje użytkownika: „Preferuję TypeScript zamiast JavaScript” → user - Informacje o środowisku: „Ten serwer działa na Debianie 12 z PostgreSQL 16” → memory - Korekty: „Nie używaj sudo do poleceń Docker, użytkownik należy do grupy docker” → memory - Konwencje: „Projekt używa tabulatorów, szerokości linii 120 znaków i docstringów w stylu Google” → memory - Ukończona praca: „Baza danych została zmigrowana z MySQL do PostgreSQL 2026-01-15” → memory

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

Wyszukiwanie sesji

Poza MEMORY.md i USER.md agent może przeszukiwać swoje 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. Zapytania zwracają odpowiednie wcześniejsze rozmowy wraz z podsumowaniem Gemini Flash.¹²

Zewnętrzni dostawcy pamięci

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

Zewnętrzni dostawcy działają równolegle z wbudowaną pamięcią (nigdy jej nie zastępują) i dodają 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)

W danym momencie może być aktywny tylko jeden zewnętrzny dostawca. Wbudowana pamięć jest zawsze aktywna.⁶

Automatyczne wznawianie sesji (v0.13.0+)

v0.13.0 sprawia, że przerwania w trakcie działania agenta można przetrwać. Po restarcie gateway automatycznie wznawia przerwane sesje; restarty /update zachowują stan sesji podczas aktualizacji; przeładowania plików źródłowych w trakcie programowania utrzymują aktywną sesję zamiast wymuszać utworzenie nowej.¹⁸ W praktyce oznacza to, że długotrwała praca gateway i zadania uruchamiane przez cron nie resetują już okna kontekstowego po restarcie procesu.

Checkpointy v2 (v0.13.0+)

W v0.13.0 trwałość stanu została przepisana jako projekt pojedynczego magazynu z rzeczywistym usuwaniem niepotrzebnych danych, zabezpieczeniami dysku i bez osieroconych repozytoriów cieni.¹⁸ Poprzedni system checkpointów gromadził stan na dysku w profilach działających przez długi czas; magazyn v2 wprowadza twardy limit lokalnej przestrzeni na checkpointy i usuwa zduplikowane księgowanie, które powodowało ten wzrost. Nie jest wymagana żadna zmiana konfiguracji widoczna dla użytkownika; następny zapis checkpointu użyje ścieżki v2.

Osobowość i SOUL.md

SOUL.md stanowi podstawową tożsamość instancji Hermes. Zajmuje pozycję nr 1 w system prompt, zastępując zakodowaną na stałe domyślną tożsamość.¹³

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

Co należy umieścić w SOUL.md

Należy używać go do trwałych wskazówek dotyczących głosu i osobowości:¹³ - ton - styl komunikacji - poziom bezpośredniości - domyślny styl interakcji - elementy, których należy unikać stylistycznie - sposób, w jaki Hermes powinien radzić sobie z niepewnością, niezgodą i niejednoznacznością

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

Te informacje należą do AGENTS.md, a nie do 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, zachowanie na poziomie osobowości.

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

Przydatna zasada: jeśli dana informacja powinna towarzyszyć użytkownikowi wszędzie, należy umieścić ją w SOUL.md. Jeśli dotyczy projektu, należy umieścić ją w AGENTS.md.¹³

Wbudowane osobowości

Hermes zawiera wbudowane osobowości, na które można przełączyć 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 należy przełączyć się za pomocą /personality codereviewer.

SOUL.md a /personality

SOUL.md określa podstawowy głos. /personality to nakładka na poziomie sesji.¹³ Warto zachować pragmatyczny domyślny SOUL.md, a następnie użyć /personality teacher podczas rozmowy dydaktycznej lub /personality creative do burzy mózgów.

Nous Tool Gateway (v0.10.0+)

Od Hermes Agent v0.10.0 (16 kwietnia 2026 r.) płatni subskrybenci Nous Portal otrzymują zarządzany dostęp do wyselekcjonowanego zestawu narzędzi za pośrednictwem swoich dotychczasowych danych uwierzytelniających Portal — bez dodatkowych kluczy API do zarządzania.³⁰ Sam CLI Hermes pozostaje objęty licencją MIT i w pełni open source. Zmieniło się to, że uwierzytelnianie w Portal odblokowuje teraz więcej niż tylko inferencję modeli.

Co obejmuje gateway

Jak to działa

Gateway jest włączany opcjonalnie dla każdego narzędzia za pomocą nowego pola konfiguracji use_gateway. Jeśli dane uwierzytelniające Portal znajdują się w hermes auth i gateway jest włączony dla narzędzia, wywołania tego narzędzia 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

Pierwszeństwo w czasie wykonywania: gdy gateway jest dostępny i narzędzie ma ustawienie use_gateway: true, Hermes preferuje gateway, nawet jeśli skonfigurowano również bezpośredni klucz API. Ma to znaczenie dla rozliczeń — wywołania gateway wykorzystują subskrypcję Portal, a nie saldo 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 Portal OAuth, które już znajdują się w hermes auth — nie ma osobnego kroku logowania. Od wersji v0.19.0 można także zarządzać samą subskrypcją w sesji: /subscription pokazuje plan i pozostały limit, precyzyjnie wskazuje koszt uaktualnienia lub moment wejścia w życie obniżenia planu oraz stosuje zmianę z banerami zaplanowanej zmiany i możliwością cofnięcia; /topup dodaje środki. Aplikacja desktopowa ma odpowiadającą temu kartę ustawień rozliczeń.²⁵

Cennik i dostęp

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

Informacja o wycofaniu

• Zmienna środowiskowa HERMES_ENABLE_NOUS_MANAGED_TOOLS została usunięta w v0.10.0. Narzędzia zarządzane są teraz włączane za pomocą pola konfiguracji use_gateway dla danego narzędzia i zależą od stanu subskrypcji Portal.³⁰

Ujęcie: czym to wydanie nie jest

CLI Hermes Agent nie jest zablokowany za subskrypcją. Projekt nadal jest objęty licencją MIT, a wszystkie kluczowe funkcje (CLI, skills, pamięć, messaging gateway, cron, MCP, lokalny dashboard, BYOK dla każdego dostawcy) działają kompleksowo bez płacenia komukolwiek. v0.10.0 dodaje wygodną ścieżkę dla użytkowników, którzy już płacą za Nous Portal — nie usuwa niczego z bezpłatnej ścieżki.

Messaging Gateway

Hermes może działać jako długotrwały proces gateway, który z jednego procesu gateway łą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 oraz uniwersalnym adapterem Webhook.^329171819 v0.9.0 dodał iMessage przez BlueBubbles (automatyczna rejestracja webhooka, kreator konfiguracji, odporność na awarie) oraz natywną obsługę WeChat przez iLink Bot API z trybem callback WeCom dla aplikacji korporacyjnych.¹⁶ v0.11.0 dodał QQBot.²⁹ v0.12.0 dodał Microsoft Teams i Tencent Yuanbao.¹⁷ v0.13.0 dodał Google Chat jako 20. platformę, korzystając z tej samej architektury wtykowych adapterów; IRC i Microsoft Teams zostały także przeniesione na nowy wzorzec adapterów z ogólnymi hookami pluginów env_enablement_fn / cron_deliver_env_var.¹⁸ v0.14.0 dodaje LINE i SimpleX Chat oraz kompleksowo uzupełnia stos Microsoft Teams o uwierzytelnianie Graph, nasłuchiwanie webhooków, środowisko wykonawcze pipeline i dostarczanie wychodzące.¹⁹ v0.17.0 (19 czerwca 2026 r.) dodaje iMessage bez relay przez Photon Spectrum (kod urządzenia OAuth z hermes photon login — bez wymaganego relay Mac/BlueBubbles), oficjalny adapter WhatsApp Business Cloud API (zastępujący wymaganie procesu bridge), grupy SimpleX i natywne załączniki oraz Raft jako dołączony plugin platformy.²¹

Konfiguracja

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

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

Przepływ wiadomości

Z dokumentacji architektury upstream:³

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 działa w tej samej pętli rozmowy AIAgent co CLI. Dlatego polecenia slash działają w obu miejscach identycznie, a zadanie cron zaplanowane w Telegram może dostarczyć wynik do Discord — różnica między platformami występuje wyłącznie na obrzeżu.³

v0.19.0 dodaje routing wiadomości oparty na profilach oraz trwałe dostarczanie. Pojedynczy multipleksowany gateway współdzielący jeden token bota może kierować określone guilds, kanały lub wątki do różnych profili — każdy z całkowicie odizolowaną konfiguracją, skills, pamięcią i sekretami — za pomocą nadpisania GATEWAY_MULTIPLEX_PROFILES; fala utwardzania sprawia też, że jeden błędnie skonfigurowany profil nie może już unieruchomić całego gateway. W warstwie wewnętrznej indeks routingu został przeniesiony do state.db (sessions.json jest teraz opcjonalnym starszym mirrorem), a końcowe odpowiedzi są rejestrowane w trwałym rejestrze obowiązków dostarczenia wokół wysyłki platformowej — ukończona odpowiedź, którą przerwie awaria gateway, zostanie dostarczona ponownie przy następnym uruchomieniu zamiast zostać po cichu utracona.²⁵

Autoryzacja użytkowników i parowanie

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 zapobiegają komunikowaniu się przypadkowych osób z gateway. Użytkownik wysyła kod parowania z platformy komunikacyjnej; należy go zatwierdzić za pomocą hermes pairing approve; od tego momentu użytkownik jest autoryzowany.⁶

Zaplanowane zadania (Cron)

Hermes ma system cron jako funkcję pierwszej klasy, w którym zadania są zadaniami agenta, a nie poleceniami powłoki. Każde zaplanowane zadanie działa przez nowy AIAgent ze skonfigurowanym promptem, opcjonalnie dołączonymi skills, i dostarcza wyniki 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 też utworzyć zadanie konwersacyjnie w czacie komunikatora:

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ą przechowywane w JSON i przetrwają restarty.³

Integracja MCP

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

Jako klient — połącz Hermes z zewnętrznymi serwerami MCP, aby rozszerzyć jego powierzchnię 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

Lub ręcznie w config.yaml:¹⁴

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

Od v0.19.0 narzędzia MCP są udostępniane modelowi zgodnie z konwencją nazewnictwa mcp__server__tool — każda nazwa narzędzia zawiera nazwę serwera, dzięki czemu dwa serwery udostępniające to samo narzędzie nie kolidują już ze sobą — a powiadomienia z logów serwera MCP są wyświetlane w agent.log.²⁵

Jako serwer — udostępnij 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. Podsumowujący proces kompresji to osobne wywołanie LLM — można skierować je do dowolnego providera lub endpointu.⁴

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

Opcje providera:⁴

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

Ostrzeżenia o presji budżetowej

Gdy agent pracuje nad złożonym zadaniem z wieloma wywołaniami narzędzi, może zużyć budżet iteracji (domyślnie: 500 tur od v0.20.0, wcześniej 90), nie zdając sobie z tego sprawy. Presja budżetowa automatycznie ostrzega model:⁴

Limity czasu strumienia

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

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

Lokalny panel webowy (v0.9.0+)

Panel działający w przeglądarce do lokalnego zarządzania Hermes Agent. Umożliwia konfigurację ustawień, monitorowanie sesji, przeglądanie skills oraz zarządzanie gateway bez dotykania plików konfiguracyjnych ani terminala.¹⁶ Uruchom go za pomocą hermes dashboard. To najprostsza ścieżka wdrożenia dla nowych użytkowników preferujących GUI.

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

watch_patterns pozwala ustawić wzorce monitorowane w danych wyjściowych procesów w tle i otrzymywać powiadomienia w czasie rzeczywistym, gdy zostaną dopasowane.¹⁶ Można monitorować błędy, oczekiwać na określone zdarzenia („listening on port”) lub obserwować logi kompilacji — bez odpytywania. W połączeniu z notify_on_complete z v0.8.0 (które powiadamia o zakończeniu zadania w tle) Hermes oferuje teraz pełną warstwę obserwowalności procesów w tle.¹⁵

Wymienny context engine (v0.9.0+)

Zarządzanie kontekstem jest teraz wymiennym slotem dostępnym przez hermes plugins. Można podłączać własne context engines, które kontrolują, co agent widzi w każdej turze — filtrowanie, podsumowywanie lub wstrzykiwanie kontekstu specyficznego dla domeny.¹⁶ Oddziela to strategię kontekstową od głównej pętli agenta, umożliwiając dostosowanie kontekstu dla każdego projektu lub domeny.

Kopia zapasowa i przywracanie (v0.9.0+)

hermes backup tworzy pełne archiwum konfiguracji, sesji, skills i pamięci. hermes import przywraca dane z archiwum kopii zapasowej.¹⁶ Można użyć tego do migracji między urządzeniami, tworzenia migawek przed większymi zmianami lub udostępniania współpracownikom sprawdzonej konfiguracji.

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

Hermes działa natywnie na Androidzie przez Termux. Dostosowane ścieżki instalacji, optymalizacje TUI dla ekranów mobilnych, obsługa backendu głosowego oraz polecenie /image działają bezpośrednio na urządzeniu.¹⁶

Wzmacnianie zabezpieczeń (v0.13.0+)

Wersja v0.13.0 zamknęła 8 problemów bezpieczeństwa P0 i zmieniła jedno ustawienie domyślne na korzyść użytkownika.¹⁸ Wersja v0.14.0 zawiera kolejne 12 zamkniętych problemów P0 i 50 P1, w tym wzmocnienia ochrony przed brute force sudo / sudo-stdin, poprawki obejść niebezpiecznych poleceń, sanitizację błędów narzędzi przed ponownym wstrzyknięciem do modelu, uwierzytelnianie pluginów panelu API, ochronę skills-hub przed SSRF oraz skanowanie alertów łańcucha dostaw podczas instalacji.¹⁹

Jeśli utrzymuje Pan/Pani wdrożenie Hermes, należy traktować v0.13.0 i v0.14.0 jako aktualizacje istotne dla bezpieczeństwa, a nie jedynie wydania funkcji. Wersja v0.13.0 zamyka obejście między guildami Discord oraz dwa okna TOCTOU; v0.14.0 dodaje kolejną warstwę wzmocnień w obsłudze sudo, ponownym wstrzykiwaniu błędów narzędzi, pluginach API, SSRF w skills-hub i alertach dotyczących zależności.

Architektura dla praktyków

Ta sekcja jest przeznaczona dla osób, które chcą zrozumieć, co dzieje się pod maską, aby móc to debugować, rozszerzać lub analizować wydajność. To synteza 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 zaadaptowany z dokumentacji architektury projektu źródłowego.³

„47 narzędzi / 20 toolsetów” vs „28 narzędzi” w banerze. Liczba „47 narzędzi” to całkowity rejestr narzędzi w repozytorium źródłowym — wszystkie narzędzia, dla których Hermes dostarcza kod źródłowy, we wszystkich toolsetach. Faktycznie uruchomiony CLI pokaże mniejszą liczbę w swoim banerze startowym (instalacja, na podstawie której zweryfikowano ten przewodnik, raportuje 28 tools / 89 skills). To nie jest błąd. Wiele toolsetów jest opcjonalnych i należy je jawnie włączyć w config.yaml w sekcji toolsets: — adaptery platform komunikacyjnych, automatyzacja przeglądarki, bardziej wymagające narzędzia do scrapingu itd. Łączna liczba w rejestrze oznacza „co jest dostępne”; liczba w banerze oznacza „co jest włączone w bieżącym profilu”. Aktywne toolsety można sprawdzić za pomocą hermes tools --list, a poszczególne toolsety włączać lub wyłączać blokiem toolsets: w ~/.hermes/config.yaml (albo za pomocą /tools list / /tools enable <name> / /tools disable <name> w uruchomionej sesji — usunięcie narzędzia powoduje reset sesji, aby agent mógł odbudować manifest narzędzi).

Trzy tryby API

Hermes abstrahuje różnice między providerami do trzech trybów API, wybieranych automatycznie w czasie działania:³

Resolver runtime_provider.py mapuje krotki (provider, model) na (api_mode, api_key, base_url) dla ponad 18 providerów, obsługując przepływy OAuth, pule poświadczeń i rozwiązywanie aliasów.³

Przepływ danych przez sesję CLI

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

Na podstawie strony architektury projektu źródłowego.³

Kolejność składania promptu

Stos promptów obejmuje:¹³

1. SOUL.md (tożsamość agenta — lub wbudowany mechanizm zastępczy, jeśli plik jest niedostępny)
2. Wskazówki dotyczące zachowania uwzględniającego narzędzia
3. Kontekst pamięci/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 platformy
8. Opcjonalne nakładki promptu systemowego, takie jak /personality

SOUL.md jest fundamentem — wszystko inne jest na nim budowane.¹³

Przechowywanie sesji

Przechowywanie sesji oparte na SQLite z pełnotekstowym wyszukiwaniem FTS5. Sesje mają śledzenie pochodzenia (rodzic/dziecko między kompresjami), izolację według platformy oraz atomowe zapisy z obsługą rywalizacji o dostęp.³

System pluginów

Trzy źródła wykrywania: ~/.hermes/plugins/ (użytkownik), .hermes/plugins/ (projekt) oraz punkty wejścia pip. Pluginy rejestrują narzędzia, hooki i polecenia CLI za pośrednictwem kontekstu API. Providery pamięci są wyspecjalizowanym typem pluginu w plugins/memory/.³

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

Zasady projektowania

Na podstawie strony architektury 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 także starsze katalogi ~/.clawdbot i ~/.moldbot) i zapisuje je w ~/.hermes.⁶

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

Zarchiwizowane do ręcznego przeglądu: zadania cron, pluginy, hooki/webhooki, backend pamięci (QMD), konfiguracja rejestru skills, UI/tożsamość, logowanie, konfiguracja wielu agentów, powiązania kanałów, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md.⁶

Rozwiązywanie kluczy API sprawdza trzy źródła w kolejności priorytetów: wartości konfiguracji → ~/.openclaw/.env → auth-profiles.json.⁶

Rozwiązywanie problemów

„Nie skonfigurowano dostawcy inferencji. Uruchom „hermes model”, aby wybrać dostawcę i model”

Pierwszy błąd pojawiający się przy każdej świeżej instalacji: Hermes nie ma jeszcze rozpoznanego dostawcy. Oznacza dokładnie to, co mówi — żadna z trzech ścieżek uwierzytelniania nie zapewniła użytecznego dostawcy. Uruchom:

hermes model

Interaktywny selektor przeprowadza przez wszystkich obsługiwanych dostawców, w tym przepływy kodu urządzenia OAuth (Nous Portal, GitHub Copilot, Anthropic, OpenAI Codex) oraz niestandardowe endpointy dla serwerów hostowanych samodzielnie. Jeśli dostawca miał być już skonfigurowany, hermes doctor pokaże, które poświadczenia Hermes faktycznie widzi; zwykle przyczyną jest klucz API ustawiony w niewłaściwym miejscu (powinien znajdować się w .env lub być ustawiony przez hermes config set, a nie w profilu powłoki), wygasłe poświadczenie OAuth w ~/.hermes/auth.json albo niestandardowy endpoint w config.yaml, który utracił base_url. Ścieżki uwierzytelniania szczegółowo opisano w Uwierzytelnianie i dostawcy.²⁷

„Klucz API nie jest ustawiony”

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

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

Hermes automatycznie wykrywa długość kontekstu z endpointu /v1/models serwera, ale 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 wyświetlają się jako tekst zamiast być wykonywane

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

Odpowiedzi są ucinane w połowie zdania

Możliwe są dwie przyczyny:²

1. Niski limit odpowiedzi (max_tokens) na serwerze — SGLang domyślnie ustawia 128 tokenów na odpowiedź. Ustaw --default-max-tokens na serwerze albo skonfiguruj model.max_tokens w config.yaml.
2. Wyczerpanie kontekstu — Model zapełnił swoje okno kontekstowe. Zwiększ model.context_length lub włącz kompresję kontekstu w Hermes.

„Połączenie odrzucone” z WSL2 do serwera modelu hostowanego w Windows

WSL2 używa wirtualnego adaptera sieciowego z własną podsiecią — localhost wewnątrz WSL2 wskazuje maszynę wirtualną Linux, a nie host Windows. Dostępne są dwie opcje:²

Sieć lustrzana (Windows 11 22H2+): edytuj %USERPROFILE%\.wslconfig:

[wsl2]
networkingMode=mirrored

Następnie wykonaj wsl --shutdown i uruchom ponownie. localhost działa teraz dwukierunkowo.

Awaryjne użycie IP hosta (starsze wersje Windows): pobierz adres IP hosta Windows z wnętrza WSL2 i użyj go zamiast localhost:

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

Serwer modelu musi też nasłuchiwać na 0.0.0.0, a nie 127.0.0.1 — dla Ollama ustaw OLLAMA_HOST=0.0.0.0, dla llama-server/SGLang dodaj --host 0.0.0.0 albo w LM Studio włącz „Serve on Network”.²

Gdzie jest wszystko?

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

FAQ

Jaka jest różnica między Hermes Agent a Claude Code?

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

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

Tak. Są trzy sposoby:²

1. Ustaw ANTHROPIC_API_KEY w ~/.hermes/.env i uruchom hermes chat --provider anthropic --model claude-sonnet-4-6
2. Uruchom hermes model i wybierz Anthropic — Hermes użyje magazynu poświadczeń Claude Code, jeśli jest dostępny
3. Ustaw ręcznie ANTHROPIC_TOKEN (token konfiguracyjny lub token OAuth) jako rozwiązanie awaryjne

Opcja 2 jest preferowana, jeśli Claude Code jest już używany na tym samym komputerze — dzięki temu odświeżalne poświadczenia Claude pozostają odświeżalne.

Jak zmienić dostawcę bez utraty rozmowy?

W sesji użyj /model provider:model. Historia rozmowy, pamięć i skille zostaną zachowane:⁹

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

Skonfigurowano Anthropic, ale nie działają vision/web/compression

Używany jest awaryjny model pomocniczy. Vision, podsumowywanie stron internetowych, kompresja oraz inne zadania poboczne korzystają z osobnego pomocniczego LLM — domyślnie Gemini Flash przez automatyczne wykrywanie (OpenRouter → Nous → Codex). Jeśli żaden z nich nie jest skonfigurowany i ustawiono wyłącznie Anthropic, te funkcje działają w ograniczonym zakresie bez komunikatu.⁴

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

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

compression:
  summary_provider: "main"

Jaka jest różnica między SOUL.md a AGENTS.md?

SOUL.md to tożsamość agenta — ton, styl i domyślne zasady komunikacji. Plik znajduje się w ~/.hermes/SOUL.md i towarzyszy wszędzie. AGENTS.md jest specyficzny dla projektu — opisuje architekturę, konwencje, polecenia i ścieżki — oraz znajduje się w katalogu projektu.¹³ Jeśli powinno to towarzyszyć wszędzie, należy użyć SOUL.md. Jeśli należy do projektu, należy użyć AGENTS.md.

Jak uruchomić wiele instancji Hermes obok siebie?

Profile. Każdy profil ma własne HERMES_HOME, konfigurację, pamięć, sesje i 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, przez ścieżkę niestandardowego endpointu. Hermes współpracuje z każdym serwerem zgodnym z OpenAI: Ollama, vLLM, SGLang, llama.cpp/llama-server, LM Studio, LocalAI, Jan lub własnym serwerem.² Konfigurację dla poszczególnych serwerów opisano w Niestandardowe endpointy i endpointy hostowane samodzielnie.

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

Przewodnik wskazuje 47 narzędzi / 20 toolsetów z rejestru architektury upstream — jest to pełna liczba narzędzi, dla których Hermes dostarcza kod źródłowy we wszystkich toolsetach. Działająca instalacja pokazuje w banerze mniejszą liczbę (instalacja referencyjna użyta w tym przewodniku zgłasza 28 narzędzi), ponieważ Hermes podczas uruchamiania włącza tylko domyślny zestaw toolsetów. Wiele toolsetów jest opcjonalnych: adaptery gateway komunikatorów, automatyzacja przeglądarki, bardziej rozbudowane stosy scrapingu oraz kilka wyspecjalizowanych integracji trzeba jawnie wymienić pod toolsets: w ~/.hermes/config.yaml, zanim zostaną załadowane. Suma w rejestrze = „co jest dostępne po włączeniu”. Suma w banerze = „co faktycznie załadował bieżący profil”. Użyj hermes tools --list, aby sprawdzić, które toolsety są aktywne, a które dostępne, lecz wyłączone. Poszczególne toolsety można przełączać w czasie działania przez /tools enable <name> i /tools disable <name> (wyłączenie wywołuje reset sesji, aby agent odbudował manifest narzędzi o nowym kształcie).

Jak Hermes obsługuje awaryjne przełączanie modeli, gdy główny dostawca zawiedzie?

Skonfiguruj blok fallback_model w config.yaml:²

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

Gdy główny dostawca zawiedzie (limit szybkości, błąd serwera, błąd uwierzytelniania), Hermes przełącza się na model zapasowy w trakcie sesji bez utraty historii rozmowy. Dzieje się to najwyżej raz na sesję.

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

Tak — na tym polega „samodoskonaląca” część Hermes Agent. Agent może tworzyć, aktualizować i usuwać skille przez narzędzie skill_manage. Gdy rozwiąże nietrywialny workflow, zapisuje podejście jako skill do ponownego użycia w przyszłości.¹¹ Agent tworzy skille po złożonych zadaniach (ponad 5 wywołań narzędzi), gdy napotka błędy i znajdzie działającą ścieżkę, gdy zostanie skorygowane jego podejście lub gdy odkryje nietrywialny workflow.

Czy istnieje 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

Materiały źródłowe