Hermes Agent: podręcznik praktyka (2026)

TL;DR: Hermes Agent to open-source’owy, samodoskonalący się agent AI od Nous Research. Działa jako CLI oraz jako wieloplatformowy gateway komunikacyjny, przechowuje trwałą tożsamość i pamięć trwałą na dysku, agreguje skill, które ulepszają się wraz z użyciem, i 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 albo z własnym, samodzielnie hostowanym endpointem.¹²¹⁹ Od wersji v0.14.0 (16 maja 2026) Hermes dodaje OAuth SuperGrok z kontekstem grok-4.3 1M, lokalny proxy zgodny z OpenAI dla dostawców OAuth (hermes proxy), pełnoprawne x_search, obsługę instalacji z PyPI, leniwe instalowanie zależności, 22 platformy komunikacyjne 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ę Windows oraz zamknięcie 12 zgłoszeń P0 i 50 zgłoszeń P1.¹⁹ Najtrudniejszą częścią dla większości nowych użytkowników jest uwierzytelnianie dostawcy: Hermes obsługuje około 20 pełnoprawnych dostawców oraz niestandardowe endpointy, a także trzy odrębne ścieżki uwierzytelniania: klucz API w .env, OAuth przez hermes model albo niestandardowy endpoint w config.yaml. Model uwierzytelniania warto 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 na czat. Odczytuje system plików, wykonuje polecenia w sandboxowanych backendach, pobiera dane z internetu, uruchamia subagentów, wykonuje zaplanowane zadania cron, komunikuje się z Telegram/Discord/Slack/WhatsApp/Signal/Email z poziomu jednego procesu gateway i tworzy własne skill na podstawie doświadczenia.¹ CLI to terminalowy 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óżnica między okazjonalnym a eksperckim użyciem Hermes sprowadza się do pięciu systemów. Opanowanie ich sprawia, że Hermes staje się mnożnikiem możliwości:

1. Rozpoznawanie dostawcy: jak przepływy uwierzytelniania mapują się na wywołania API
2. Hierarchia konfiguracji: config.yaml + .env + auth.json + SOUL.md + AGENTS.md
3. System narzędzi i toolset: co agent może robić, z ograniczeniami zależnymi od platformy
4. System skill: proceduralna pamięć, którą agent tworzy i rozwija
5. Gateway + cron + profile: uruchamianie Hermes tam, gdzie faktycznie Pan/Pani pracuje, a nie tylko tam, gdzie akurat się znajduje

Najważniejsze wnioski

• Uwierzytelnianie dostawcy ma trzy ścieżki, nie jedną. Klucz API w .env, OAuth przez hermes model/hermes auth albo niestandardowy endpoint w config.yaml. Należy wybrać ścieżkę zgodną z dostawcą, a nie tę, która wydaje się znajoma.
• Zmiana dostawcy to jedno polecenie. hermes model interaktywnie prowadzi przez każdego obsługiwanego dostawcę, w tym logowania OAuth, a /model provider:model przełącza model w trakcie sesji bez utraty historii.²
• Dwa pliki są edytowalną przez użytkownika powierzchnią konfiguracji. ~/.hermes/config.yaml przechowuje 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 resztę modyfikuje sam agent.⁴
• Hermes jest następcą OpenClaw. Przy migracji hermes claw migrate automatycznie importuje ponad 30 kategorii stanu.⁵
• Jakość usługi zależy od modelu pomocniczego. Wizja, podsumowywanie stron, kompresja i zapis pamięci korzystają z osobnego pomocniczego LLM. Domyślnie jest to Gemini Flash przez automatyczne wykrywanie (OpenRouter → Nous → Codex) — jeśli żaden z nich nie jest skonfigurowany, funkcje te degradują się po cichu, dopóki sloty pomocnicze nie zostaną skierowane na głównego dostawcę.⁴

Co zmienia v0.14

v0.14.0 mniej opiera się na jednej sztandarowej funkcji, a bardziej na zmniejszeniu tarcia podczas konfiguracji i rozszerzeniu miejsc, w których Hermes może działać.¹⁹ Główne zmiany operacyjne:

• Instalacja i start są lżejsze. pip install hermes-agent działa z PyPI, ciężkie adaptery instalują się leniwie przy pierwszym użyciu, a ścieżka uruchamiania odracza wystarczająco dużo pracy, aby skrócić zimny start o około 19 sekund.
• 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ę rozszerza. LINE i SimpleX Chat zwiększają liczbę platform do 22, Microsoft Teams jest połączony end-to-end, uzupełnianie historii Discord jest domyślnie włączone, a prompt clarify w Telegram/Discord korzysta teraz z natywnych przycisków.
• Weryfikacja podczas zapisu jest lepsza. Po edycjach Hermes może pokazywać podsumowania zmian plików dla każdej tury oraz semantyczną diagnostykę language-server przed następną turą, co przybliża go do pracy agenta opartej na dowodach.
• Narzędzia desktopowe i medialne są szersze. computer_use działa przez cua-driver dla dostawców innych niż Anthropic, video_generate jest ujednolicone za pluggable backendami, a vision_analyze wysyła surowe piksele do modeli, które faktycznie potrafią widzieć.

Każda sekcja poniżej opiera się na dokumentacji upstream pod adresem hermes-agent.nousresearch.com/docs oraz drzewie źródłowym w github.com/NousResearch/hermes-agent. Każde twierdzenie faktograficzne ma przypis wskazujący konkretną stronę upstream, z której pochodzi.

Wybór ścieżki

Jak działa Hermes: model mentalny

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

1. Buduje system prompt z SOUL.md, MEMORY.md, USER.md, skills, plików kontekstu oraz wskazówek dotyczących narzędzi przez prompt_builder.py³
2. Rozwiązuje runtime provider przez runtime_provider.py — to ten krok wybiera auth, base URL oraz tryb API³
3. Wywołuje provider przy użyciu jednego z trzech trybów API: chat_completions, codex_responses albo anthropic_messages³
4. Przekazuje wszystkie zwrócone tool calls przez model_tools.py i centralny rejestr narzędzi (tools/registry.py)³
5. Powtarza pętlę, aż model wygeneruje finalną odpowiedź, a następnie zapisuje sesję w SQLite z FTS5³

Zrozumienie tej pętli jest ważne, ponieważ każda funkcja — personalities, memory, skills, compression, fallback — podłącza się do jednego z tych etapów. Gdy czyta się klucz konfiguracji i pojawia się pytanie, co on robi, odpowiedź zwykle brzmi: „to pokrętło na etapie 1, 2, 3 albo 4 powyższej pętli”.

Rdzeń niezależny od platformy. Jedna klasa AIAgent obsługuje CLI, gateway, ACP, batch oraz serwer API. Różnice między platformami znajdują się w punkcie wejścia, a nie w samym agencie.³ Dlatego te same slash commands działają w terminalu i w Telegram — są obsługiwane ze współdzielonego COMMAND_REGISTRY w hermes_cli/commands.py.⁶

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

~/.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 ma konkretną rolę; żadne z nich się nie pokrywają. Jeśli szuka się odpowiedzi na pytanie „gdzie Hermes przechowuje X”, jest to jedno z tych miejsc.

Co nowego w v0.18.0 (The Judgment Release)

Hermes Agent v0.18.0 (tag v2026.7.1, 1 lipca 2026) został nazwany od osądu: agent weryfikuje własną pracę zamiast deklarować sukces, a reasoning zespołowy można faktycznie przejrzeć. Wydanie zamyka też cały backlog P0/P1 — około 692 elementów o najwyższym priorytecie rozwiązanych w dwanaście dni.²²

• Mixture-of-Agents jako pełnoprawny model. MoA można teraz wybrać jak każdy inny model we wszystkich interfejsach, a ensemble reasoning jest widoczny: pełny wynik każdego reference model renderuje się we własnym, opisanym bloku z live answer streaming — można obserwować, jak ensemble myśli, zamiast otrzymywać nieprzejrzystą, scaloną odpowiedź.²²
• Completion contracts dla /goal. Agent weryfikuje własną pracę, uruchamiając kontrole projektu przed zgłoszeniem ukończenia goal, zamiast deklarować sukces — osąd zastosowany wobec samego siebie.²²
• /learn — opisać cokolwiek jako skill. Workflow można zmienić w wielokrotnego użytku skill przez jego opisanie; wygenerowane skills automatycznie spełniają konwencje CONTRIBUTING.md danego repozytorium.²²
• Oś czasu /journey. Wizualna historia memory i skills w czasie, z edycją, a na desktopie także memory graph.²²
• Rozgałęzianie background subagents. Można delegować wiele zadań wykonywanych równocześnie bez blokowania konwersacji — pojedynczy background subagent z v0.17.0 staje się flotą.²²
• Desktop Projects. Pełnoprawne coding Projects z modelem organizacji project/repo/lane.²²
• Gateway scale-to-zero. Gateways mogą przechodzić w stan uśpienia przy bezczynności i koordynować drains, aby umożliwiać płynne wdrożenia — istotne dla każdego, kto uruchamia Hermes jako usługę always-on.²²
• Obsługa Google Vertex AI. Dostęp do Gemini przez konta usług GCP z automatycznym odświeżaniem tokenów OAuth2, jako część katalogu providerów.²²
• Polecenie edytora /prompt. Otwiera $EDITOR do tworzenia wielowierszowych promptów, zamiast zmuszać do walki z pojedynczą linią wejścia.²²

Przy aktualizacji z v0.17.x nic tutaj nie psuje CLI. Główne powody aktualizacji to completion contracts (cele, które same się weryfikują), pełnoprawne MoA z możliwymi do inspekcji ensembles oraz /learn do przechwytywania skills.

Co nowego w v0.17.0 (The Reach Release)

Hermes Agent v0.17.0 (tag v2026.6.19, 19 czerwca 2026) został nazwany od tego, jak daleko agent teraz sięga — nowe kanały komunikacji, nowi providerzy modeli oraz głębsza kontrola na desktopie i w dashboardzie. To rozszerzenie względem v0.16.x; powierzchnia CLI pozostaje bez zmian.²¹

• Nowe kanały komunikacji. iMessage działa teraz bez Mac relay przez Photon Spectrum (device-code OAuth, hermes photon login); WhatsApp Business Cloud API jest oficjalnym adapterem Meta, który zastępuje wymóg procesu bridge; SimpleX otrzymuje grupy, natywne załączniki, grupowanie tekstu i auto-accept; a Raft dołącza jako wbudowany plugin platformy z projektem wake-channel opartym na privacy-by-contract.²¹
• Nowe modele i providerzy. Katalog dodaje 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 zmienił się na grok-build-0.1, a adaptacyjne modele Anthropic stosują teraz nowoczesny kontrakt thinking (nigdy nie wysyłają pola reasoning).²¹
• Desktop i dashboard. Desktop dodaje background subagents z transmisją aktywności delegowanej na żywo w „watch-windows” (delegate_task(background=true)), selektor modeli Composer, zmienialne skróty klawiaturowe, natywne powiadomienia OS, szkice composera per wątek, motywy z VS Code Marketplace oraz interfejs po japońsku i chińsku tradycyjnym. Dashboard dodaje pełny kreator profili (model/skills/MCPs bez edytowania config.yaml), globalny przełącznik profili, przebudowany Skills Hub ze skanem bezpieczeństwa, Automation Blueprints (parametryzowane szablony dla formularza, slash command, konwersacji i dokumentacji) oraz bezpieczne logowanie, które zwraca 401 za bramką OAuth.²¹
• Skills i narzędzia. image_generate może teraz edytować i przekształcać obraz źródłowy, a nie tylko tworzyć nowy od zera, u każdego obsługiwanego providera obrazów; narzędzie memory otrzymało tablicę operations do atomowego batch add/replace/remove w jednym wywołaniu; nowy skill simplify-code uruchamia równoległy, trzyagentowy przegląd i cleanup z bramką opartą na poziomie ryzyka Chesterton’s-Fence; a boolean write_approval zastępuje trójstanowe write_mode.²¹
• Architektura. Background subagents natychmiast zwracają uchwyt i wprowadzają swój wynik z powrotem jako nową turę; handler elicitation MCP pozwala na potwierdzenie w trakcie tool-call, a późno dołączające narzędzia MCP są udostępniane między turami (cache-safe); cron staje się wymiennym CronScheduler z providerem managed-cron Chronos; a nowy Managed scope (/etc/hermes) pozwala administratorowi przypiąć konfigurację niezmienialną dla użytkownika, wraz z relay Gateway-Gateway dla topologii multi-gateway.²¹
• Nowe polecenia. /version, /billing (interaktywne rozliczenia w terminalu), hermes photon login (auth dla iMessage) oraz hermes curator run --consolidate — konsolidacja jest teraz opt-in, więc rutynowa background curation kosztuje zero tokenów.²¹
• Bezpieczeństwo. v0.17.0 zamyka obejście denylisty shell-escape, fails closed przy brakujących modułach approval i adapterach own-policy gateway, sanitizuje środowisko dla podprocesów cron job-script, redaguje sekrety w request debug dumps, sprawdza konfiguracje stdio MCP pod kątem wzorców exfil oraz podnosi wersje urllib3 i PyJWT, aby usunąć CVE.²¹

Przy aktualizacji z v0.16.x nic tutaj nie psuje CLI; to nowe kanały, modele i powierzchnie wokół tego samego agenta. iMessage bez relay, oficjalne adaptery WhatsApp oraz administrator Managed scope to główne powody aktualizacji.

Co nowego w v0.16.0 (The Surface Release)

Hermes Agent v0.16.0 (tag v2026.6.5, 5 czerwca 2026) otrzymał nazwę od nowych powierzchni interakcji, które udostępnia agentowi działającemu przede wszystkim w CLI. Najważniejsza zmiana: Hermes nie jest już ograniczony wyłącznie do terminala.²⁰

• 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 odpowiedzi, przeciąganie i upuszczanie plików, wklejanie obrazów ze schowka, paletę Cmd+K, listę sesji z archiwizacją i wyszukiwaniem oraz wybór modelu na pasku stanu. Może łączyć się ze zdalnym Hermes gateway przez bezpieczne WebSocket, z uwierzytelnianiem przez OAuth albo nazwę użytkownika i hasło, z osobnymi zdalnymi hostami dla profili oraz równoległymi sesjami wieloprofilowymi połączonymi odwołaniami @session między profilami. Interfejs desktopowy zawiera też pełne tłumaczenie na uproszczony chiński (简体中文) przez typowaną warstwę i18n (display.language; angielski pozostaje ustawieniem domyślnym).²⁰
• Panel administracyjny w przeglądarce. Lokalny web dashboard przestał być tylko widokiem statusu i stał się pełnym panelem administracyjnym: katalog MCP z przełącznikami włączania i wyłączania, zarządzaniem poświadczeniami, tworzeniem webhooków i hooków, konfiguracją pamięci, kontrolkami gateway oraz stroną System z kontrolą przed aktualizacją i Debug Share jednym kliknięciem. Nowa strona Channels pozwala konfigurować z przeglądarki każdą platformę komunikacyjną gateway (Telegram, Discord, Slack i pozostałe). Uwierzytelnianie jest teraz wymienne: logowanie nazwą użytkownika i hasłem, ogólny samodzielnie hostowany dostawca OIDC, hermes dashboard register dla samodzielnie hostowanego klienta OAuth oraz rotacja sesji przez refresh-token.²⁰
• Nowe CLI i polecenia slash. /undo [N] wycofuje ostatnie N tur użytkownika z prefill i soft-delete oraz działa w CLI, TUI i na platformach komunikacyjnych. Konfigurowalny domyślny interfejs (cli vs tui) trafia do wydania wraz z nadpisaniem --cli; TUI otrzymuje ujednolicone polecenie /model oraz nakładkę Sessions. hermes portal to czytelny dla człowieka alias przepływu wdrożeniowego 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 dodaje deepseek-v4-flash, MiniMax-M3 (kontekst 1M, natywni dostawcy MiniMax), qwen3.7-plus (Nous + OpenRouter) oraz gemini-3.5-flash (Gemini OAuth + klucz API). Pełnoprawny dostawca xAI Grok OAuth trafia do launchera desktopowego, selektor modeli zyskał wyszukiwanie rozmyte na każdej powierzchni interakcji, dostawcy z wieloma endpointami są grupowani w jednym wierszu, a odświeżanie katalogu zmieniono z codziennego na cogodzinne.²⁰
• Lżejsze skills i progressive disclosure. Domyślny zestaw skill usunął nadmiarowe i martwe skills (Spotify przeniesiono do natywnej wtyczki, Linear do hermes mcp install linear, a kilka przestarzałych pozycji usunięto), więcej elementów przeniesiono do opcjonalnych, a także dodano bramkę trafności frontmatter environments: (kanban/docker/s6), która trzyma skills zależne od kontekstu poza indeksem, dopóki nie zostaną zażądane. NVIDIA/skills jest teraz domyślnym zaufanym źródłem Skills Hub obok OpenAI, Anthropic i HuggingFace. Narzędzia MCP oraz wtyczek otrzymały progresywne, zakresowe ujawnianie narzędzi, a błąd MCP, który zgłaszał fałszywy sukces OAuth, gdy nie uzyskano tokena, został naprawiony.²⁰
• Bezpieczeństwo. v0.16.0 przypina załatane Starlette (≥1.0.1) dla CVE-2026-48710 (BadHost), przenosi sprawdzanie adresów URL pod kątem SSRF poza pętlę zdarzeń w ścieżkach asynchronicznych, usuwa bearer token wnioskowania Bedrock ze środowiska subprocess, dodaje bws_cache.json do zabezpieczenia odczytu plików, dodaje docker restart/stop/kill do listy niebezpiecznych wzorców oraz sanityzuje niewidoczny Unicode w zweryfikowanej zawartości skill. Wydanie zamknęło 2 problemy P0 i 62 problemy P1, z czego 16 oznaczono tagiem bezpieczeństwa.²⁰

Przy aktualizacji z v0.15.x żadna z tych zmian nie jest zmianą łamiącą dla samego CLI; są to dodatkowe powierzchnie interakcji i dostawcy wokół tego samego agenta. Aplikacja desktopowa i panel administracyjny to główne powody aktualizacji, jeśli Hermes ma obsługiwać użytkowników nieterminalowych albo zdalny gateway ma być administrowany z przeglądarki.

Instalacja

Jednowierszowy instalator pozostaje zalecaną ścieżką z przewodnikiem dla większości użytkowników. Obsługuje Python, uv, Node.js, ripgrep, ffmpeg, klonowanie repozytorium, środowisko wirtualne oraz globalne polecenie hermes.⁷ v0.14.0 dostarcza też prawdziwy pakiet PyPI, więc pip install hermes-agent jest teraz sensowną bezpośrednią instalacją, gdy środowisko Python jest już pod Państwa kontrolą.¹⁹

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

pip install hermes-agent
hermes

Działa na Linux, macOS, WSL2 oraz Android/Termux (instalator automatycznie wykrywa Termux i przełącza się na przetestowany pakiet Android).⁷ v0.14.0 dodaje natywne wsparcie dla Windows we wczesnej becie przez instalator PowerShell, ale WSL2 pozostaje bezpieczniejszą rekomendacją do zastosowań produkcyjnych, dopóki ścieżka Windows 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 sudo), Node.js v22 (do automatyzacji przeglądarki i mostka WhatsApp), ripgrep oraz ffmpeg.⁷

Weryfikacja instalacji

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

hermes doctor dokładnie wskazuje, czego brakuje i jak to naprawić.⁷ hermes dump to polecenie diagnostyczne do wklejenia w zgłoszeniu GitHub albo wątku Discord przy proszeniu o pomoc — jest to zwykłe tekstowe podsumowanie całej konfiguracji z ukrytymi sekretami.⁸

Instalacja ręczna

Jeśli potrzebna jest pełna kontrola — niestandardowa wersja Python, konkretne extras, integracja Nix/NixOS — ręczny przepływ jest udokumentowany krok po kroku w upstreamowym przewodniku instalacji.⁷ Kluczowe opcjonalne extras, które można łączyć z uv pip install -e ".[<extras>]":

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

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

Wynika to z tego, że .[all] na Androidzie pobiera faster-whisper przez extra voice, które zależy od kół ctranslate2, niepublikowanych dla Androida.⁷

Uwierzytelnianie i dostawcy

Hermes obsługuje około 19 dostawców pierwszej klasy oraz niestandardowe endpointy, a także 3 odrębne ścieżki uwierzytelniania. Poniżej znajduje się cała powierzchnia uwierzytelniania, uporządkowana według ścieżki, aby można było znaleźć wariant pasujący do posiadanej konfiguracji.

3 ścieżki uwierzytelniania

Każdy dostawca w Hermes pasuje do jednego z 3 wzorców uwierzytelniania:

Ścieżka 1 — klucz API w .env. Proszę umieścić klucz w ~/.hermes/.env, a Hermes odczyta go przy uruchomieniu. Używane 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.²

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

Ścieżka 3 — niestandardowy endpoint w config.yaml. Dla dowolnego endpointu zgodnego z OpenAI API — Ollama, vLLM, SGLang, llama.cpp, LM Studio, proxy LiteLLM, Together AI, Groq, Azure OpenAI albo własny serwer self-hosted. Konfigurowane raz przez hermes model → Custom endpoint, a następnie zapisywane w config.yaml.²

Pełna macierz dostawców

To kompletna lista dostawców pierwszej klasy wraz z dokładnym przepływem konfiguracji dla każdego z nich.²

Anthropic: 3 metody uwierzytelniania

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

# 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 danych uwierzytelniających Claude Code zamiast kopiowania tokenu do ~/.hermes/.env. Dzięki temu odświeżalne dane uwierzytelniające Claude pozostają odświeżalne.² Jeśli na tej samej maszynie jest już używany Claude Code, to najczystsza ścieżka.

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

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

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

GitHub Copilot: 2 tryby

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

# 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 tej kolejności, zgodnie z dokumentacją upstream:² 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 typy to tokeny OAuth (gho_*), precyzyjnie zakresowane PAT (github_pat_* z uprawnieniem Copilot Requests) oraz tokeny GitHub App (ghu_*). Jeśli gh auth token zwraca token ghp_*, należy zamiast tego użyć hermes model, aby uwierzytelnić się przez OAuth.²

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

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

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

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

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

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

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

Bazowe adresy URL można nadpisać zmiennymi środowiskowymi GLM_BASE_URL, KIMI_BASE_URL, MINIMAX_BASE_URL, MINIMAX_CN_BASE_URL lub DASHSCOPE_BASE_URL.²

Z.AI automatycznie wykrywa endpoint. Podczas używania dostawcy z.ai/GLM Hermes sprawdza wiele endpointów (globalny, chiński, 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 używać zapisanych w cache promptów systemowych oraz historii.² Działa automatycznie; konfiguracja nie jest potrzebna.

Polecenie hermes auth

hermes auth to polecenie do zarządzania danymi uwierzytelniającymi dla pul i danych OAuth.⁶

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

Pule danych uwierzytelniających służą do rotowania wielu kluczy API lub tokenów OAuth dla tego samego dostawcy — przydatne przy rozdzielaniu limitów szybkości między wiele kluczy bez zmiany kodu.⁶ Starsze polecenia hermes login / hermes logout zostały usunięte; należy zamiast nich używać hermes auth.⁶

Niestandardowe i self-hosted endpointy

Hermes działa z dowolnym endpointem API zgodnym z OpenAI. Jeśli serwer implementuje /v1/chat/completions, można skierować na niego 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 jedynym źródłem prawdy dla modelu głównego, dostawcy i bazowego URL.² Starsze zmienne env OPENAI_BASE_URL i LLM_MODEL nie są już odczytywane dla konfiguracji modelu głównego — należy użyć hermes model albo edytować bezpośrednio config.yaml.² (OPENAI_BASE_URL + OPENAI_API_KEY są nadal respektowane jako fallback dla pomocniczej ścieżki routingu provider: "main", więc nie należy usuwać ich bez sprawdzenia, jeśli są tam używane).⁴

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

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

/model custom (bez niczego, bez nazwy modelu) odpytuje API /v1/models endpointu i automatycznie wybiera model, jeśli załadowany jest dokładnie jeden — przydatne dla lokalnych serwerów uruchamiających pojedynczy model.²

Lokalne serwery LLM (szablony konfiguracji)

Dokumentacja upstream zawiera pełne przewodniki konfiguracji dla Ollama, vLLM, SGLang, llama.cpp i LM Studio. Poniżej znajdują się kluczowe polecenia, które faktycznie będą uruchamiane. Każde z nich zaprojektowano tak, aby utworzyć działający endpoint, na który Hermes może wskazać.²

Ollama — najłatwiejsza lokalna ścieżka, zero 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

Krytyczna pułapka Ollama: Ollama domyślnie używa bardzo małych długości kontekstu (4096 tokenów przy mniej niż 24 GB VRAM). Trzeba zwiększyć ją przez OLLAMA_CONTEXT_LENGTH albo Modelfile — OpenAI-compatible API nie przyjmuje długości kontekstu od klienta, więc Hermes nie może ustawić jej za użytkownika.² Do użycia agentowego 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 oraz --tool-call-parser <name>. Obsługiwane parsery: hermes (Qwen 2.5, Hermes 2/3), llama3_json, mistral, deepseek_v3, deepseek_v31, xlam, pythonic. Bez tych flag wywołania narzędzi wrócą jako zwykły tekst.²

SGLang — szybkie serwowanie z RadixAttention do ponownego użycia 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

Pułapka SGLang: Domyślne max_tokens to 128. Jeśli odpowiedzi są ucinane, należy ustawić --default-max-tokens na serwerze albo skonfigurować model.max_tokens w config.yaml.²

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 tego 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 sparsować jako rzeczywistych wywołań narzędzi.²

LM Studio — aplikacja desktopowa z GUI:

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

Krytyczna pułapka LM Studio: LM Studio odczytuje długość kontekstu z metadanych modelu, ale wiele modeli GGUF zgłasza domyślne wartości 2048 albo 4096. Zawsze należy jawnie ustawić długość kontekstu 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.²

Nazwani dostawcy niestandardowi

Jeśli pracuje się z wieloma niestandardowymi endpointami (na przykład lokalnym serwerem developerskim i zdalnym serwerem GPU), należy zdefiniować je jako nazwanych dostawców niestandardowych 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 składnią potrójną:

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

Nazwanych dostawców niestandardowych można też wybrać z interaktywnego menu hermes model.²

Wtykowa architektura dostawców (v0.13.0+)

v0.13.0 dostarcza ABC ProviderProfile oraz katalog plugins/model-providers/, dzięki czemu zewnętrzni dostawcy inference mogą zostać dodani bez modyfikowania rdzenia.¹⁸ Jeśli dostawca obsługuje tryb API zgodny z OpenAI, Anthropic albo Codex, można zaimplementować podklasę ProviderProfile, która deklaruje ścieżkę uwierzytelniania, bazowy URL, katalog modeli i nagłówki cache; Hermes rozwiązuje 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, 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 albo innym zgodnym skonfigurowanym dostawcy.¹⁹ Oznacza to, że narzędzia oczekujące API w stylu OpenAI API, w tym Codex CLI, Aider, Cline, Continue albo niestandardowe skrypty, mogą ponownie używać uwierzytelniania Hermes opartego na subskrypcji bez oddzielnego klucza API. Proxy należy traktować jako lokalną infrastrukturę developerską: wiązać je celowo, nie wystawiać szeroko i pamiętać o warunkach specyficznych dla dostawcy.

Wykrywanie długości kontekstu

Dwa ustawienia są stale mylone, zgodnie z dokumentacją upstream:²

• 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 albo 200 000 dla Sonnet 4.6). Hermes używa tego do decyzji, kiedy kompresować historię.
• model.max_tokens — limit wyjścia (maksymalna liczba tokenów, jaką model może wygenerować w pojedynczej odpowiedzi). Niezwiązane z długością historii.

Należy ustawić context_length, 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 rozwiązywania do wykrywania okien kontekstu: nadpisanie w konfiguracji → niestandardowy dostawca per model → trwały cache → endpoint /models → Anthropic /v1/models → OpenRouter API → Nous Portal → models.dev (utrzymywany przez społeczność rejestr ponad 3800 modeli) → domyślne wartości awaryjne (128K).² System rozumie dostawców, więc ten sam model może mieć różne limity kontekstu w zależności od tego, kto go serwuje (np. claude-opus-4.6 ma 1M przez bezpośredni Anthropic, ale 128K przez GitHub Copilot).²

Rotacja dostawców i fallback

Pule danych uwierzytelniających. Gdy dostępnych jest wiele kluczy API dla tego samego dostawcy, należy skonfigurować strategię rotacji przez hermes auth. Tak rozdziela się limity szybkości między wieloma kluczami.⁶

Model fallback. Należy skonfigurować zapasowy provider:model, na który Hermes automatycznie przełącza się, gdy model główny 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 zamienia model i dostawcę w trakcie sesji bez utraty rozmowy. Uruchamia się najwyżej raz na sesję.² Obsługiwani dostawcy dla fallbacku: 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 WWW, analizy zrzutów ekranu z przeglądarki, klasyfikacji zatwierdzania niebezpiecznych poleceń, kompresji kontekstu, podsumowywania wyszukiwania w sesji, dopasowywania skill, dispatchu narzędzi MCP i zapisu pamięci.⁴ Domyślnie używają one Gemini Flash przez automatyczne wykrywanie (OpenRouter → Nous → Codex).

Można skonfigurować, którego modelu i dostawcy używa każde zadanie pomocnicze. Każdy slot pomocniczy używa tych samych 3 pokręteł: 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 dowolnego dostawcy, którego używa mój główny agent” — jest poprawna wyłącznie w konfiguracjach auxiliary:, compression: i fallback_model:. Nie jest poprawna dla ustawienia najwyższego poziomu model.provider. Jeśli jako model główny używany jest niestandardowy endpoint zgodny z OpenAI, w sekcji model: należy ustawić provider: custom.⁴

Dlaczego to ma znaczenie: jeśli skonfigurowano tylko Anthropic OAuth (bez klucza OpenRouter), funkcje vision, podsumowywania WWW i kompresji będą działać gorzej albo przestaną działać, ponieważ domyślny łańcuch fallbacku pomocniczego najpierw próbuje OpenRouter. Należy dodać OPENROUTER_API_KEY do zadań pomocniczych albo przełączyć każdy slot pomocniczy na głównego dostawcę:

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

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

System konfiguracji

Hermes ma warstwowy system konfiguracji. Zrozumienie priorytetów jest kluczowe, ponieważ wyższe warstwy nadpisują niższe, a jedną z warstw jest globalny rejestr providerów, którego nie widać w config.yaml.

Układ plików konfiguracyjnych

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

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

config.yaml kontra .env — gdy ustawione są oba, config.yaml ma pierwszeństwo dla ustawień innych niż sekrety.⁴ Reguła 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 config.yaml za pomocą interpolacji w stylu powłoki:⁴

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

Zarządzanie konfiguracją

hermes config                # View current configuration
hermes config show           # Same as above
hermes config edit           # Open config.yaml in your editor
hermes config set KEY VAL    # Set a specific value
hermes config path           # Print the config file path
hermes config env-path       # Print the .env file path
hermes config check          # Check for missing options (after updates)
hermes config migrate        # Interactively add missing options

Przykłady:⁴

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

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

Priorytet 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 przy starcie procesu
3. config.yaml — główny plik ustawień
4. .env — tylko sekrety
5. Wbudowane wartości domyślne — stosowane, gdy żadna inna warstwa nie ustawia wartości

Flagi CLI zawsze wygrywają dla tego pojedynczego wywołania. config.yaml pozostaje długoterminowym źródłem prawdy.

Lokalizacja (v0.13.0+)

v0.13.0 dodało 7 lokalizacji dla komunikatów CLI i gateway: chiński (uproszczony), japoński, niemiecki, hiszpański, francuski, ukraiński i turecki.¹⁸ v0.14.0 lokalizuje wszystkie polecenia gateway oraz web dashboard, dodaje 8 kolejnych lokalizacji i zwiększa łączną liczbę do 16.¹⁹ Dokumentacja jest obecnie zlokalizowana tylko w zh-Hans. Lokalizacja jest ustalana na podstawie zmiennych środowiskowych LC_ALL / LANG albo jawnego klucza locale: w config.yaml. Angielski pozostaje językiem domyślnym i źródłem prawdy dla każdego ciągu znaków, którego tłumaczenie jeszcze nie obejmuje.

Profile — wiele odizolowanych instancji Hermes

Profile dają wiele odizolowanych instancji Hermes, z których każda ma własną konfigurację, sesje, skills, pamięć i PID gateway. W ten sposób można uruchamiać „Hermes do pracy” i „Hermes osobisty” obok siebie, bez wzajemnego dostępu do swojego stanu.⁶

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

Każdy profile otrzymuje własny HERMES_HOME (domyślnie ~/.hermes-<name>/), więc wiele profili może uruchamiać gateway równolegle, bez wchodzenia sobie w drogę.⁶³

Polecenia CLI

Ta sekcja jest praktycznym punktem odniesienia dla poleceń najwyższego poziomu CLI. Autorytatywną dokumentację wygenerowaną na podstawie kodu zawiera upstream 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 przenosi do interaktywnego chatu. 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"

Kluczowe opcje:

hermes setup — pełny kreator

Uruchamia pełny kreator konfiguracji albo przechodzi 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 — strukturalne zapytania do logów

hermes logs jest bardziej zaawansowane niż tail -f na plikach logów, ponieważ obsługuje jednoczesne 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, przekazywanie narzędzi, cykl życia sesji, INFO+) - errors.log — wyłącznie ostrzeżenia i błędy (przefiltrowany podzbiór agent.log) - gateway.log — aktywność messaging gateway (połączenia platform, dispatch, webhooks)

Rotacja odbywa się automatycznie za pośrednictwem RotatingFileHandler z Python — należy szukać agent.log.1, agent.log.2 itd.⁶

hermes doctor — diagnostyka

hermes doctor [--fix] to pierwsze polecenie, które należy uruchomić, gdy coś działa nieprawidłowo. Sprawdza poprawność konfiguracji, obecność zależności, dostępność klucza API, status usług i może próbować automatycznych napraw z użyciem --fix.⁶

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

Polecenia slash

Polecenia slash działają w aktywnej sesji czatu (CLI lub platforma komunikacyjna). Są wysyłane ze wspólnego COMMAND_REGISTRY w hermes_cli/commands.py, dlatego większość poleceń działa identycznie na różnych powierzchniach.⁹

Sterowanie sesją

Konfiguracja i model

Polecenie /model jest głównym narzędziem 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

Narzędzia, skille 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

Można także zdefiniować szybkie polecenia w config.yaml, które mapują krótką nazwę na dłuższy prompt:⁹

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

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

Dopasowywanie prefiksów

Polecenia obsługują dopasowywanie prefiksów: wpisanie /h rozwiązuje się jako /help, a /mod jako /model. Gdy prefiks jest niejednoznaczny, wygrywa pierwsza rejestracja w kolejności rejestru. 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ą tylko 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 home platformy
• /approve [session|always] — zatwierdź oczekujące niebezpieczne polecenie
• /deny — odrzuć oczekujące niebezpieczne polecenie
• /update — zaktualizuj Hermes Agent do najnowszej wersji
• /commands [page] — przeglądaj wszystkie polecenia i skills (stronicowane)

A niektóre są dostępne tylko w CLI: /skin, /tools, /toolsets, /browser, /config, /cron, /skills, /platforms, /paste, /statusbar, /plugins.⁹

Narzędzia i toolsety

Hermes zawiera rozbudowany wbudowany rejestr narzędzi obejmujący wyszukiwanie w sieci, automatyzację przeglądarki, wykonywanie poleceń w terminalu, edycję plików, pamięć, delegowanie, trening RL, dostarczanie wiadomości, integrację z Home Assistant i nie tylko.¹⁰ Narzędzia są uporządkowane w logiczne toolsety, które można włączać lub wyłączać osobno dla każdej platformy.

Kategorie wysokiego poziomu

Typowe nazwy toolsetów to 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 też przełączać w trakcie sesji przez /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 6 różnych środowiskach:¹⁰

Backendy można przełączać poleceniem 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 container_persistent: true zainstalowane pakiety, pliki i konfiguracja zachowują się między sesjami.¹⁰

Wszystkie backendy kontenerowe działają z utwardzeniami bezpieczeństwa: system plików root tylko do odczytu (Docker), wszystkie uprawnienia Linux usunięte poza DAC_OVERRIDE, CHOWN i FOWNER, brak eskalacji uprawnień, limity PID (256 procesów), pełna izolacja namespace, trwały workspace przez wolumeny.¹⁰

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 interaktywne narzędzia CLI, takie jak Codex i Claude Code.¹⁰

Sudo

Jeśli polecenie wymaga sudo, Hermes poprosi o hasło (buforowane na czas sesji). Można też ustawić SUDO_PASSWORD w ~/.hermes/.env.¹⁰

Multi-Agent Kanban (v0.13.0+)

v0.13.0 zamienia współpracę wielu agentów w prymityw 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 ta tablica sprawia, że swarm workerów Hermes faktycznie kończy pracę, zamiast zatrzymywać się na martwych przekazaniach.

Tablica Kanban naturalnie łączy się z /goal (pętla Ralph z zablokowanym celem) po stronie celu oraz z istniejącym narzędziem delegate_task dla semantyki spawn. W rezultacie powstaje wzorzec swarmu, w którym każdy agent współdzieli jedno źródło prawdy o tym, co robić dalej, kto się tym zajmuje i co utknęło.

System skills

Skills to dokumenty wiedzy ładowane na żądanie, które agent może wczytać wtedy, gdy są potrzebne. Działają według wzorca stopniowego ujawniania, aby ograniczyć zuż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łączone skills są kopiowane z repozytorium. Skills zainstalowane z hubu i utworzone przez agenta również trafiają tutaj.¹¹

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ą treść skill dopiero wtedy, gdy rzeczywiście jej potrzebuje.¹¹

Format SKILL.md

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

# Skill Title

## When to Use
Trigger conditions for this skill.

## Procedure
1. Step one
2. Step two

## Pitfalls
- Known failure modes and fixes

## Verification
How to confirm it worked.

Aktywacja warunkowa

Skills mogą się pokazywać lub ukrywać zależnie od tego, które narzędzia są dostępne. Jest to najbardziej przydatne w przypadku fallback skills — darmowych 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 fallback.¹¹

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 opracuje nietrywialny workflow, zapisuje podejście jako skill do ponownego użycia w przyszłości.¹¹

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

Akcje:¹¹

Skill Hub

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

Domyślne taps GitHub (możliwe do przeglądania bez konfiguracji): openai/skills, anthropics/skills, VoltAgent/awesome-agent-skills, garrytan/gstack.¹¹

Skanowanie bezpieczeństwa

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

Poziomy zaufania:¹¹

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

Zewnętrzne katalogi skills

Można wskazać Hermes dodatkowe katalogi skills skanowane razem z katalogiem lokalnym:¹¹

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

Ścieżki obsługują rozwijanie ~ oraz podstawianie zmiennych środowiskowych ${VAR}. Katalogi zewnętrzne są tylko do odczytu — gdy agent tworzy lub edytuje skill, zawsze zapisuje go w ~/.hermes/skills/. Lokalny priorytet wygrywa, jeśli skill o tej samej nazwie istnieje w obu miejscach.¹¹

Pamięć trwała

Hermes ma ograniczoną, kuratorowaną pamięć, która utrzymuje się między sesjami. Pamięć agenta tworzą dwa pliki, oba przechowywane w ~/.hermes/memories/:¹²

Oba są wstrzykiwane do promptu systemowego jako zamrożony zrzut na początku sesji. Agent zarządza własną pamięcią za pomocą narzędzia memory — add, replace albo remove.¹²

Wzorzec zamrożonego zrzutu: wstrzyknięcie do promptu systemowego jest przechwytywane raz na początku sesji i nie zmienia się w jej trakcie. To celowe — zachowuje cache prefiksu LLM w celu zwiększenia wydajności. Zmiany wprowadzone podczas sesji są natychmiast zapisywane na dysku, ale pojawiają się w prompcie systemowym dopiero w następnej sesji.¹²

Co zapisywać

Warto zapisywać te informacje (agent robi to proaktywnie):¹² - Preferencje użytkownika: „Wolę TypeScript niż JavaScript” → user - Fakty o środowisku: „Ten serwer działa na Debian 12 z PostgreSQL 16” → memory - Korekty: „Nie używać sudo dla poleceń Docker, użytkownik jest w grupie docker” → memory - Konwencje: „Projekt używa tabulatorów, szerokości linii 120 znaków i docstringów w stylu Google” → memory - Ukończone prace: „Przeniesiono bazę danych z MySQL do PostgreSQL 2026-01-15” → memory

Należy pominąć:¹² - Trywialne/oczywiste informacje - Fakty łatwe do ponownego odkrycia - Surowe zrzuty danych (zbyt duże dla pamięci) - Efemeryczne informacje specyficzne dla sesji - Informacje już obecne 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 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

Do głębszej pamięci trwałej wykraczającej poza MEMORY.md i USER.md Hermes zawiera osiem pluginów 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ąc) 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)

Aktywny może być tylko jeden zewnętrzny dostawca naraz. Wbudowana pamięć jest zawsze aktywna.⁶

Automatyczne wznawianie sesji (v0.13.0+)

v0.13.0 sprawia, że przerwanie pracy agenta w trakcie staje się możliwe do przetrwania. Gateway automatycznie wznawia przerwane sesje po restarcie; restarty /update zachowują stan sesji podczas aktualizacji; przeładowania plików źródłowych w trakcie developmentu utrzymują aktywną sesję zamiast wymuszać nową.¹⁸ Efekt praktyczny: długotrwałe prace gateway i zadania sterowane przez cron nie resetują już okna kontekstu po restarcie procesu.

Checkpoints v2 (v0.13.0+)

Trwałość stanu została przepisana w v0.13.0 jako projekt z jednym magazynem, z rzeczywistym przycinaniem, zabezpieczeniami dyskowymi i bez osieroconych repozytoriów-cieni.¹⁸ Poprzedni system checkpointów gromadził stan na dysku w długotrwałych profilach; magazyn v2 nakłada twardy limit na lokalne przechowywanie checkpointów i usuwa zdublowaną ewidencję, która powodowała ten wzrost. Nie jest wymagana żadna zmiana konfiguracji widoczna dla użytkownika; następny zapis checkpointu używa ścieżki v2.

Osobowość i SOUL.md

SOUL.md jest podstawową tożsamością instancji Hermes. Zajmuje slot nr 1 w prompcie systemowym, zastępując domyślną tożsamość zakodowaną na stałe.¹³

Hermes automatycznie tworzy domyślny SOUL.md w ~/.hermes/SOUL.md (albo $HERMES_HOME/SOUL.md dla profili niestandardowych). 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 między projektami.¹³

Co należy umieszczać w SOUL.md

Należy używać go do trwałych wskazówek dotyczących głosu i osobowości:¹³ - tonu - stylu komunikacji - poziomu bezpośredniości - domyślnego stylu interakcji - tego, czego unikać stylistycznie - sposobu, w jaki Hermes powinien obsługiwać niepewność, niezgodę i niejednoznaczność

Mniej nadaje się do:¹³ - jednorazowych instrukcji projektowych - ścieżek plików - konwencji repozytorium - tymczasowych szczegółów workflow

Te informacje należą do AGENTS.md, 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 kodowania, preferencje narzędziowe, workflow specyficzne dla repozytorium, polecenia, porty, ścieżki, notatki wdrożeniowe.

Przydatna reguła: jeśli coś powinno podążać za Panem/Panią wszędzie, należy do SOUL.md. Jeśli należy do projektu, należy do 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 można przełączyć się poleceniem /personality codereviewer.

SOUL.md a /personality

SOUL.md jest bazowym głosem. /personality to nakładka na poziomie sesji.¹³ Warto utrzymać pragmatyczny domyślny SOUL.md, a następnie używać /personality teacher do rozmowy szkoleniowej albo /personality creative do burzy mózgów.

Nous Tool Gateway (v0.10.0+)

Od Hermes Agent v0.10.0 (2026-04-16) płatni subskrybenci Nous Portal otrzymują zarządzany dostęp do wyselekcjonowanego zestawu narzędzi przy użyciu istniejących danych logowania Portal — bez dodatkowych kluczy API do zarządzania.²⁶ Sam Hermes CLI pozostaje na licencji MIT i w pełni open source. Zmiana polega na tym, że uwierzytelnienie Portal odblokowuje teraz więcej niż tylko inferencję modeli.

Co znajduje się w gateway

Jak to działa

Gateway jest opcjonalny dla każdego narzędzia przez nowe pole konfiguracji use_gateway. Jeśli w hermes auth są dane logowania Portal i gateway jest włączony dla danego narzędzia, wywołania tego narzędzia są kierowane przez Portal. W przeciwnym razie używany jest bezpośredni klucz API (jeśli jest obecny).

# 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

Priorytet w czasie działania: gdy gateway jest dostępny i narzędzie ma use_gateway: true, Hermes preferuje gateway, nawet jeśli skonfigurowany jest również bezpośredni klucz API. Ma to znaczenie dla rozliczeń — wywołania gateway korzystają z subskrypcji Portal, a nie z salda bezpośredniego klucza API.

Włączanie gateway

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

Nie ma oddzielnego polecenia hermes subscribe ani hermes login --portal. Subskrypcja jest wykrywana automatycznie na podstawie danych logowania OAuth Portal, które już znajdują się w hermes auth.

Ceny i dostęp

Ceny oraz nazwy tierów są publikowane na stronie cennika Nous Portal (https://portal.nousresearch.com/pricing). Ten przewodnik nie wylicza tierów, ponieważ odpowiada za nie produkt Portal, a nie Hermes CLI, i zmieniają się niezależnie od wydań Hermes. Rejestracja jest dostępna pod adresem https://portal.nousresearch.com/; aktualne tiery należy sprawdzić na stronie cennika.

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 przez pole konfiguracji use_gateway dla poszczególnych narzędzi i ograniczane stanem subskrypcji Portal.²⁶

Ujęcie: czym ta wersja nie jest

Hermes Agent CLI nie jest ukryty za subskrypcją. Projekt nadal jest na licencji MIT, wszystkie funkcje podstawowe (CLI, skills, pamięć, messaging gateway, cron, MCP, lokalny dashboard, BYOK dla każdego dostawcy) działają od początku do końca 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 ze ścieżki bezpłatnej.

Messaging Gateway

Hermes może działać jako długotrwały proces gateway, który łączy się z 22 platformami komunikacyjnymi z poziomu jednego procesu gateway: Telegram, Discord, Slack, WhatsApp, Signal, SMS, Email, Home Assistant, Mattermost, Matrix, DingTalk, Feishu/Lark, WeCom, Weixin (WeChat), BlueBubbles (iMessage), QQBot, Microsoft Teams, Tencent Yuanbao, Google Chat, LINE, SimpleX Chat oraz ogólny adapter Webhook.^325171819 Wersja v0.9.0 dodała iMessage przez BlueBubbles (automatyczną rejestrację webhook, kreator konfiguracji, odporność na awarie) oraz natywną obsługę WeChat przez iLink Bot API z trybem callback WeCom dla aplikacji firmowych.¹⁶ Wersja v0.11.0 dodała QQBot.²⁵ Wersja v0.12.0 dodała Microsoft Teams i Tencent Yuanbao.¹⁷ v0.13.0 dodała Google Chat jako 20. platformę, korzystającą z tej samej pluggable architektury adapterów; IRC i Microsoft Teams również przeniesiono na nowy wzorzec adapterów z ogólnymi hookami plugin env_enablement_fn / cron_deliver_env_var.¹⁸ v0.14.0 dodaje LINE i SimpleX Chat oraz domyka stos Microsoft Teams end-to-end z Graph auth, listenerem webhook, środowiskiem pipeline runtime i dostarczaniem wychodzącym.¹⁹ v0.17.0 (19 czerwca 2026) dodaje iMessage bez relay przez Photon Spectrum (OAuth device-code z hermes photon login — bez wymaganego relay Mac/BlueBubbles), oficjalny adapter WhatsApp Business Cloud API (zastępujący wymóg 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 podłączanie każdej platformy: tokeny API, identyfikatory botów, mapowania kanałów, allowlisty.⁶

Jak przepływają 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 przechodzi przez tę samą pętlę konwersacji AIAgent co CLI. Dlatego polecenia slash działają identycznie w obu miejscach, a zadanie cron zaplanowane w Telegram może dostarczyć wynik do Discord — różnica między platformami znajduje się wyłącznie na brzegu systemu.³

Autoryzacja użytkowników i pairing

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

Kody pairing uniemożliwiają przypadkowym obcym osobom rozmowę z gateway. Użytkownik wysyła kod pairing ze swojej platformy komunikacyjnej; zatwierdza się go poleceniem hermes pairing approve; od tego momentu użytkownik jest autoryzowany.⁶

Zaplanowane zadania (Cron)

Hermes ma pełnoprawny system cron, w którym zadania są zadaniami agentów, a nie poleceniami shell. Każde zaplanowane zadanie działa przez świeży AIAgent ze skonfigurowanym promptem, opcjonalnie dołączonymi skill 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ć je 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ą trwale zapisywane w JSON i przetrwają ponowne uruchomienia.³

Integracja MCP

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

Jako klient — można połączyć Hermes z zewnętrznymi serwerami MCP, aby rozszerzyć jego powierzchnię narzędziową:

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

Albo ręcznie w config.yaml:¹⁴

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

Jako serwer — można udostępniać konwersacje Hermes innym agentom:

hermes mcp serve
hermes mcp serve -v    # Verbose

Kompresja kontekstu

Hermes automatycznie kompresuje długie konwersacje, aby zmieścić się w oknie kontekstu modelu. Summarizer 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 model główny, ponieważ otrzymuje pełną środkową część konwersacji do kompresji.⁴

Ostrzeżenia o presji budżetu

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

Limity czasu strumienia

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

Limit czasu odczytu socketu jest podnoszony do 30 minut dla lokalnych endpointów, ponieważ lokalne LLM mogą potrzebować kilku minut na prefill przy dużych kontekstach, zanim wygenerują pierwszy token.⁴

Lokalny dashboard webowy (v0.9.0+)

Dashboard w przeglądarce do lokalnego zarządzania Hermes Agent. Można konfigurować ustawienia, monitorować sesje, przeglądać skill i zarządzać gateway bez dotykania plików konfiguracyjnych ani terminala.¹⁶ Uruchamia się go poleceniem hermes dashboard. To najprostsza ścieżka onboardingu dla nowych użytkowników, którzy wolą GUI.

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

watch_patterns pozwala ustawić wzorce monitorowane w danych wyjściowych procesu w tle i otrzymywać powiadomienia w czasie rzeczywistym, gdy zostaną dopasowane.¹⁶ Można monitorować błędy, czekać na konkretne zdarzenia („listening on port”) albo obserwować logi buildów — wszystko bez pollingu. W połączeniu z notify_on_complete z v0.8.0 (powiadamiającym o zakończeniu zadania w tle) Hermes ma teraz pełną warstwę obserwowalności procesów w tle.¹⁵

Pluggable Context Engine (v0.9.0+)

Zarządzanie kontekstem jest teraz pluggable slot przez hermes plugins. Można podmieniać własne silniki kontekstu, które kontrolują, co agent widzi w każdej turze — filtrowanie, summarization albo wstrzykiwanie kontekstu specyficznego dla domeny.¹⁶ Oddziela to strategię kontekstu od głównej pętli agenta, umożliwiając dostosowanie kontekstu dla konkretnego projektu lub domeny.

Backup i restore (v0.9.0+)

hermes backup tworzy pełne archiwum konfiguracji, sesji, skill i pamięci. hermes import przywraca dane z archiwum backup.¹⁶ Warto używać tego do migracji między maszynami, tworzenia snapshotów przed dużymi zmianami albo udostępniania zespołowi 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 i polecenie /image działają bezpośrednio na urządzeniu.¹⁶

Wzmocnienie zabezpieczeń (v0.13.0+)

v0.13.0 zamknęła 8 problemów bezpieczeństwa P0 i zmieniła jedno ustawienie domyślne na korzyść użytkownika.¹⁸ v0.14.0 dodaje kolejne zamknięcia: 12 P0 i 50 P1, w tym wzmocnienie sudo brute-force / sudo-stdin, poprawki obejść niebezpiecznych poleceń, sanityzację błędów narzędzi przed ponownym wstrzyknięciem do modelu, uwierzytelnianie API wtyczki dashboardu, pokrycie SSRF w skills-hub oraz skanowanie ostrzeżeń dotyczących łańcucha dostaw podczas instalacji.¹⁹

Jeśli utrzymywane jest wdrożenie Hermes, v0.13.0 i v0.14.0 należy traktować jako aktualizacje istotne dla bezpieczeństwa, a nie tylko pakiety nowych funkcji. v0.13.0 zamyka obejście między guildami w Discord i dwa okna TOCTOU; v0.14.0 dodaje kolejną rundę wzmocnień obejmującą obsługę sudo, ponowne wstrzykiwanie błędów narzędzi, API wtyczek, SSRF w skills-hub oraz ostrzeżenia dotyczące 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 debugować system, rozszerzać go albo analizować wydajność. To synteza dokumentacji architektury upstream.³

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 upstream.³

„47 narzędzi / 20 toolsetów” kontra „28 narzędzi” w banerze. Liczba „47 tools” oznacza pełny rejestr narzędzi w repozytorium upstream — każde narzędzie, z którym Hermes dostarcza kod źródłowy, we wszystkich toolsetach. Rzeczywiście uruchomiony CLI pokaże w banerze startowym mniejszą liczbę (instalacja, względem której zweryfikowano ten przewodnik, raportuje 28 tools / 89 skills). To nie błąd. Wiele toolsetów jest opcjonalnych i trzeba je jawnie włączyć w config.yaml w sekcji toolsets: — adaptery platform komunikacyjnych, automatyzację przeglądarki, cięższe narzędzia scrapingowe 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ć poleceniem hermes tools --list, a poszczególne toolsety włączać lub wyłączać blokiem toolsets: w ~/.hermes/config.yaml (albo przez /tools list / /tools enable <name> / /tools disable <name> wewnątrz działającej sesji — usunięcie narzędzia wywołuje reset sesji, aby agent odbudował swój manifest narzędzi).

Trzy tryby API

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

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

Z dokumentacji architektury upstream.³

Kolejność składania promptu

Stos promptu obejmuje:¹³

1. SOUL.md (tożsamość agenta — albo wbudowany fallback, jeśli plik jest niedostępny)
2. Wskazówki zachowania świadomego narzędzi
3. Pamięć/kontekst użytkownika (MEMORY.md, USER.md)
4. Wskazówki dotyczące skills
5. Pliki kontekstowe (AGENTS.md, .cursorrules)
6. Znacznik czasu
7. Wskazówki formatowania specyficzne dla platformy
8. Opcjonalne nakładki system-promptu, takie jak /personality

SOUL.md jest fundamentem — wszystko inne buduje się na nim.¹³

Przechowywanie sesji

Przechowywanie sesji oparte na SQLite z pełnotekstowym wyszukiwaniem FTS5. Sesje mają śledzenie pochodzenia (relacje parent/child między kompresjami), izolację per platforma oraz atomowe zapisy z obsługą konfliktów dostępu.³

System wtyczek

Trzy źródła wykrywania: ~/.hermes/plugins/ (użytkownik), .hermes/plugins/ (projekt) oraz punkty wejścia pip. Wtyczki rejestrują narzędzia, hooki i polecenia CLI przez kontekst API. Dostawcy pamięci są wyspecjalizowanym typem wtyczki 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 projektowe

Z dokumentacji architektury upstream:³

Migracja z OpenClaw

Hermes Agent jest następcą OpenClaw. Przy 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 też starsze katalogi ~/.clawdbot i ~/.moldbot) i zapisuje je do ~/.hermes.⁶

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

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

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

Rozwiązywanie problemów

„Klucz API nie jest ustawiony”

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

„Context limit: 2048 tokens” przy uruchamianiu (modele lokalne)

Hermes automatycznie wykrywa długość kontekstu z punktu końcowego /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 pojawiają się jako tekst zamiast się wykonywać

Na serwerze nie włączono wywoływania narzędzi albo model nie obsługuje go przez implementację danego serwera.²

Odpowiedzi urywają się w połowie zdania

Możliwe są 2 przyczyny:²

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

„Connection refused” z WSL2 do serwera modelu hostowanego w Windows

WSL2 używa wirtualnej karty sieciowej z własną podsiecią — localhost wewnątrz WSL2 odnosi się do maszyny wirtualnej Linux, a nie hosta Windows. Dostępne są 2 opcje:²

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

[wsl2]
networkingMode=mirrored

Następnie uruchomić wsl --shutdown i ponownie wystartować WSL. localhost działa teraz w obu kierunkach.

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

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

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

Gdzie wszystko jest?

hermes status i hermes dump są tu przydatne. hermes logs list pokazuje wszystkie pliki dziennika wraz z rozmiarami. hermes config path wypisuje lokalizację pliku konfiguracji. hermes config env-path wypisuje lokalizację .env.⁶

FAQ

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

Claude Code to oficjalny CLI od Anthropic, ograniczony do modeli Anthropic. Hermes Agent to open-source’owy framework agentowy od Nous Research, który działa z dowolnym dostawcą zgodnym z OpenAI — Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Hugging Face, Google albo własnym samoobsługowym punktem końcowym.¹² Hermes zawiera także gateway komunikacyjny dla Telegram/Discord/Slack/WhatsApp/Signal, którego Claude Code nie ma.

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

Tak. Są 3 sposoby:²

1. Ustawić ANTHROPIC_API_KEY w ~/.hermes/.env i uruchomić hermes chat --provider anthropic --model claude-sonnet-4-6
2. Uruchomić hermes model i wybrać Anthropic — Hermes użyje magazynu poświadczeń Claude Code, jeśli będzie dostępny
3. Ustawić ręczny ANTHROPIC_TOKEN (setup-token albo token OAuth) jako opcję awaryjną

Opcja 2 jest zalecana, jeśli Claude Code jest już używany na tym samym komputerze — pozwala zachować odświeżalne poświadczenia Claude jako odświeżalne.

Jak przełączać dostawców bez utraty rozmowy?

Użyć /model provider:model wewnątrz sesji. Historia rozmowy, pamięć i skills zostają zachowane:⁹

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

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

Uruchamia się awaryjny model pomocniczy. Vision, podsumowywanie web, kompresja i inne zadania poboczne używają osobnego pomocniczego LLM — domyślnie Gemini Flash przez automatyczne wykrywanie (OpenRouter → Nous → Codex). Jeśli żaden z nich nie jest skonfigurowany, a ustawiono tylko Anthropic, te funkcje po cichu działają gorzej.⁴

Poprawka: dodać OPENROUTER_API_KEY dla zadań pomocniczych albo przekonfigurować sloty pomocnicze tak, aby używały głównego dostawcy. Warto zauważyć, że kompresja kontekstu znajduje się we własnym bloku najwyższego poziomu compression: i przyjmuje summary_provider, a nie auxiliary.compression.provider — slot auxiliary.compression udostępnia tylko timeout. Pełna poprawka:

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. Znajduje się w ~/.hermes/SOUL.md i działa wszędzie. AGENTS.md jest specyficzny dla projektu — architektura, konwencje, polecenia, ścieżki — i znajduje się w katalogu projektu.¹³ Jeśli coś ma obowiązywać wszędzie, należy użyć SOUL.md. Jeśli dotyczy projektu, AGENTS.md.

Jak uruchomić wiele instancji Hermes obok siebie?

Profile. Każdy profile otrzymuje 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 LLMs?

Tak, przez ścieżkę niestandardowego punktu końcowego. Hermes działa z dowolnym serwerem zgodnym z OpenAI: Ollama, vLLM, SGLang, llama.cpp/llama-server, LM Studio, LocalAI, Jan albo własnym.² Konfigurację dla poszczególnych serwerów opisuje sekcja Niestandardowe i samoobsługowe punkty końcowe.

Dlaczego baner startowy pokazuje mniej narzędzi niż przewodnik przypisuje Hermes?

Przewodnik podaje 47 narzędzi / 20 toolsets z nadrzędnego rejestru architektury — to pełna liczba narzędzi, których kod źródłowy Hermes zawiera we wszystkich toolsets. Działająca instalacja pokazuje w banerze mniejszą liczbę (instalacja referencyjna użyta w tym przewodniku zgłasza 28 narzędzi), ponieważ Hermes podczas uruchamiania włącza tylko domyślny zestaw toolset. Wiele toolsets jest opcjonalnych: adaptery gateway komunikacyjnego, automatyzacja przeglądarki, cięższe stosy scrapingowe i kilka wyspecjalizowanych integracji muszą być jawnie wymienione pod toolsets: w ~/.hermes/config.yaml, zanim zostaną załadowane. Łączna liczba w rejestrze = „co jest dostępne po włączeniu”. Łączna liczba w banerze = „co faktycznie załadował obecny profile”. Użyć hermes tools --list, aby zobaczyć, które toolsets są aktywne, a które dostępne, ale wyłączone. Poszczególne toolsets można przełączać w czasie działania za pomocą /tools enable <name> i /tools disable <name> (wyłączenie wyzwala reset sesji, aby agent odbudował manifest narzędzi z nowym kształtem).

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

Skonfigurować 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 awaryjny w trakcie sesji bez utraty historii rozmowy. Dzieje się to najwyżej raz na sesję.

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

Tak — to część Hermes Agent określana jako „self-improving”. Agent może tworzyć, aktualizować i usuwać skills za pomocą narzędzia skill_manage. Gdy rozpracuje nietrywialny workflow, zapisuje podejście jako skill do przyszłego użycia.¹¹ Agent tworzy skills po złożonych zadaniach (ponad 5 wywołań narzędzi), gdy napotka błędy i znajdzie działającą ścieżkę, gdy poprawią Państwo jego podejście albo 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

Dziennik zmian

Źródła