Hermes Agent: Die Referenz für Praktiker (2026)

Kurzfassung: Hermes Agent ist ein selbstverbessernder Open-Source-AI-Agent von Nous Research. Er läuft als CLI und als plattformübergreifendes Messaging-gateway, speichert eine dauerhafte Identität und persistente Memory auf der Festplatte, bündelt skills, die sich durch Nutzung verbessern, und arbeitet mit jedem OpenAI-kompatiblen LLM-Provider — Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Qwen Cloud, Hugging Face, Google, xAI/SuperGrok oder Ihrem eigenen selbst gehosteten Endpoint.¹²¹⁹ Seit v0.14.0 (16. Mai 2026) ergänzt Hermes SuperGrok OAuth mit grok-4.3 1M Context, einen OpenAI-kompatiblen lokalen proxy für OAuth-Provider (hermes proxy), erstklassiges x_search, PyPI-Installationssupport, lazy Dependency-Installationen, 22 Messaging-Plattformen mit LINE und SimpleX Chat, /handoff, semantische LSP-Diagnosen nach Schreibvorgängen, einheitliches video_generate, computer_use über cua-driver für Nicht-Anthropic-Provider, native Windows-Beta sowie 12 P0- und 50 P1-Abschlüsse.¹⁹ Der schwierigste Teil für die meisten neuen Benutzer ist die Provider-Authentifizierung: Hermes unterstützt etwa 20 erstklassige Provider plus benutzerdefinierte Endpoints und 3 verschiedene Auth-Pfade (API-Schlüssel in .env, OAuth über hermes model oder benutzerdefinierter Endpoint in config.yaml). Das Auth-Modell sollten Sie zuerst verstehen — alles andere hängt davon ab, welcher Provider aufgelöst wird.

Hermes Agent arbeitet als vollständige Agent-Runtime, nicht als Chat-Wrapper. Er liest Ihr Dateisystem, führt Befehle in sandboxed Backends aus, scraped das Web, startet Subagents, führt geplante cron-Jobs aus, kommuniziert über Telegram/Discord/Slack/WhatsApp/Signal/Email aus einem einzigen gateway-Prozess heraus und erstellt aus Erfahrung eigene skills.¹ Die CLI ist eine Terminal-UI auf Basis einer Conversation Loop in run_agent.py; das gateway ist ein lang laufender Prozess, der Nachrichten von Messaging-Plattformen durch dieselbe Conversation Loop routet.³

Der Unterschied zwischen gelegentlicher und professioneller Hermes-Nutzung liegt in 5 Systemen. Beherrschen Sie diese, wird Hermes zu einem Kraftmultiplikator:

1. Provider-Auflösung: wie Auth-Flows auf API-Aufrufe abgebildet werden
2. Konfigurationshierarchie: config.yaml + .env + auth.json + SOUL.md + AGENTS.md
3. Tool- + toolset-System: was der Agent tun kann, je Plattform eingeschränkt
4. skills-System: prozedurale Memory, die der Agent erstellt und weiterentwickelt
5. gateway + cron + profile: Hermes dort ausführen, wo Sie arbeiten, nicht nur dort, wo Sie gerade sind

Wichtige Erkenntnisse

• Provider-Auth besteht aus 3 Pfaden, nicht aus einem. API-Schlüssel in .env, OAuth über hermes model/hermes auth oder benutzerdefinierter Endpoint in config.yaml. Wählen Sie den Pfad, der zu Ihrem Provider passt, nicht den, der Ihnen vertraut vorkommt.
• Provider-Wechsel erfolgen mit einem einzigen Befehl. hermes model führt Sie interaktiv durch jeden unterstützten Provider einschließlich OAuth-Logins, und /model provider:model wechselt mitten in der Sitzung, ohne den Verlauf zu verlieren.²
• 2 Dateien bilden die vom Benutzer editierbare Konfigurationsoberfläche. ~/.hermes/config.yaml enthält Einstellungen, ~/.hermes/.env enthält Secrets. auth.json, SOUL.md, MEMORY.md und skills/ werden direkt von Hermes verwaltet — Sie können SOUL.md von Hand bearbeiten, den Rest verändert der Agent selbst.⁴
• Hermes ist der Nachfolger von OpenClaw. Wenn Sie migrieren, importiert hermes claw migrate automatisch mehr als 30 Zustandskategorien.⁵
• Die Servicequalität hängt von Ihrem Hilfsmodell ab. Vision, Web-Zusammenfassung, Compression und Memory Flush verwenden alle ein separates Hilfs-LLM. Standardmäßig ist das Gemini Flash über Auto-Erkennung (OpenRouter → Nous → Codex) — wenn keiner davon konfiguriert ist, verschlechtern sich diese Funktionen stillschweigend, bis Sie die Hilfs-Slots auf Ihren Hauptprovider verweisen lassen.⁴

Was v0.14 ändert

v0.14.0 dreht sich weniger um eine einzelne Hauptfunktion als darum, den Setup-Aufwand zu reduzieren und zugleich zu erweitern, wo Hermes laufen kann.¹⁹ Die wichtigsten betrieblichen Änderungen:

• Installation und Start sind leichter. pip install hermes-agent funktioniert über PyPI, schwere Adapter werden bei der ersten Nutzung lazy installiert, und der Startpfad verzögert genug Arbeit, um den Kaltstart um etwa 19 Sekunden zu verkürzen.
• Abonnements können zu lokalen API-Endpoints werden. hermes proxy verwandelt OAuth-gestützte Provider wie Claude Pro, ChatGPT Pro und SuperGrok in einen OpenAI-kompatiblen lokalen Endpoint für Tools wie Codex, Aider, Cline und Continue.
• Die gateway-Reichweite wächst. LINE und SimpleX Chat erhöhen die Plattformanzahl auf 22, Microsoft Teams ist durchgängig angebunden, Discord-Verlaufs-Backfill ist standardmäßig aktiviert, und Telegram/Discord-clarify-Prompts nutzen nun native Schaltflächen.
• Verifikation zur Schreibzeit wird besser. Nach Bearbeitungen kann Hermes pro Turn Zusammenfassungen von Dateimutationen und semantische Language-Server-Diagnosen anzeigen, bevor der nächste Turn beginnt; damit rückt es näher an evidenzgetriebene Agent-Arbeit heran.
• Desktop- und Medien-Tools werden breiter. computer_use funktioniert über cua-driver für Nicht-Anthropic-Provider, video_generate ist einheitlich hinter austauschbaren Backends gebündelt, und vision_analyze sendet rohe Pixel an Modelle, die tatsächlich sehen können.

Jeder folgende Abschnitt stützt sich auf die Upstream-Dokumentation unter hermes-agent.nousresearch.com/docs und den Source Tree unter github.com/NousResearch/hermes-agent. Jede Tatsachenbehauptung hat eine Fußnote, die auf die konkrete Upstream-Seite verweist, von der sie stammt.

Wählen Sie Ihren Weg

Wie Hermes funktioniert: Das Mental Model

Hermes ist um eine einzelne Konversationsschleife herum aufgebaut, die jeder Einstiegspunkt aufrufen kann. Die Einstiegspunkte sind die CLI (cli.py), das Messaging-gateway (gateway/run.py), der ACP-Adapter für die Editor-Integration, der Batch-Runner und ein API-Server.³ Alle rufen letztlich AIAgent.run_conversation() in run_agent.py auf, das:

1. den System-Prompt aus SOUL.md, MEMORY.md, USER.md, skills, Kontextdateien und Tool-Anweisungen über prompt_builder.py erstellt³
2. den Runtime-Provider über runtime_provider.py auflöst — in diesem Schritt werden Ihre Authentifizierung, die Base-URL und der API-Modus ausgewählt³
3. den Provider mit einem von drei API-Modi aufruft: chat_completions, codex_responses oder anthropic_messages³
4. alle zurückgegebenen Tool-Aufrufe über model_tools.py und die zentrale Tool-Registry (tools/registry.py) weiterleitet³
5. die Schleife fortsetzt, bis das Modell eine finale Antwort erzeugt, und die Sitzung anschließend mit FTS5 in SQLite speichert³

Diese Schleife zu verstehen ist wichtig, weil jede Funktion — Persönlichkeiten, Memory, skills, Komprimierung, Fallback — an einer dieser Stufen ansetzt. Wenn Sie einen Konfigurationsschlüssel lesen und sich fragen, was er bewirkt, lautet die Antwort meist: „Er ist ein Regler für Stufe 1, 2, 3 oder 4 der obigen Schleife.“

Plattformunabhängiger Kern. Eine einzige AIAgent-Klasse bedient CLI, gateway, ACP, Batch und API-Server. Plattformunterschiede liegen im Einstiegspunkt, nicht im Agenten selbst.³ Deshalb funktionieren dieselben Slash Commands im Terminal und in Telegram — sie werden aus einer gemeinsamen COMMAND_REGISTRY in hermes_cli/commands.py heraus verarbeitet.⁶

Die Verzeichnisstruktur ist das System. Hermes speichert alles unter ~/.hermes/ (oder $HERMES_HOME für Profile außerhalb der Standardeinstellung):⁴

~/.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)

Jede oben genannte Datei hat eine bestimmte Rolle; keine davon überschneidet sich. Wenn Sie nach „Wo speichert Hermes X?“ suchen, ist es eine dieser Dateien.

Was ist neu in v0.18.0 (The Judgment Release)

Hermes Agent v0.18.0 (Tag v2026.7.1, 1. Juli 2026) ist nach Urteilsvermögen benannt: Der Agent überprüft seine eigene Arbeit, statt Erfolg nur zu behaupten, und bietet Ensemble-Reasoning, das Sie tatsächlich prüfen können. Außerdem schließt diese Version den gesamten P0/P1-Backlog — rund 692 Einträge mit höchster Priorität wurden in zwölf Tagen erledigt.²²

• Mixture-of-Agents als First-Class-Modell. MoA ist nun über alle Oberflächen hinweg wie jedes andere Modell auswählbar, und Ensemble-Reasoning ist sichtbar: Die vollständige Ausgabe jedes Referenzmodells wird als eigener beschrifteter Block mit Live-Antwortstreaming dargestellt — Sie können dem Ensemble beim Denken zusehen, statt eine undurchsichtige zusammengeführte Antwort zu erhalten.²²
• Completion Contracts für /goal. Der Agent überprüft seine eigene Arbeit, indem er die Projektchecks ausführt, bevor er ein Ziel als abgeschlossen meldet, statt Erfolg nur zu behaupten — Urteilsvermögen auf sich selbst angewandt.²²
• /learn — alles in eine skill beschreiben. Verwandeln Sie einen Workflow in eine wiederverwendbare skill, indem Sie ihn beschreiben; generierte skills erfüllen automatisch die CONTRIBUTING.md-Konventionen des Repos.²²
• /journey-Zeitleiste. Eine visuelle Historie von Memory und skills im Zeitverlauf, inklusive Bearbeitung, sowie ein Memory-Graph auf dem Desktop.²²
• Background-Subagent-Fan-out. Delegieren Sie mehrere Aufgaben, die gleichzeitig laufen, ohne die Konversation zu blockieren — aus dem einzelnen Background-Subagent von v0.17.0 wird eine ganze Flotte.²²
• Desktop Projects. First-Class-Coding-Projects mit einem Organisationsmodell aus Projekt, Repo und Lane.²²
• Scale-to-zero-gateway. Gateways können bei Inaktivität in den Ruhezustand wechseln und Drains für nahtlose Deployments koordinieren — relevant für alle, die Hermes als dauerhaft laufenden Dienst betreiben.²²
• Google Vertex AI-Unterstützung. Gemini-Zugriff über GCP-Service-Accounts mit automatischer OAuth2-Token-Aktualisierung, nun Teil des Provider-Katalogs.²²
• /prompt-Editorbefehl. Öffnet $EDITOR, um mehrzeilige Prompts zu verfassen, statt sich mit der Eingabezeile abzumühen.²²

Wenn Sie von v0.17.x aktualisieren, bricht hier nichts die CLI. Die wichtigsten Gründe für ein Upgrade sind Completion Contracts (Ziele, die sich selbst überprüfen), First-Class-MoA mit prüfbaren Ensembles und /learn zur Erfassung von skills.

Was ist neu in v0.17.0 (The Reach Release)

Hermes Agent v0.17.0 (Tag v2026.6.19, 19. Juni 2026) ist danach benannt, wie weit der Agent nun reicht — neue Messaging-Kanäle, neue Modellanbieter sowie tiefere Desktop- und Dashboard-Steuerung. Die Version ergänzt v0.16.x; die CLI-Oberfläche bleibt unverändert.²¹

• Neue Messaging-Kanäle. iMessage funktioniert jetzt ohne Mac-Relay über Photon Spectrum (Device-Code-OAuth, hermes photon login); die WhatsApp Business Cloud API ist ein offizieller Meta-Adapter, der die Bridge-Prozess-Anforderung ersetzt; SimpleX erhält Gruppen, native Anhänge, Text-Batching und Auto-Accept; und Raft kommt als gebündeltes Plattform-Plugin mit einem Wake-Channel-Design nach Privacy-by-Contract hinzu.²¹
• Neue Modelle und Provider. Der Katalog ergänzt z-ai/glm-5.2 (1M Kontext), anthropic/claude-fable-5, laguna-m.1, nemotron-3-ultra und grok-composer-2.5-fast (Cursors Modell über xAI OAuth, 200k Kontext). Der xAI-Standard wurde auf grok-build-0.1 umgestellt, und adaptive Anthropic-Modelle folgen jetzt dem modernen Thinking Contract (sie senden nie ein reasoning-Feld).²¹
• Desktop und Dashboard. Desktop ergänzt Background-Subagents mit Live-„Watch-Windows“, die delegierte Aktivität streamen (delegate_task(background=true)), einen Composer-Modellselektor, neu belegbare Tastenkürzel, native OS-Benachrichtigungen, Composer-Entwürfe pro Thread, VS Code Marketplace-Themes sowie japanische und traditionell chinesische UI. Das Dashboard ergänzt einen vollständigen Profile Builder (Modell/skills/MCPs ohne Bearbeitung von config.yaml), einen globalen Profilumschalter, einen überarbeiteten Skills Hub mit Security Scan, Automation Blueprints (parametrisierte Vorlagen für Formular, Slash Command, Konversation und Dokumentation) sowie ein sicheres Login, das hinter dem OAuth-Gate 401 zurückgibt.²¹
• Skills und Tools. image_generate kann jetzt ein Quellbild bearbeiten und transformieren, statt nur neue Bilder von Grund auf zu erstellen, und zwar über alle unterstützten Bildprovider hinweg; das memory-Tool erhielt ein operations-Array für atomare Batch-Vorgänge zum Hinzufügen/Ersetzen/Entfernen in einem einzigen Aufruf; eine neue simplify-code-skill führt einen parallelen Review-und-Cleanup-Durchlauf mit drei Agenten aus, gesteuert durch eine Chesterton’s-Fence-Risikostufe; und ein boolesches write_approval ersetzt das dreistufige write_mode.²¹
• Architektur. Background-Subagents geben sofort ein Handle zurück und bringen ihr Ergebnis als neuen Turn wieder ein; ein MCP-Elicitation-Handler erlaubt Bestätigung mitten im Tool-Aufruf, und spät verbundene MCP-Tools werden zwischen Turns verfügbar gemacht (cache-sicher); cron wird zu einem steckbaren CronScheduler mit Chronos-Managed-cron-Provider; und ein neuer Managed scope (/etc/hermes) erlaubt Administratoren, für Benutzer unveränderliche Konfiguration festzulegen, ergänzt durch ein Gateway-Gateway-Relay für Multi-Gateway-Topologien.²¹
• Neue Befehle. /version, /billing (interaktives Terminal-Billing), hermes photon login (iMessage-Auth) und hermes curator run --consolidate — Konsolidierung ist jetzt opt-in, sodass routinemäßige Hintergrundkuratierung null Tokens kostet.²¹
• Sicherheit. v0.17.0 schließt einen Shell-Escape-Denylist-Bypass, schlägt bei fehlenden Approval-Modulen und Own-Policy-gateway-Adaptern geschlossen fehl, bereinigt die Umgebung für Cron-Job-Script-Subprozesse, schwärzt Secrets in Request-Debug-Dumps, prüft MCP-stdio-Konfigurationen auf Exfil-Muster und hebt urllib3 sowie PyJWT an, um CVEs zu beheben.²¹

Wenn Sie von v0.16.x aktualisieren, bricht hier nichts die CLI; es sind neue Kanäle, Modelle und Oberflächen rund um denselben Agenten. Relay-freies iMessage, die offiziellen WhatsApp-Adapter und der Administrator-Managed scope sind die wichtigsten Gründe für ein Upgrade.

Was ist neu in v0.16.0 (The Surface Release)

Hermes Agent v0.16.0 (Tag v2026.6.5, 5. Juni 2026) ist nach den neuen Oberflächen benannt, die vor den CLI-first Agent gesetzt werden. Die wichtigste Neuerung: Hermes ist nicht mehr nur im Terminal nutzbar.²⁰

• Native Desktop-App. Hermes Desktop ist eine neue Electron-App für macOS, Linux und Windows mit Ein-Klick-Installation und Selbstaktualisierung in der App. Sie bietet Ihnen ein Streaming-Chatfenster, Drag-and-drop-Dateien, Einfügen von Bildern aus der Zwischenablage, eine Cmd+K-Palette, eine Sitzungsliste mit Archiv und Suche sowie eine Modellauswahl in der Statusleiste. Sie kann über ein sicheres WebSocket eine Verbindung zu einem entfernten Hermes gateway herstellen, mit Authentifizierung per OAuth oder Benutzername/Passwort, mit entfernten Hosts pro profile und gleichzeitigen Multi-profile-Sitzungen, die über profilübergreifende @session-Verweise verbunden sind. Die Desktop-UI wird außerdem mit einer vollständigen Übersetzung ins vereinfachte Chinesisch (简体中文) über eine typisierte i18n-Schicht ausgeliefert (display.language; Englisch bleibt die Standardeinstellung).²⁰
• Browser-Administrationspanel. Das lokale Web-Dashboard ist von einer Statusansicht zu einem vollständigen Administrationspanel geworden: ein MCP-Katalog mit Aktivieren/Deaktivieren-Schaltern, Zugangsdatenverwaltung, Webhook- und Hook-Erstellung, Speicherkonfiguration, gateway-Steuerung und einer Systemseite mit Prüfung vor Aktualisierung plus Ein-Klick-Debug-Share. Eine neue Channels-Seite konfiguriert jede gateway-Messaging-Plattform (Telegram, Discord, Slack und die übrigen) im Browser. Auth ist jetzt austauschbar: Login mit Benutzername/Passwort, ein generischer selbst gehosteter OIDC-Anbieter, hermes dashboard register für einen selbst gehosteten OAuth-Client und Refresh-Token-Sitzungsrotation.²⁰
• Neue CLI- und Slash-Befehle. /undo [N] sichert die letzten N Benutzer-Turns mit Prefill und Soft-Delete und funktioniert in CLI, TUI und über Messaging-Plattformen hinweg. Eine konfigurierbare Standardschnittstelle (cli vs. tui) kommt mit einer --cli-Überschreibung; die TUI erhält einen einheitlichen /model-Befehl und ein Sessions-Overlay. hermes portal ist ein menschenlesbarer Alias für den Nous Portal-Onboarding-Flow, mit neuen Erststartpfaden Quick Setup vs. Full Setup, und zwei Diagnosebefehle kommen hinzu: hermes prompt-size und hermes sessions optimize.²⁰
• Neue Modelle und Anbieter. Die Auswahl ergänzt deepseek-v4-flash, MiniMax-M3 (1M Kontext, native MiniMax-Anbieter), qwen3.7-plus (Nous + OpenRouter) und gemini-3.5-flash (Gemini OAuth + API-Schlüssel). Ein erstklassiger xAI Grok OAuth-Anbieter kommt zum Desktop-Launcher hinzu, die Modellauswahl wurde auf jeder Oberfläche unscharf durchsuchbar, Anbieter mit mehreren Endpunkten werden in einer Zeile gruppiert, und die Katalogaktualisierung wurde von täglich auf stündlich umgestellt.²⁰
• Schlankere skills und progressive Offenlegung. Der Standard-skill-Satz hat redundante und tote skills entfernt (Spotify wurde in ein natives Plugin verschoben, Linear zu hermes mcp install linear, und mehrere veraltete Einträge wurden entfernt), mehr in optionale Bereiche verschoben und ein environments:-Frontmatter-Relevanzgate (kanban/docker/s6) ergänzt, das kontextspezifische skills aus dem Index heraushält, bis sie angefordert werden. NVIDIA/skills ist jetzt neben OpenAI, Anthropic und HuggingFace ein standardmäßig vertrauenswürdiger Skills Hub-Tap. MCP- und Plugin-Tools haben eine progressive (bereichsbezogene) Tool-Offenlegung erhalten, und ein MCP-Fehler, der fälschlich OAuth-Erfolg meldete, obwohl kein Token erhalten wurde, ist behoben.²⁰
• Sicherheit. v0.16.0 pinnt gepatchtes Starlette (≥1.0.1) für CVE-2026-48710 (BadHost), verlagert SSRF-URL-Prüfungen in asynchronen Pfaden aus dem Event-Loop, entfernt das Bedrock-Inference-Bearer-Token aus der Subprozess-Umgebung, nimmt bws_cache.json in den Dateisicherheits-Leseschutz auf, ergänzt docker restart/stop/kill in der Liste gefährlicher Muster und bereinigt unsichtbares Unicode in geprüften skill-Inhalten. Das Release schloss 2 P0- und 62 P1-Probleme, davon 16 mit Sicherheits-Tag.²⁰

Wenn Sie von v0.15.x aktualisieren, ist nichts davon eine Breaking Change am CLI selbst; es sind zusätzliche Oberflächen und Anbieter rund um denselben Agent. Die Desktop-App und das Administrationspanel sind der Grund für das Upgrade, wenn Sie Hermes für Benutzer ohne Terminal betreiben oder ein entferntes gateway über einen Browser administrieren möchten.

Installation

Der Einzeilen-Installer bleibt für die meisten Benutzer der geführte Weg. Er übernimmt Python, uv, Node.js, ripgrep, ffmpeg, den Repo-Klon, die virtuelle Umgebung und den globalen Befehl hermes.⁷ v0.14.0 liefert außerdem ein echtes PyPI-Paket aus, sodass pip install hermes-agent jetzt eine praktikable Direktinstallation ist, wenn Sie die Python-Umgebung bereits kontrollieren.¹⁹

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

pip install hermes-agent
hermes

Funktioniert unter Linux, macOS, WSL2 und Android/Termux (der Installer erkennt Termux automatisch und wechselt zu einem getesteten Android-Bundle).⁷ v0.14.0 fügt native Windows-Unterstützung in einer frühen Beta über einen PowerShell-Installer hinzu, WSL2 bleibt jedoch die sicherere Empfehlung für den Produktionseinsatz, bis der Windows-Pfad ausgereifter ist.¹⁹

Nach Abschluss:

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

Die einzige Voraussetzung ist git. Der Installer stellt Python 3.11 automatisch über uv bereit (kein sudo erforderlich), außerdem Node.js v22 (für Browser-Automatisierung und die WhatsApp-Bridge), ripgrep und ffmpeg.⁷

Installation überprüfen

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 zeigt Ihnen genau, was fehlt und wie Sie es beheben.⁷ hermes dump ist der Diagnosebefehl, den Sie in ein GitHub-Issue oder einen Discord-Thread einfügen, wenn Sie Hilfe anfordern — eine Klartextzusammenfassung Ihrer gesamten Einrichtung, bei der Secrets geschwärzt sind.⁸

Manuelle Installation

Wenn Sie volle Kontrolle benötigen — eigene Python-Version, bestimmte Extras, Nix/NixOS-Integration — ist der manuelle Ablauf Schritt für Schritt im Upstream-Installationsleitfaden dokumentiert.⁷ Wichtige optionale Extras, die Sie mit uv pip install -e ".[<extras>]" kombinieren können:

Der Termux-Installationsbefehl ist anders — er verwendet pip mit einer Constraints-Datei, nicht uv pip:

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

Das liegt daran, dass .[all] auf Android über das voice-Extra faster-whisper einbindet, das von ctranslate2-Wheels abhängt, die für Android nicht veröffentlicht werden.⁷

Authentifizierung & Provider

Hermes unterstützt etwa 19 erstklassige Provider plus benutzerdefinierte Endpunkte und 3 unterschiedliche Authentifizierungspfade. Hier ist die gesamte Authentifizierungsoberfläche, nach Pfad geordnet, damit Sie den passenden Weg für Ihre vorhandene Einrichtung finden.

Die 3 Authentifizierungspfade

Jeder Provider in Hermes passt in eines von 3 Authentifizierungsmustern:

Pfad 1 — API key in .env. Legen Sie Ihren Key in ~/.hermes/.env ab, und Hermes liest ihn beim Start. Wird von OpenRouter, AI Gateway, z.ai/GLM, Kimi/Moonshot, MiniMax (und MiniMax China), Alibaba Cloud/DashScope, Kilo Code, OpenCode Zen, OpenCode Go, DeepSeek, Hugging Face, Google/Gemini und den meisten Drittanbieter-Providern verwendet.²

Pfad 2 — OAuth über hermes model oder hermes auth. Startet einen Device-Code-Flow, öffnet einen Browser, speichert Anmeldedaten in ~/.hermes/auth.json und kann vorhandene Anmeldedaten aus Tools wie Claude Code oder Codex CLI importieren. Wird von Nous Portal, OpenAI Codex (ChatGPT-Konto), GitHub Copilot und Anthropic (Claude Pro/Max) verwendet.²

Pfad 3 — Benutzerdefinierter Endpunkt in config.yaml. Für jede OpenAI-kompatible API — Ollama, vLLM, SGLang, llama.cpp, LM Studio, LiteLLM proxy, Together AI, Groq, Azure OpenAI oder Ihren eigenen selbst gehosteten Server. Einmal über hermes model → Custom endpoint konfiguriert und anschließend in config.yaml gespeichert.²

Die vollständige Provider-Matrix

Dies ist die vollständige Liste der erstklassigen Provider, jeweils mit dem genauen Einrichtungsablauf.²

Anthropic: 3 Authentifizierungsmethoden

Anthropic bekommt einen eigenen Abschnitt, weil Hermes 3 unterschiedliche Wege zu Claude unterstützt und die richtige Wahl wichtig ist. Aus den Upstream-Dokumenten:²

# 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

Wenn Sie Anthropic OAuth über hermes model wählen, bevorzugt Hermes den eigenen Anmeldedatenspeicher von Claude Code, statt den Token nach ~/.hermes/.env zu kopieren. So bleiben aktualisierbare Claude-Anmeldedaten aktualisierbar.² Wenn Sie Claude Code bereits auf derselben Maschine verwenden, ist dies der sauberste Weg.

Um Anthropic dauerhaft in config.yaml festzulegen:

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

--provider claude und --provider claude-code funktionieren ebenfalls als Kurzformen für --provider anthropic.²

GitHub Copilot: 2 Modi

Copilot wird in 2 Modi unterstützt: direktes Copilot API (empfohlen) und Copilot ACP, das das lokale Copilot CLI als Subprozess startet.²

# 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

Die Authentifizierung wird laut Upstream-Dokumenten in dieser Reihenfolge geprüft:² 1. COPILOT_GITHUB_TOKEN-Umgebungsvariable 2. GH_TOKEN-Umgebungsvariable 3. GITHUB_TOKEN-Umgebungsvariable 4. gh auth token CLI-Fallback 5. OAuth-Device-Code-Login über hermes model

Der Tokentyp ist wichtig. Das Copilot API unterstützt keine klassischen Personal Access Tokens (ghp_*). Unterstützte Typen sind OAuth-Tokens (gho_*), fine-grained PATs (github_pat_* mit Copilot Requests-Berechtigung) und GitHub App-Tokens (ghu_*). Wenn Ihr gh auth token einen ghp_*-Token zurückgibt, verwenden Sie stattdessen hermes model, um sich per OAuth zu authentifizieren.²

Chinesische AI-Provider (erstklassige Unterstützung)

Hermes hat integrierte Unterstützung für z.ai/GLM, Kimi/Moonshot, MiniMax (globale + China-Endpunkte) und Alibaba Cloud mit dedizierten Provider-IDs.²

# 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

Basis-URLs können mit den Umgebungsvariablen GLM_BASE_URL, KIMI_BASE_URL, MINIMAX_BASE_URL, MINIMAX_CN_BASE_URL oder DASHSCOPE_BASE_URL überschrieben werden.²

Z.AI erkennt den Endpunkt automatisch. Beim z.ai/GLM-Provider prüft Hermes mehrere Endpunkte (global, China, Coding-Varianten), um einen zu finden, der Ihren API key akzeptiert. Der funktionierende Endpunkt wird automatisch zwischengespeichert — für die meisten Benutzer ist kein GLM_BASE_URL nötig.²

xAI (Grok) aktiviert Prompt-Caching automatisch. Wenn die Basis-URL x.ai enthält, sendet Hermes bei jeder Anfrage den Header x-grok-conv-id, um innerhalb einer Unterhaltungssitzung zum selben Server zu routen und zwischengespeicherte System-Prompts sowie den Verlauf wiederzuverwenden.² Automatisch; keine Konfiguration nötig.

Der Befehl hermes auth

hermes auth ist der Befehl zur Anmeldedatenverwaltung für Pools und OAuth-Anmeldedaten.⁶

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

Mit Anmeldedatenpools rotieren Sie mehrere API keys oder OAuth-Tokens für denselben Provider — nützlich, um Ratelimits auf mehrere Keys zu verteilen, ohne Code zu ändern.⁶ Die alten Befehle hermes login / hermes logout wurden entfernt; verwenden Sie stattdessen hermes auth.⁶

Benutzerdefinierte & selbst gehostete Endpunkte

Hermes funktioniert mit jedem OpenAI-kompatiblen API-Endpunkt. Wenn ein Server /v1/chat/completions implementiert, können Sie Hermes darauf ausrichten.²

Interaktive Einrichtung (empfohlen):

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

Manuelles config.yaml:

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

Beide Ansätze speichern in config.yaml, der einzigen maßgeblichen Quelle für Hauptmodell, Provider und Basis-URL.² Die alten Env Vars OPENAI_BASE_URL und LLM_MODEL werden für die Hauptmodellkonfiguration nicht mehr gelesen — verwenden Sie hermes model oder bearbeiten Sie config.yaml direkt.² (OPENAI_BASE_URL + OPENAI_API_KEY werden weiterhin als Fallback für den Hilfs-Routingpfad provider: "main" berücksichtigt; löschen Sie sie also nicht blind, falls Sie sie dort verwenden.)⁴

Benutzerdefinierte Endpunkte mitten in der Sitzung wechseln:

/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 (pur, ohne Modellname) fragt die /v1/models API Ihres Endpunkts ab und wählt das Modell automatisch aus, wenn genau eines geladen ist — nützlich für lokale Server, auf denen ein einzelnes Modell läuft.²

Lokale LLM-Server (Einrichtungsvorlagen)

Die Upstream-Dokumente enthalten vollständige Einrichtungsguides für Ollama, vLLM, SGLang, llama.cpp und LM Studio. Hier sind die wichtigsten Befehle, die Sie tatsächlich ausführen werden. Jeder davon ist dafür ausgelegt, einen funktionierenden Endpunkt bereitzustellen, auf den Hermes zeigen kann.²

Ollama — einfachster lokaler Weg, ohne Konfiguration:

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

Kritischer Ollama-Fallstrick: Ollama verwendet standardmäßig sehr niedrige Kontextlängen (4.096 Token unter 24 GB VRAM). Sie müssen diese über OLLAMA_CONTEXT_LENGTH oder eine Modelfile erhöhen — die OpenAI-kompatible API akzeptiert keine Kontextlänge vom Client, daher kann Hermes sie nicht für Sie setzen.² Für Agent-Einsatz sollten Sie mindestens 16k–32k einstellen.

vLLM — hochperformantes GPU-Serving:

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

Tool Calling erfordert --enable-auto-tool-choice und --tool-call-parser <name>. Unterstützte Parser: hermes (Qwen 2.5, Hermes 2/3), llama3_json, mistral, deepseek_v3, deepseek_v31, xlam, pythonic. Ohne diese Flags kommen Tool Calls als reiner Text zurück.²

SGLang — schnelles Serving mit RadixAttention zur Wiederverwendung des KV-Caches:

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

SGLang-Fallstrick: Der Standardwert für max_tokens ist 128. Setzen Sie --default-max-tokens auf dem Server oder konfigurieren Sie model.max_tokens in config.yaml, wenn Antworten abgeschnitten werden.²

llama.cpp / llama-server — CPU und 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 ist für Tool Calling erforderlich. Ohne diese Option ignoriert llama-server den Parameter tools vollständig, und das Modell versucht, Tools aufzurufen, indem es JSON in seinen Antworttext schreibt — was Hermes nicht als echte Tool Calls parsen kann.²

LM Studio — Desktop-App mit GUI:

Starten Sie den Server aus der LM Studio-App (Developer-Tab → Start Server) oder über CLI: lms server start (startet auf Port 1234) und lms load qwen2.5-coder --context-length 32768.² Richten Sie hermes model anschließend auf http://localhost:1234/v1.

Kritischer LM Studio-Fallstrick: LM Studio liest die Kontextlänge aus den Modellmetadaten, aber viele GGUF-Modelle melden Standardwerte von 2048 oder 4096. Setzen Sie die Kontextlänge in den LM Studio-Modelleinstellungen immer explizit — klicken Sie auf das Zahnradsymbol neben der Modellauswahl, setzen Sie “Context Length” auf mindestens 16384 (vorzugsweise 32768) und laden Sie das Modell neu.²

Benannte benutzerdefinierte Provider

Wenn Sie mit mehreren benutzerdefinierten Endpunkten arbeiten, etwa einem lokalen Entwicklungsserver und einem entfernten GPU-Server, definieren Sie sie als benannte benutzerdefinierte Provider in 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

Dann wechseln Sie mitten in der Sitzung mit der dreiteiligen Syntax zwischen ihnen:

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

Sie können benannte benutzerdefinierte Provider auch aus dem interaktiven Menü hermes model auswählen.²

Steckbare Provider-Architektur (v0.13.0+)

v0.13.0 liefert eine ProviderProfile ABC plus ein Verzeichnis plugins/model-providers/, sodass Drittanbieter-Inferenzprovider ohne Änderungen am Core eingebunden werden können.¹⁸ Wenn ein Provider einen OpenAI-, Anthropic- oder Codex-kompatiblen API-Modus spricht, können Sie eine ProviderProfile-Unterklasse implementieren, die Authentifizierungspfad, Basis-URL, Modellkatalog und Caching-Header deklariert; Hermes löst sie über denselben runtime_provider.py-Pfad auf, den die eingebauten Provider verwenden. Das ist die Architekturänderung hinter der Provider-Erweiterung in v0.13.0: Statt Core-Code zu bearbeiten, um einen Provider hinzuzufügen, liefern Sie ein Plugin aus.

OpenAI-kompatibler lokaler Proxy (v0.14.0+)

hermes proxy stellt einen OpenAI-kompatiblen lokalen Endpunkt bereit, der vom OAuth-Provider unterstützt wird, bei dem Hermes bereits angemeldet ist — Claude Pro, ChatGPT Pro, SuperGrok oder ein anderer kompatibler konfigurierter Provider.¹⁹ Das bedeutet: Tools, die eine OpenAI-artige API erwarten, darunter Codex CLI, Aider, Cline, Continue oder benutzerdefinierte Skripte, können Ihre abonnementgestützte Hermes-Authentifizierung wiederverwenden, ohne einen separaten API key zu benötigen. Behandeln Sie den Proxy als lokale Entwickler-Infrastruktur: Binden Sie ihn bewusst, exponieren Sie ihn nicht breit und behalten Sie providerspezifische Bedingungen im Blick.

Kontextlängenerkennung

Laut Upstream-Dokumenten werden 2 Einstellungen ständig verwechselt:²

• context_length — das gesamte Kontextfenster (kombiniertes Eingabe- + Ausgabe-Tokenbudget, z. B. 1.000.000 für Claude Opus 4.7 oder 200.000 für Sonnet 4.6). Hermes nutzt dies, um zu entscheiden, wann der Verlauf komprimiert werden soll.
• model.max_tokens — die Ausgabeobergrenze (maximale Anzahl an Token, die das Modell in einer einzelnen Antwort erzeugen darf). Unabhängig von der Verlaufslänge.

Setzen Sie context_length, wenn die automatische Erkennung die Fenstergröße falsch erkennt:

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

Hermes nutzt eine mehrstufige Auflösungskette, um Kontextfenster zu erkennen: Konfigurationsüberschreibung → benutzerdefinierter Provider pro Modell → persistenter Cache → Endpunkt /models → Anthropic /v1/models → OpenRouter API → Nous Portal → models.dev (Community-gepflegte Registry für über 3800 Modelle) → Fallback-Standardwerte (128K).² Das System ist providerbewusst, sodass dasselbe Modell je nach Anbieter unterschiedliche Kontextlimits haben kann (z. B. ist claude-opus-4.6 direkt auf Anthropic 1M, aber auf GitHub Copilot 128K).²

Provider-Rotation & Fallback

Anmeldedatenpools. Wenn Sie mehrere API keys für denselben Provider haben, konfigurieren Sie über hermes auth eine Rotationsstrategie. So verteilen Sie Ratelimits auf mehrere Keys.⁶

Fallback-Modell. Konfigurieren Sie ein Backup-provider:model, zu dem Hermes automatisch wechselt, wenn Ihr primäres Modell ausfällt (Ratelimits, Serverfehler, Authentifizierungsfehler):²

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

Der Fallback tauscht Modell und Provider mitten in der Sitzung aus, ohne Ihre Unterhaltung zu verlieren. Er wird höchstens einmal pro Sitzung ausgelöst.² Unterstützte Provider für 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.²

Hilfsmodelle

Hermes nutzt leichtgewichtige “Hilfsmodelle” für Nebenaufgaben: Bildanalyse, Webseitenzusammenfassung, Browser-Screenshot-Analyse, Klassifizierung zur Genehmigung gefährlicher Befehle, Kontextkomprimierung, Zusammenfassung der Sitzungssuche, skill-Abgleich, MCP-Tool-Dispatch und Memory Flush.⁴ Standardmäßig verwenden diese Gemini Flash über automatische Erkennung (OpenRouter → Nous → Codex).

Sie können konfigurieren, welches Modell und welchen Provider jede Hilfsaufgabe verwendet. Jeder Hilfsslot nutzt dieselben 3 Stellschrauben: 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 }

Die Provider-Option "main" bedeutet: “Verwende den Provider, den mein Hauptagent verwendet” — gültig nur innerhalb von auxiliary:, compression: und fallback_model:-Konfigurationen. Für Ihre oberste Einstellung model.provider ist sie nicht gültig. Wenn Sie einen benutzerdefinierten OpenAI-kompatiblen Endpunkt als Hauptmodell verwenden, setzen Sie provider: custom in Ihrem Abschnitt model:.⁴

Warum das wichtig ist: Wenn Sie nur Anthropic OAuth konfiguriert haben (kein OpenRouter-Key), werden Vision, Webzusammenfassung und Komprimierung schlechter funktionieren oder fehlschlagen, weil die standardmäßige Hilfs-Fallback-Kette zuerst OpenRouter versucht. Fügen Sie für Hilfsaufgaben einen OPENROUTER_API_KEY hinzu oder konfigurieren Sie jeden Hilfsslot so um, dass Ihr Hauptprovider verwendet wird:

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

Das ist der mit Abstand häufigste Fallstrick vom Typ “meine Funktionen funktionieren stillschweigend nicht” für neue Hermes-Benutzer.

Konfigurationssystem

Hermes verwendet ein mehrschichtiges Konfigurationssystem. Die Rangfolge zu verstehen, ist entscheidend, weil höhere Ebenen niedrigere überschreiben und eine der Ebenen eine globale Provider-Registry ist, die Sie in config.yaml nicht sehen können.

Aufbau der Konfigurationsdateien

Laut Upstream-Dokumentation bestehen diese Dateien zusammen aus einer Hermes-Konfiguration:⁴

~/.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 vs. .env — wenn beide gesetzt sind, gewinnt config.yaml bei nicht geheimen Einstellungen.⁴ Die Regel lautet: - Secrets (API keys, Bot-Token, Passwörter) → .env - Alles andere (Modell, Terminal-Backend, Komprimierungseinstellungen, Speicherlimits, toolsets) → config.yaml

Secrets können aus config.yaml mit Shell-artiger Interpolation referenziert werden:⁴

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

Konfiguration verwalten

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

Beispiele:⁴

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 und hermes config migrate sind die Befehle, die Sie nach jedem hermes update ausführen sollten — sie erkennen neu hinzugefügte Konfigurationsoptionen, die Ihre Datei noch nicht enthält.⁶

Konfigurationsrangfolge

Hermes lädt Konfiguration aus mehreren Quellen. Wenn mehrere Quellen denselben Wert setzen, gewinnt die Quelle mit der höheren Priorität:⁴

1. CLI-Argumente — hermes chat --model anthropic/claude-sonnet-4 (Überschreibung pro Aufruf)
2. Umgebungsvariablen — werden beim Prozessstart angewendet
3. config.yaml — die primäre Einstellungsdatei
4. .env — nur Secrets
5. Eingebaute Standardwerte — werden angewendet, wenn nichts anderes einen Wert setzt

CLI-Flags haben für diesen einzelnen Aufruf immer Vorrang. config.yaml ist die langfristige Source of Truth.

Lokalisierung (v0.13.0+)

v0.13.0 fügte 7 Locales für CLI- und gateway-Nachrichten hinzu: Chinesisch (vereinfacht), Japanisch, Deutsch, Spanisch, Französisch, Ukrainisch und Türkisch.¹⁸ v0.14.0 lokalisiert alle gateway-Befehle und das Web-Dashboard, ergänzt 8 weitere Locales und erhöht die Gesamtzahl auf 16.¹⁹ Die Dokumentation ist derzeit nur in zh-Hans lokalisiert. Das Locale wird aus den Umgebungsvariablen LC_ALL / LANG oder einem expliziten locale:-Schlüssel in config.yaml abgeleitet. Englisch bleibt der Standard und die Source of Truth für jede Zeichenkette, die eine Übersetzung noch nicht abdeckt.

Profiles — Mehrere isolierte Hermes-Instanzen

Profiles geben Ihnen mehrere isolierte Hermes-Instanzen, jeweils mit eigener Konfiguration, eigenen Sitzungen, skills, eigenem Speicher und eigener gateway-PID. So können Sie „Arbeits-Hermes“ und „persönliches Hermes“ parallel ausführen, ohne dass eine Instanz den Zustand der anderen sieht.⁶

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

Jedes profile erhält ein eigenes HERMES_HOME (standardmäßig ~/.hermes-<name>/), sodass mehrere profiles das gateway gleichzeitig ausführen können, ohne sich gegenseitig in die Quere zu kommen.⁶³

CLI-Befehle

Dieser Abschnitt ist die Praxisreferenz für CLI-Befehle auf oberster Ebene. Die maßgebliche, aus dem Code abgeleitete Referenz finden Sie in der upstream CLI Commands Reference.⁶

Globale Optionen

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

Befehle auf oberster Ebene

hermes chat — Der Haupteinstiegspunkt

hermes ohne Argumente öffnet den interaktiven Chat. hermes chat ist die explizite Form mit Optionen:⁶

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"

Wichtige Optionen:

hermes setup — Vollständiger Assistent

Führt den vollständigen Einrichtungsassistenten aus oder springt direkt in einen Abschnitt:⁶

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 — Strukturierte Log-Abfragen

hermes logs ist leistungsfähiger als tail -f auf den Logdateien, weil es das gleichzeitige Filtern nach Level, Sitzungs-ID und Zeitraum unterstützt.⁶

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

Logdateien liegen in ~/.hermes/logs/:⁶ - agent.log — alle Agent-Aktivitäten (API-Aufrufe, Tool-Dispatch, Sitzungslebenszyklus, INFO+) - errors.log — nur Warnungen und Fehler (eine gefilterte Teilmenge von agent.log) - gateway.log — Messaging-gateway-Aktivität (Plattformverbindungen, Dispatch, webhooks)

Die Rotation erfolgt automatisch über Pythons RotatingFileHandler — achten Sie auf agent.log.1, agent.log.2 usw.⁶

hermes doctor — Diagnostik

hermes doctor [--fix] ist der erste Befehl, den Sie ausführen sollten, wenn etwas nicht stimmt. Er prüft Konfigurationsgültigkeit, vorhandene Abhängigkeiten, Verfügbarkeit von API-Schlüsseln und Dienststatus und kann mit --fix automatische Reparaturen versuchen.⁶

Um Diagnosedaten mit jemand anderem zu teilen, verwenden Sie hermes dump — der Befehl erstellt eine kompakte Klartextzusammenfassung mit geschwärzten API-Schlüsseln, die Sie direkt in ein GitHub-Issue oder einen Discord-Thread einfügen können.⁶

Slash Commands

Slash Commands werden innerhalb einer aktiven Chat-Sitzung (CLI oder Messaging-Plattform) ausgeführt. Sie werden aus einer gemeinsamen COMMAND_REGISTRY in hermes_cli/commands.py heraus dispatcht, weshalb die meisten Commands auf allen Oberflächen identisch funktionieren.⁹

Sitzungssteuerung

Konfiguration & Modell

Der /model-Command ist das Arbeitstier für Provider-Wechsel mitten in der Sitzung:⁹

/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

Tools, Skills & Infos

Dynamische Skill-Slash-Commands

Jedes installierte skill wird automatisch als Slash Command bereitgestellt:⁹

/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

Sie können außerdem Quick Commands in config.yaml definieren, die einen Kurznamen als Alias für einen längeren Prompt verwenden:⁹

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"

Geben Sie anschließend /review, /deploy oder /morning in CLI ein.

Prefix Matching

Commands unterstützen Prefix Matching: Wenn Sie /h eingeben, wird dies zu /help aufgelöst; /mod wird zu /model aufgelöst. Ist ein Präfix mehrdeutig, gewinnt die erste Registrierung in der Registry-Reihenfolge. Vollständige Command-Namen und registrierte Aliasse haben immer Vorrang vor Prefix Matches.⁹

Messaging-spezifische Commands

Einige Commands funktionieren nur auf Messaging-Plattformen (Telegram, Discord, Slack, WhatsApp, Signal, E-Mail, Home Assistant):⁹

• /status — Sitzungsinformationen anzeigen
• /sethome (Alias /set-home) — aktuellen Chat als Plattform-Home markieren
• /approve [session|always] — ausstehenden gefährlichen Command genehmigen
• /deny — ausstehenden gefährlichen Command ablehnen
• /update — Hermes Agent auf die neueste Version aktualisieren
• /commands [page] — alle Commands und skills durchsuchen (paginiert)

Und einige funktionieren nur in CLI: /skin, /tools, /toolsets, /browser, /config, /cron, /skills, /platforms, /paste, /statusbar, /plugins.⁹

Tools & Toolsets

Hermes wird mit einer breiten integrierten Tool-Registry ausgeliefert, die Websuche, Browser-Automatisierung, Terminalausführung, Dateibearbeitung, Memory, Delegation, RL-Training, Messaging-Zustellung, Home Assistant-Integration und mehr abdeckt.¹⁰ Tools sind in logischen toolsets organisiert, die je nach Plattform aktiviert oder deaktiviert werden können.

Übergeordnete Kategorien

Zu den gängigen toolset-Namen gehören web, terminal, file, browser, vision, image_gen, moa, skills, tts, todo, memory, session_search, cronjob, code_execution, delegation, clarify, homeassistant und rl.¹⁰

Tools verwalten

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

Tools können auch während einer Sitzung über /tools disable <name> und /tools enable <name> umgeschaltet werden. Dadurch wird die Sitzung zurückgesetzt, damit das neue Toolset wirksam wird.⁹

Terminal-Backends

Das Terminal-Tool kann Befehle in 6 verschiedenen Umgebungen ausführen:¹⁰

Wechseln Sie Backends mit hermes config set terminal.backend <name> oder in config.yaml:

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

SSH-Backend (aus Sicherheitsgründen empfohlen — der Agent kann seinen eigenen Code nicht ändern):¹⁰

terminal:
  backend: ssh

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

Docker-Backend:

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

Container-Ressourcen (gilt für 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

Mit container_persistent: true bleiben installierte Pakete, Dateien und Konfigurationen sitzungsübergreifend erhalten.¹⁰

Alle Container-Backends laufen mit Sicherheitshärtung: schreibgeschütztes Root-Dateisystem (Docker), alle Linux-Capabilities außer DAC_OVERRIDE, CHOWN und FOWNER entfernt, keine Rechteausweitung, PID-Limits (256 Prozesse), vollständige Namespace-Isolation, persistenter Workspace über Volumes.¹⁰

Hintergrundprozesse

Das Terminal-Tool unterstützt Hintergrundausführung mit explizitem Prozessmanagement:¹⁰

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

Der PTY-Modus (pty=true) ermöglicht interaktive CLI Tools wie Codex und Claude Code.¹⁰

Sudo

Wenn ein Befehl sudo benötigt, fragt Hermes nach Ihrem Passwort (für die Sitzung zwischengespeichert). Alternativ setzen Sie SUDO_PASSWORD in ~/.hermes/.env.¹⁰

Multi-Agent-Kanban (v0.13.0+)

v0.13.0 macht Multi-Agent-Zusammenarbeit zu einem Primitive erster Klasse: ein dauerhaftes Kanban-Board, das Aufgaben, Status und Worker-Identität über Agents und Neustarts hinweg verfolgt.¹⁸ Erst dieses Board sorgt dafür, dass ein Schwarm von Hermes-Workern Arbeit tatsächlich abschließt, statt an toten Übergaben hängen zu bleiben.

Das Kanban-Board passt natürlich zu /goal (Locked-Target-Ralph-Loop) auf der Zielseite und zum vorhandenen delegate_task-Tool für Spawn-Semantik. Das Ergebnis ist ein Schwarmmuster, bei dem jeder Agent eine gemeinsame Quelle der Wahrheit dafür teilt, was als Nächstes zu tun ist, wer daran arbeitet und was feststeckt.

Skills System

Skills sind Wissensdokumente auf Abruf, die der Agent bei Bedarf laden kann. Sie folgen einem Progressive-Disclosure-Muster, um die Token-Nutzung zu minimieren, und sind mit dem offenen Standard agentskills.io kompatibel.¹¹

Alle Skills liegen in ~/.hermes/skills/ — dem primären Verzeichnis und der verbindlichen Quelle. Bei einer Neuinstallation werden gebündelte Skills aus dem Repo kopiert. Über den Hub installierte und vom Agent erstellte Skills landen ebenfalls hier.¹¹

Progressive Disclosure

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)

Der Agent lädt den vollständigen Skill-Inhalt nur dann, wenn er ihn tatsächlich benötigt.¹¹

SKILL.md-Format

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

Bedingte Aktivierung

Skills können sich je nach verfügbaren Tools ein- oder ausblenden. Das ist besonders nützlich für Fallback-Skills — kostenlose oder lokale Alternativen, die nur erscheinen sollten, wenn ein Premium-Tool nicht verfügbar ist:¹¹

Beispiel: Der integrierte Skill duckduckgo-search verwendet fallback_for_toolsets: [web]. Wenn Sie FIRECRAWL_API_KEY gesetzt haben, ist das web-toolset verfügbar und der Agent verwendet web_search — der DuckDuckGo-Skill bleibt ausgeblendet. Ohne den API-Schlüssel erscheint der DuckDuckGo-Skill automatisch als Fallback.¹¹

Vom Agent verwaltete Skills

Der Agent kann über das Tool skill_manage eigene Skills erstellen, aktualisieren und löschen. Das ist das prozedurale Gedächtnis des Agenten — wenn er einen nicht trivialen Workflow versteht, speichert er den Ansatz als Skill für die spätere Wiederverwendung.¹¹

Wann der Agent Skills erstellt:¹¹ - Nachdem er eine komplexe Aufgabe (5+ Tool-Aufrufe) erfolgreich abgeschlossen hat - Wenn er auf Fehler oder Sackgassen gestoßen ist und den funktionierenden Weg gefunden hat - Wenn der Benutzer seinen Ansatz korrigiert hat - Wenn er einen nicht trivialen Workflow entdeckt hat

Aktionen:¹¹

Skill Hub

Skills aus Online-Registries durchsuchen, suchen, installieren und verwalten:⁶¹¹

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

Integrierte Hub-Quellen:¹¹

Standard-GitHub-Taps (ohne Einrichtung durchsuchbar): openai/skills, anthropics/skills, VoltAgent/awesome-agent-skills, garrytan/gstack.¹¹

Sicherheitsscans

Alle über den Hub installierten Skills durchlaufen einen Sicherheitsscanner, der auf Datenexfiltration, Prompt Injection, destruktive Befehle, Supply-Chain-Signale und andere Bedrohungen prüft.¹¹

Vertrauensstufen:¹¹

--force kann nicht gefährliche Richtlinienblockaden für Community-Skills überstimmen. Es überstimmt kein dangerous-Scanurteil.¹¹

Externe Skill-Verzeichnisse

Sie können Hermes auf zusätzliche Skill-Verzeichnisse verweisen lassen, die parallel zum lokalen Verzeichnis gescannt werden:¹¹

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

Pfade unterstützen ~-Erweiterung und ${VAR}-Umgebungsvariablensubstitution. Externe Verzeichnisse sind schreibgeschützt — wenn der Agent einen Skill erstellt oder bearbeitet, schreibt er immer nach ~/.hermes/skills/. Lokale Priorität gewinnt, wenn ein Skill-Name an beiden Orten existiert.¹¹

Persistenter Speicher

Hermes verfügt über begrenzten, kuratierten Speicher, der sitzungsübergreifend erhalten bleibt. Zwei Dateien bilden den Speicher des Agenten, beide gespeichert unter ~/.hermes/memories/:¹²

Beide werden als eingefrorener Snapshot beim Sitzungsstart in den System-Prompt injiziert. Der Agent verwaltet seinen eigenen Speicher über das memory-Tool — add, replace oder remove.¹²

Muster des eingefrorenen Snapshots: Die System-Prompt-Injektion wird einmal beim Sitzungsstart erfasst und ändert sich während der Sitzung nicht mehr. Das ist Absicht — so bleibt der Prefix-Cache von LLM für bessere Performance erhalten. Änderungen, die während einer Sitzung vorgenommen werden, werden sofort auf die Festplatte geschrieben, erscheinen aber erst in der nächsten Sitzung im System-Prompt.¹²

Was gespeichert werden sollte

Speichern Sie Folgendes (der Agent tut dies proaktiv):¹² - Benutzerpräferenzen: „Ich bevorzuge TypeScript gegenüber JavaScript“ → user - Umgebungsfakten: „Dieser Server läuft mit Debian 12 und PostgreSQL 16“ → memory - Korrekturen: „Verwenden Sie für Docker-Befehle kein sudo, der Benutzer ist in der docker-Gruppe“ → memory - Konventionen: „Das Projekt verwendet Tabs, 120 Zeichen Zeilenbreite, Docstrings im Google-Stil“ → memory - Abgeschlossene Arbeit: „Datenbank am 15. Januar 2026 von MySQL zu PostgreSQL migriert“ → memory

Überspringen Sie Folgendes:¹² - Triviale/offensichtliche Informationen - Leicht erneut auffindbare Fakten - Rohdaten-Dumps (zu groß für den Speicher) - Sitzungsspezifische Momentaufnahmen - Informationen, die bereits in Kontextdateien stehen

Sitzungssuche

Neben MEMORY.md und USER.md kann der Agent seine früheren Gespräche mit dem Tool session_search durchsuchen. Alle CLI- und Messaging-Sitzungen werden in SQLite (~/.hermes/state.db) mit FTS5-Volltextsuche gespeichert. Abfragen liefern relevante frühere Gespräche mit Zusammenfassungen durch Gemini Flash zurück.¹²

Externe Speicheranbieter

Für tieferen persistenten Speicher über MEMORY.md und USER.md hinaus liefert Hermes acht Plugins für externe Speicheranbieter mit: Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover und Supermemory.¹²

Externe Anbieter laufen parallel zum eingebauten Speicher (sie ersetzen ihn nie) und ergänzen Funktionen wie Knowledge Graphs, semantische Suche, automatische Faktenextraktion und sitzungsübergreifende Benutzermodellierung:⁶¹²

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)

Es kann immer nur ein externer Anbieter aktiv sein. Der eingebaute Speicher ist immer aktiv.⁶

Automatische Sitzungsfortsetzung (v0.13.0+)

v0.13.0 macht Unterbrechungen mitten in der Agentenarbeit überlebbar. Das gateway setzt unterbrochene Sitzungen nach einem Neustart automatisch fort; /update-Neustarts behalten den Sitzungszustand während des Upgrades bei; Quellcodedatei-Reloads während der Entwicklung halten die aktive Sitzung am Leben, statt eine neue zu erzwingen.¹⁸ Praktische Auswirkung: Lang laufende gateway-Arbeit und cron-gesteuerte Jobs setzen ihr Kontextfenster nicht mehr zurück, wenn der Prozess neu startet.

Checkpoints v2 (v0.13.0+)

Die Zustandspersistenz wurde in v0.13.0 als Single-Store-Design mit echtem Pruning, Festplatten-Schutzgrenzen und ohne verwaiste Shadow-Repos neu geschrieben.¹⁸ Das frühere checkpoint-System sammelte bei lang laufenden profiles Zustand auf der Festplatte an; der v2-Store setzt eine harte Obergrenze für lokalen checkpoint-Speicher und entfernt die doppelte Buchführung, die dieses Wachstum verursacht hat. Eine benutzerseitige Konfigurationsänderung ist nicht erforderlich; der nächste checkpoint-Schreibvorgang verwendet den v2-Pfad.

Persönlichkeit & SOUL.md

SOUL.md ist die primäre Identität einer Hermes-Instanz. Sie belegt Slot #1 im System-Prompt und ersetzt die fest codierte Standardidentität.¹³

Hermes legt automatisch eine Standard-SOUL.md unter ~/.hermes/SOUL.md an (oder $HERMES_HOME/SOUL.md für benutzerdefinierte profiles). Vorhandene Benutzerdateien werden nie überschrieben. Hermes lädt SOUL.md nur aus HERMES_HOME — es sucht nicht im aktuellen Arbeitsverzeichnis. Dadurch bleibt die Persönlichkeit projektübergreifend vorhersehbar.¹³

Was in SOUL.md gehört

Verwenden Sie sie für dauerhafte Vorgaben zu Stimme und Persönlichkeit:¹³ - Ton - Kommunikationsstil - Grad der Direktheit - Standard-Interaktionsstil - was stilistisch vermieden werden sollte - wie Hermes mit Unsicherheit, Widerspruch und Mehrdeutigkeit umgehen soll

Weniger geeignet ist sie für:¹³ - einmalige Projektanweisungen - Dateipfade - Repo-Konventionen - temporäre Workflow-Details

Diese gehören in AGENTS.md, nicht in SOUL.md.

SOUL.md vs AGENTS.md

Das ist die wichtigste Unterscheidung im Identitätsmanagement von Hermes:¹³

SOUL.md — Identität, Ton, Stil, Kommunikationsstandards, Verhalten auf Persönlichkeitsebene.

AGENTS.md — Projektarchitektur, Coding-Konventionen, Tool-Präferenzen, repo-spezifische Workflows, Befehle, Ports, Pfade, Deployment-Notizen.

Eine nützliche Regel: Wenn es Sie überall begleiten soll, gehört es in SOUL.md. Wenn es zu einem Projekt gehört, gehört es in AGENTS.md.¹³

Eingebaute Persönlichkeiten

Hermes bringt eingebaute Persönlichkeiten mit, zu denen Sie mit /personality wechseln können:¹³

Benutzerdefinierte Persönlichkeiten in 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.

Wechseln Sie anschließend mit /personality codereviewer.

SOUL.md vs /personality

SOUL.md ist die grundlegende Stimme. /personality ist ein Overlay auf Sitzungsebene.¹³ Halten Sie eine pragmatische Standard-SOUL.md vor und verwenden Sie dann /personality teacher für ein Tutoriumsgespräch oder /personality creative für Brainstorming.

Nous Tool Gateway (v0.10.0+)

Seit Hermes Agent v0.10.0 (16. April 2026) erhalten zahlende Nous Portal-Abonnenten verwalteten Zugriff auf einen kuratierten Satz von Tools über ihre bestehenden Portal-Zugangsdaten — ohne zusätzliche API-Schlüssel verwalten zu müssen.²⁶ CLI von Hermes selbst bleibt MIT-lizenziert und vollständig Open Source. Geändert hat sich, dass Ihre Portal-Authentifizierung jetzt mehr freischaltet als nur Modellinferenz.

Was im gateway enthalten ist

Funktionsweise

Das gateway ist pro Tool opt-in über ein neues use_gateway-Konfigurationsfeld. Wenn Sie Portal-Zugangsdaten in hermes auth haben und das gateway für ein Tool aktivieren, werden die Aufrufe dieses Tools über Portal geleitet. Andernfalls wird Ihr direkter API-Schlüssel verwendet, sofern vorhanden.

# 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

Runtime-Priorität: Wenn das gateway verfügbar ist und ein Tool use_gateway: true gesetzt hat, bevorzugt Hermes das gateway, selbst wenn Sie zusätzlich einen direkten API-Schlüssel konfiguriert haben. Das ist für die Abrechnung wichtig — gateway-Aufrufe werden Ihrer Portal-Subscription belastet, nicht dem Guthaben Ihres direkten API-Schlüssels.

Gateway aktivieren

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

Es gibt keinen separaten Befehl hermes subscribe oder hermes login --portal. Die Subscription wird automatisch anhand der Portal-OAuth-Zugangsdaten erkannt, die Sie bereits in hermes auth haben.

Preise und Zugriff

Preise und Tier-Namen werden auf der Preisseite des Nous Portal veröffentlicht (https://portal.nousresearch.com/pricing). Dieser Guide zählt die Tiers nicht auf, weil sie in die Verantwortung des Portal-Produkts fallen, nicht von Hermes CLI, und sich unabhängig von Hermes-Releases ändern. Registrieren Sie sich unter https://portal.nousresearch.com/ und prüfen Sie die Preisseite für die aktuellen Tiers.

Deprecation-Hinweis

• Die Umgebungsvariable HERMES_ENABLE_NOUS_MANAGED_TOOLS wurde in v0.10.0 entfernt. Managed Tools werden jetzt über das pro Tool gesetzte Konfigurationsfeld use_gateway aktiviert und anhand des Zustands Ihrer Portal-Subscription freigeschaltet.²⁶

Einordnung: Was dieses Release nicht ist

Hermes Agent CLI ist nicht hinter einer Subscription gesperrt. Das Projekt bleibt MIT-lizenziert, alle Kernfunktionen (CLI, skills, Speicher, Messaging-gateway, cron, MCP, lokales Dashboard, BYOK für jeden Anbieter) funktionieren end-to-end, ohne jemanden zu bezahlen. v0.10.0 ergänzt einen Komfortpfad für Benutzer, die bereits für Nous Portal bezahlen — es entfernt nichts aus dem kostenlosen Pfad.

Messaging Gateway

Hermes kann als dauerhaft laufender gateway-Prozess betrieben werden, der über einen einzigen gateway-Prozess mit 22 Messaging-Plattformen verbunden ist: 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 und ein generischer Webhook-Adapter.^325171819 v0.9.0 ergänzte iMessage über BlueBubbles (automatische Webhook-Registrierung, Einrichtungsassistent, Absturzresilienz) sowie native WeChat-Unterstützung über iLink Bot API mit WeCom-Callback-Modus für Unternehmens-Apps.¹⁶ v0.11.0 ergänzte QQBot.²⁵ v0.12.0 ergänzte Microsoft Teams und Tencent Yuanbao.¹⁷ v0.13.0 ergänzte Google Chat als 20. Plattform auf Basis derselben steckbaren Adapterarchitektur; IRC und Microsoft Teams wurden außerdem auf das neue Adaptermuster mit generischen env_enablement_fn- / cron_deliver_env_var-Plugin-Hooks migriert.¹⁸ v0.14.0 ergänzt LINE und SimpleX Chat und vervollständigt den Microsoft Teams-Stack Ende-zu-Ende mit Graph-Authentifizierung, Webhook-Listener, Pipeline-Laufzeit und ausgehender Zustellung.¹⁹ v0.17.0 (19. Juni 2026) ergänzt relay-freies iMessage über Photon Spectrum (device-code OAuth mit hermes photon login — kein Mac-/BlueBubbles-Relay erforderlich), den offiziellen WhatsApp Business Cloud API-Adapter (ersetzt die Bridge-Prozess-Anforderung), SimpleX-Gruppen und native Anhänge sowie Raft als gebündeltes Plattform-Plugin.²¹

Einrichtung

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)

Die interaktive Einrichtung führt Sie durch die Verbindung jeder Plattform: API-Tokens, Bot-IDs, Kanalzuordnungen, Allowlists.⁶

Nachrichtenfluss

Aus den Upstream-Architekturdokumenten:³

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

Jede Messaging-Plattform läuft durch dieselbe AIAgent-Konversationsschleife wie der CLI. Deshalb funktionieren Slash-Befehle an beiden Stellen identisch, und deshalb kann ein in Telegram geplanter cron-Job seine Ausgabe an Discord liefern — der Plattformunterschied liegt nur am Rand.³

Benutzerautorisierung und Pairing

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

Pairing-Codes verhindern, dass beliebige Fremde mit Ihrem gateway sprechen. Ein Benutzer sendet einen Pairing-Code von seiner Messaging-Plattform; Sie genehmigen ihn mit hermes pairing approve; ab dann ist er autorisiert.⁶

Geplante Aufgaben (Cron)

Hermes hat ein erstklassiges cron-System, in dem Jobs Agent-Aufgaben sind, keine Shell-Befehle. Jeder geplante Job läuft durch einen frischen AIAgent mit dem konfigurierten Prompt, optional angehängten skills, und liefert Ergebnisse an jede Plattform:³⁶

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

Oder erstellen Sie einen Job konversationell innerhalb eines Messaging-Chats:

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

Der Agent richtet den cron-Job über seine Tools ein. Jobs bleiben in JSON bestehen und überstehen Neustarts.³

MCP-Integration

Hermes unterstützt das Model Context Protocol sowohl als Client als auch als Server:⁶

Als Client — verbinden Sie Hermes mit externen MCP-Servern, um seine Tool-Oberfläche zu erweitern:

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

Oder manuell in config.yaml:¹⁴

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

Als Server — stellen Sie Hermes-Konversationen anderen Agenten bereit:

hermes mcp serve
hermes mcp serve -v    # Verbose

Kontextkomprimierung

Hermes komprimiert lange Konversationen automatisch, damit sie innerhalb des Kontextfensters Ihres Modells bleiben. Der Komprimierungs-Summarizer ist ein separater LLM-Aufruf — Sie können ihn auf jeden Provider oder Endpoint ausrichten.⁴

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

Provider-Optionen:⁴

summary_model muss eine Kontextlänge unterstützen, die mindestens so groß ist wie die Ihres Hauptmodells, da es den vollständigen mittleren Abschnitt der Konversation zur Komprimierung erhält.⁴

Warnungen bei Budgetdruck

Wenn der Agent an einer komplexen Aufgabe mit vielen Tool-Aufrufen arbeitet, kann er sein Iterationsbudget (Standard: 90 Durchläufe) verbrauchen, ohne es zu merken. Budgetdruck warnt das Modell automatisch:⁴

Stream-Timeouts

Die LLM-Streaming-Verbindung hat zwei Timeout-Ebenen, die sich für lokale Provider (localhost, LAN-IPs) automatisch anpassen:⁴

Der Socket-Lesetimeout wird für lokale Endpoints auf 30 Minuten erhöht, weil lokale LLMs bei großen Kontexten mehrere Minuten für den Prefill benötigen können, bevor sie das erste Token erzeugen.⁴

Lokales Web-Dashboard (v0.9.0+)

Ein browserbasiertes Dashboard zur lokalen Verwaltung Ihres Hermes Agent. Konfigurieren Sie Einstellungen, überwachen Sie Sitzungen, durchsuchen Sie skills und verwalten Sie Ihr gateway, ohne Konfigurationsdateien oder das Terminal anzufassen.¹⁶ Starten Sie es mit hermes dashboard. Dies ist der einfachste Onboarding-Pfad für neue Benutzer, die eine GUI bevorzugen.

Überwachung von Hintergrundprozessen (v0.9.0+)

Mit watch_patterns können Sie Muster festlegen, die in der Ausgabe von Hintergrundprozessen überwacht werden, und Sie werden in Echtzeit benachrichtigt, sobald sie übereinstimmen.¹⁶ Überwachen Sie Fehler, warten Sie auf bestimmte Ereignisse (“listening on port”) oder beobachten Sie Build-Logs — ganz ohne Polling. Zusammen mit notify_on_complete aus v0.8.0 (das bei Abschluss von Hintergrundaufgaben benachrichtigt) verfügt Hermes nun über eine vollständige Beobachtungsebene für Hintergrundprozesse.¹⁵

Steckbarer context engine (v0.9.0+)

Das Kontextmanagement ist jetzt über hermes plugins ein steckbarer Slot. Tauschen Sie benutzerdefinierte context engines ein, die steuern, was der Agent in jedem Durchlauf sieht — Filterung, Zusammenfassung oder domänenspezifische Kontextinjektion.¹⁶ Dadurch wird die Kontextstrategie von der zentralen Agent-Schleife entkoppelt, sodass der Kontext pro Projekt oder Domäne angepasst werden kann.

Backup und Wiederherstellung (v0.9.0+)

hermes backup erstellt ein vollständiges Archiv Ihrer Konfiguration, Sitzungen, skills und memory. hermes import stellt aus einem Backup-Archiv wieder her.¹⁶ Verwenden Sie dies, um zwischen Maschinen zu migrieren, Snapshots vor größeren Änderungen zu erstellen oder eine bewährte Konfiguration mit Teamkollegen zu teilen.

Termux-/Android-Unterstützung (v0.9.0+)

Hermes läuft nativ auf Android über Termux. Angepasste Installationspfade, TUI-Optimierungen für mobile Bildschirme, Unterstützung für Voice-Backends und der Befehl /image funktionieren direkt auf dem Gerät.¹⁶

Security-Härtung (v0.13.0+)

v0.13.0 hat 8 P0-Sicherheitsprobleme geschlossen und eine Standardeinstellung zugunsten des Benutzers geändert.¹⁸ v0.14.0 folgt mit weiteren 12 P0- und 50 P1-Schließungen, darunter Härtung gegen sudo-Brute-Force / sudo-stdin, Korrekturen für Dangerous-Command-Bypässe, Tool-Error-Bereinigung vor der erneuten Einspeisung ins Modell, Dashboard-Plugin-API-Auth, SSRF-Abdeckung im Skills-Hub und Supply-Chain-Advisory-Scanning während der Installation.¹⁹

Wenn Sie eine Hermes-Bereitstellung betreiben, behandeln Sie v0.13.0 und v0.14.0 als sicherheitsrelevante Upgrades, nicht nur als Feature-Releases. v0.13.0 schließt den Discord-Cross-Guild-Bypass und zwei TOCTOU-Fenster; v0.14.0 ergänzt eine weitere Härtungsrunde für sudo-Handling, Tool-Error-Reinjection, Plugin-APIs, Skills-Hub-SSRF und Dependency-Advisories.

Architektur für Praktiker

Dieser Abschnitt richtet sich an Personen, die verstehen möchten, was unter der Haube passiert, damit sie es debuggen, erweitern oder die Performance einschätzen können. Er ist eine Synthese der Upstream-Architekturdokumentation.³

Entry Points → AIAgent

Jeder Entry Point in Hermes ruft letztlich AIAgent.run_conversation() auf:

┌──────────────────────────────────────────────────────────────────┐
│                        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    │  │              │             │
│  └──────────────┘ └──────────────┘  └──────────────┘             │
└──────────────────────────────────────────────────────────────────┘

Diagramm nach der Upstream-Architekturdokumentation.³

„47 tools / 20 toolsets“ vs. „28 tools“ in Ihrem Banner. Die Angabe „47 tools“ bezeichnet die gesamte Tool-Registry des Upstream-Repositorys, also jedes Tool, für das Hermes Quellcode mitliefert, über alle toolsets hinweg. Ihre tatsächlich laufende CLI zeigt im Startbanner eine kleinere Zahl an (die Installation, gegen die ich diesen Leitfaden geprüft habe, meldet 28 tools / 89 skills). Das ist kein Bug. Viele toolsets sind opt-in und müssen in config.yaml unter toolsets: ausdrücklich aktiviert werden, etwa Adapter für Messaging-Plattformen, Browser-Automatisierung, umfangreichere Scraping-Tools usw. Die Registry-Gesamtzahl bedeutet „was verfügbar ist“; die Banner-Zahl bedeutet „was in Ihrem aktuellen profile aktiviert ist“. Prüfen Sie mit hermes tools --list, welche toolsets aktiv sind, und aktivieren oder deaktivieren Sie einzelne toolsets mit dem Block toolsets: in ~/.hermes/config.yaml (oder mit /tools list / /tools enable <name> / /tools disable <name> innerhalb einer laufenden Sitzung. Das Entfernen eines Tools löst einen Sitzungsreset aus, damit der Agent sein Tool-Manifest neu aufbaut).

Die drei API-Modi

Hermes abstrahiert Provider-Unterschiede in drei API-Modi, die zur Laufzeit automatisch ausgewählt werden:³

Der Resolver runtime_provider.py ordnet (provider, model)-Tupel für mehr als 18 Provider (api_mode, api_key, base_url) zu und behandelt dabei OAuth-Flows, Credential Pools und Alias-Auflösung.³

Datenfluss durch eine CLI-Sitzung

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

Von der Upstream-Architekturseite.³

Reihenfolge der Prompt-Zusammensetzung

Der Prompt-Stack enthält:¹³

1. SOUL.md (Agent-Identität, oder eingebauter Fallback, falls nicht verfügbar)
2. Tool-aware Verhaltensanweisungen
3. Memory-/Benutzerkontext (MEMORY.md, USER.md)
4. Skills-Anweisungen
5. Kontextdateien (AGENTS.md, .cursorrules)
6. Zeitstempel
7. Plattformspezifische Formatierungshinweise
8. Optionale System-Prompt-Overlays wie /personality

SOUL.md ist das Fundament; alles Weitere baut darauf auf.¹³

Sitzungsspeicher

SQLite-basierter Sitzungsspeicher mit FTS5-Volltextsuche. Sitzungen haben Lineage-Tracking (Parent/Child über Komprimierungen hinweg), Isolation pro Plattform und atomare Schreibvorgänge mit Contention-Handling.³

Plugin-System

Drei Discovery-Quellen: ~/.hermes/plugins/ (Benutzer), .hermes/plugins/ (Projekt) und pip-Entry-Points. Plugins registrieren Tools, Hooks und CLI-Befehle über einen Kontext-API. Memory Providers sind ein spezialisierter Plugin-Typ unter 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

Designprinzipien

Von der Upstream-Architekturseite:³

Migration von OpenClaw

Hermes Agent ist der Nachfolger von OpenClaw. Wenn Sie von einer bestehenden OpenClaw-Installation migrieren:⁶⁵

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 liest standardmäßig aus ~/.openclaw (erkennt außerdem automatisch alte Verzeichnisse ~/.clawdbot und ~/.moldbot) und schreibt nach ~/.hermes.⁶

Direkt importiert (über 30 Kategorien): SOUL.md, MEMORY.md, USER.md, AGENTS.md, skills aus 4 Quellverzeichnissen, Standardmodell, Custom Providers, MCP-Server, Tokens und Allowlists für Messaging-Plattformen (Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), Agent-Defaults (Reasoning Effort, Komprimierung, Human Delay, Zeitzone, Sandbox), Sitzungsreset-Richtlinien, Genehmigungsregeln, TTS-Konfiguration, Browsereinstellungen, Tool-Einstellungen, Exec-Timeout, Command-Allowlist, gateway-Konfiguration und API-Schlüssel aus 3 Quellen.⁶

Für manuelle Prüfung archiviert: Cron-Jobs, Plugins, Hooks/Webhooks, Memory Backend (QMD), Skills-Registry-Konfiguration, UI/Identität, Logging, Multi-Agent-Setup, Channel Bindings, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md.⁶

Die API-Schlüsselauflösung prüft drei Quellen in dieser Prioritätsreihenfolge: Konfigurationswerte → ~/.openclaw/.env → auth-profiles.json.⁶

Fehlerbehebung

“API key not set”

Führen Sie hermes model aus, um Ihren Provider interaktiv zu konfigurieren, oder hermes config set OPENROUTER_API_KEY your_key. Der Befehl hermes doctor zeigt Ihnen genau, welche Schlüssel fehlen.⁷

“Context limit: 2048 tokens” beim Start (lokale Modelle)

Hermes erkennt die Kontextlänge automatisch über den /v1/models-Endpunkt Ihres Servers, aber viele lokale Server melden niedrige Standardwerte. Legen Sie sie in config.yaml explizit fest:²

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

Tool-Aufrufe erscheinen als Text, statt ausgeführt zu werden

Auf Ihrem Server ist Tool Calling nicht aktiviert, oder das Modell unterstützt es über die Serverimplementierung nicht.²

Antworten werden mitten im Satz abgeschnitten

Zwei Ursachen sind möglich:²

1. Niedrige Ausgabegrenze (max_tokens) auf dem Server — SGLang verwendet standardmäßig 128 Tokens pro Antwort. Setzen Sie --default-max-tokens auf dem Server oder konfigurieren Sie model.max_tokens in config.yaml.
2. Erschöpfter Kontext — Das Modell hat sein Kontextfenster gefüllt. Erhöhen Sie model.context_length oder aktivieren Sie die Kontextkomprimierung in Hermes.

“Connection refused” von WSL2 zu einem unter Windows gehosteten Modellserver

WSL2 verwendet einen virtuellen Netzwerkadapter mit eigenem Subnetz — localhost innerhalb von WSL2 verweist auf die Linux-VM, nicht auf den Windows-Host. Es gibt zwei Optionen:²

Gespiegeltes Netzwerk (Windows 11 22H2+): Bearbeiten Sie %USERPROFILE%\.wslconfig:

[wsl2]
networkingMode=mirrored

Führen Sie anschließend wsl --shutdown aus und starten Sie neu. localhost funktioniert nun in beide Richtungen.

Fallback über Host-IP (älteres Windows): Ermitteln Sie innerhalb von WSL2 die Windows-Host-IP und verwenden Sie sie statt localhost:

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

Außerdem muss der Modellserver an 0.0.0.0 gebunden sein, nicht an 127.0.0.1 — setzen Sie für Ollama OLLAMA_HOST=0.0.0.0, fügen Sie für llama-server/SGLang --host 0.0.0.0 hinzu oder aktivieren Sie in LM Studio “Serve on Network”.²

Wo ist alles?

hermes status und hermes dump sind hier Ihre Freunde. hermes logs list zeigt alle Protokolldateien samt Größe. hermes config path gibt den Speicherort der Konfigurationsdatei aus. hermes config env-path gibt den Speicherort der .env aus.⁶

FAQ

Was ist der Unterschied zwischen Hermes Agent und Claude Code?

Claude Code ist Anthropics offizieller CLI und auf Anthropic-Modelle beschränkt. Hermes Agent ist ein Open-Source-Agent-Framework von Nous Research, das mit jedem OpenAI-kompatiblen Provider funktioniert — Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Hugging Face, Google oder Ihrem eigenen selbst gehosteten Endpunkt.¹² Hermes bringt außerdem ein Messaging-gateway für Telegram/Discord/Slack/WhatsApp/Signal mit, das Claude Code nicht hat.

Kann ich Hermes mit einem Anthropic-API-Schlüssel verwenden?

Ja. Es gibt drei Wege:²

1. Setzen Sie ANTHROPIC_API_KEY in ~/.hermes/.env und führen Sie hermes chat --provider anthropic --model claude-sonnet-4-6 aus
2. Führen Sie hermes model aus und wählen Sie Anthropic — Hermes verwendet den Anmeldedatenspeicher von Claude Code, sofern verfügbar
3. Setzen Sie als Fallback manuell ein ANTHROPIC_TOKEN (setup-token oder OAuth-Token)

Option 2 ist vorzuziehen, wenn Sie Claude Code bereits auf demselben Rechner verwenden — so bleiben aktualisierbare Claude-Anmeldedaten aktualisierbar.

Wie wechsle ich den Provider, ohne meine Unterhaltung zu verlieren?

Verwenden Sie innerhalb einer Sitzung /model provider:model. Unterhaltungsverlauf, Speicher und skills bleiben erhalten:⁹

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

Ich habe Anthropic konfiguriert, aber Vision/Web/Komprimierung funktionieren nicht

Sie laufen in den Fallback für das Hilfsmodell. Vision, Web-Zusammenfassungen, Komprimierung und andere Nebenaufgaben verwenden ein separates Hilfs-LLM — standardmäßig Gemini Flash per automatischer Erkennung (OpenRouter → Nous → Codex). Wenn keiner davon konfiguriert ist und Sie nur Anthropic eingerichtet haben, werden diese Funktionen stillschweigend eingeschränkt.⁴

Behebung: Fügen Sie entweder einen OPENROUTER_API_KEY für Hilfsaufgaben hinzu, oder konfigurieren Sie die Hilfs-Slots so um, dass sie Ihren Haupt-Provider verwenden. Beachten Sie, dass die Kontextkomprimierung in einem eigenen Top-Level-Block compression: liegt und summary_provider verwendet, nicht auxiliary.compression.provider — der Slot auxiliary.compression stellt nur ein timeout bereit. Vollständige Behebung:

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

compression:
  summary_provider: "main"

Worin unterscheiden sich SOUL.md und AGENTS.md?

SOUL.md ist die Identität Ihres Agenten — Ton, Stil und Standardwerte für die Kommunikation. Sie liegt in ~/.hermes/SOUL.md und begleitet Sie überall. AGENTS.md ist projektspezifisch — Architektur, Konventionen, Befehle, Pfade — und liegt in Ihrem Projektverzeichnis.¹³ Wenn es Sie überall begleiten soll: SOUL.md. Wenn es zu einem Projekt gehört: AGENTS.md.

Wie führe ich mehrere Hermes-Instanzen parallel aus?

Mit Profilen. Jedes profile erhält ein eigenes HERMES_HOME, eine eigene Konfiguration, einen eigenen Speicher, eigene Sitzungen und eine eigene gateway-PID:⁶

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

Unterstützt Hermes lokale LLMs?

Ja, über den Pfad für benutzerdefinierte Endpunkte. Hermes funktioniert mit jedem OpenAI-kompatiblen Server: Ollama, vLLM, SGLang, llama.cpp/llama-server, LM Studio, LocalAI, Jan oder Ihrem eigenen.² Siehe Benutzerdefinierte und selbst gehostete Endpunkte für die Einrichtung pro Server.

Warum zeigt mein Startbanner weniger Tools an, als der Leitfaden für Hermes angibt?

Der Leitfaden nennt 47 Tools / 20 toolsets aus der Upstream-Architektur-Registry — das ist die Gesamtzahl der Tools, deren Quellcode Hermes über alle toolsets hinweg mitliefert. Ihre laufende Installation zeigt im Banner eine kleinere Zahl an (die für diesen Leitfaden verwendete Referenzinstallation meldet 28 Tools), weil Hermes beim Start nur die Standard-toolsets aktiviert. Viele toolsets sind optional: Messaging-gateway-Adapter, Browserautomatisierung, umfangreichere Scraping-Stacks und mehrere spezialisierte Integrationen müssen ausdrücklich unter toolsets: in ~/.hermes/config.yaml aufgeführt werden, bevor sie geladen werden. Registry-Gesamtzahl = “was verfügbar ist, wenn Sie es aktivieren.” Banner-Gesamtzahl = “was Ihr aktuelles profile tatsächlich geladen hat.” Verwenden Sie hermes tools --list, um zu sehen, welche toolsets aktiv sind und welche verfügbar, aber deaktiviert sind. Einzelne toolsets können Sie zur Laufzeit mit /tools enable <name> und /tools disable <name> umschalten (das Deaktivieren löst einen Sitzungsreset aus, damit der Agent sein Tool-Manifest mit der neuen Struktur neu aufbaut).

Wie geht Hermes mit Modell-Fallback um, wenn mein primärer Provider ausfällt?

Konfigurieren Sie in config.yaml einen fallback_model-Block:²

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

Wenn der primäre Provider ausfällt (Ratenlimit, Serverfehler, Authentifizierungsfehler), wechselt Hermes mitten in der Sitzung zum Fallback, ohne den Unterhaltungsverlauf zu verlieren. Das geschieht höchstens einmal pro Sitzung.

Kann der Agent seine eigenen skills mit der Zeit verbessern?

Ja — das ist der „self-improving“-Teil von Hermes Agent. Der Agent kann über das Tool skill_manage skills erstellen, aktualisieren und löschen. Wenn er einen nicht trivialen Workflow erkennt, speichert er den Ansatz als skill für die spätere Wiederverwendung.¹¹ Der Agent erstellt skills nach komplexen Aufgaben (5+ Tool-Aufrufe), wenn Fehler auftreten und er den funktionierenden Weg findet, wenn Sie seinen Ansatz korrigieren oder wenn er einen nicht trivialen Workflow entdeckt.

Gibt es eine IDE-Integration?

Ja — Hermes kann als ACP-Server (Agent Client Protocol) für VS Code, Zed und JetBrains laufen:⁶

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

Änderungsprotokoll

Referenzen