Hermes Agent: Das Praxishandbuch (2026)

Kurz gesagt: Hermes Agent ist ein Open-Source-, selbstverbessernder AI-Agent von Nous Research. Er läuft als CLI und als plattformübergreifendes Messaging-Gateway, speichert eine dauerhafte Identität und persistenten Speicher auf dem Datenträger, bündelt skills, die sich mit der Nutzung verbessern, und funktioniert 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 selbstgehosteten Endpoint.¹²¹⁹ Seit v0.14.0 (16. Mai 2026) ergänzt Hermes SuperGrok OAuth mit grok-4.3-1M-Kontext, einen OpenAI-kompatiblen lokalen Proxy für OAuth-Provider (hermes proxy), erstklassiges x_search, PyPI-Installationsunterstützung (seit v0.19.0 veraltet — der Einzeilen-Installer ist der unterstützte Weg), verzögerte Abhängigkeitsinstallationen, 28 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 und 12 P0-/50-P1-Abschlüsse.¹⁹ Der schwierigste Teil für die meisten neuen Benutzer ist die Provider-Authentifizierung: Hermes unterstützt etwa 20 erstklassige Provider sowie benutzerdefinierte Endpoints und drei unterschiedliche Authentifizierungspfade (API-Key in .env, OAuth über hermes model oder benutzerdefinierter Endpoint in config.yaml). Das Authentifizierungsmodell sollten Sie zuerst lernen — 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, durchsucht das Web, startet Subagents, führt geplante cron-Jobs aus, kommuniziert von einem einzigen Gateway-Prozess aus mit Telegram/Discord/Slack/WhatsApp/Signal/E-Mail und erstellt eigene skills aus Erfahrung.¹ Die CLI ist eine Terminal-UI, die auf einer Konversationsschleife in run_agent.py aufbaut; das Gateway ist ein langlebiger Prozess, der Nachrichten von Messaging-Plattformen durch dieselbe Konversationsschleife leitet.³

Der Unterschied zwischen gelegentlicher und professioneller Hermes-Nutzung liegt in fünf Systemen. Beherrschen Sie diese, wird Hermes zu einem Produktivitätsmultiplikator:

1. Provider-Auflösung: wie Authentifizierungsflüsse 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 begrenzt
4. Skills-System: prozeduraler Speicher, den der Agent erstellt und weiterentwickelt
5. Gateway + cron + profiles: Hermes dort ausführen, wo Sie leben, nicht nur dort, wo Sie gerade sind

Wichtigste Erkenntnisse

• Die Provider-Authentifizierung kennt drei Pfade, nicht nur einen. API-Key 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 erscheint.
• Der Providerwechsel ist ein einzelner 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.²
• Zwei Dateien bilden die vom Benutzer bearbeitbare Konfigurationsoberfläche. ~/.hermes/config.yaml enthält Einstellungen und ~/.hermes/.env enthält Geheimnisse. auth.json, SOUL.md, MEMORY.md und skills/ werden direkt von Hermes verwaltet — Sie können SOUL.md manuell bearbeiten, doch den Rest bearbeitet der Agent selbst.⁴
• Hermes ist der Nachfolger von OpenClaw. Wenn Sie migrieren, importiert hermes claw migrate automatisch über 30 Zustandskategorien.⁵
• Die Dienstqualität hängt von Ihrem Hilfsmodell ab. Vision, Web-Zusammenfassungen, Komprimierung und Speicherbereinigung verwenden jeweils ein separates Hilfs-LLM. Standardmäßig ist dies Gemini Flash über automatische Erkennung (OpenRouter → Nous → Codex) — wenn keines davon konfiguriert ist, verschlechtern sich diese Funktionen unbemerkt, bis Sie die Hilfsslots auf Ihren Hauptprovider verweisen.⁴

Was sich mit v0.14 ändert

Bei v0.14.0 geht es weniger um eine einzelne Schlagzeilenfunktion als darum, den Einrichtungsaufwand zu verringern und Hermes an mehr Orten lauffähig zu machen.¹⁹ Die wichtigsten betrieblichen Änderungen:

• Installation und Start sind schlanker. pip install hermes-agent funktioniert über PyPI, umfangreiche Adapter werden bei der ersten Nutzung verzögert installiert, und der Startpfad verschiebt ausreichend Arbeit, um den Kaltstart um ungefähr 19 Sekunden zu verkürzen. (v0.19.0 hat pip-Installationen inzwischen verworfen — siehe Installation.)
• Abonnements können zu lokalen API-Endpoints werden. hermes proxy macht OAuth-gestützte Provider wie Claude Pro, ChatGPT Pro und SuperGrok zu einem 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 Plattformzahl auf 22, Microsoft Teams ist vollständig integriert, das Nachladen des Discord-Verlaufs ist standardmäßig aktiviert, und Telegram-/Discord-clarify-Prompts verwenden nun native Schaltflächen.
• Die Überprüfung beim Schreiben verbessert sich. Nach Bearbeitungen kann Hermes Zusammenfassungen der Dateimutationen pro Turn sowie semantische Diagnosen des Language Servers vor dem nächsten Turn anzeigen, wodurch es evidenzbasierter Agent-Arbeit näherkommt.
• Desktop- und Medien-Tooling werden breiter. computer_use funktioniert über cua-driver für Nicht-Anthropic-Provider, video_generate ist hinter austauschbaren Backends vereinheitlicht, und vision_analyze sendet rohe Pixel an Modelle, die tatsächlich sehen können.

Jeder folgende Abschnitt basiert auf der Upstream-Dokumentation unter hermes-agent.nousresearch.com/docs und dem Quellbaum unter github.com/NousResearch/hermes-agent. Jede Tatsachenbehauptung enthält eine Fußnote, die auf die jeweilige spezifische Upstream-Seite verweist.

Wählen Sie Ihren Weg

So funktioniert Hermes: Das mentale Modell

Hermes ist um eine einzige Konversationsschleife herum aufgebaut, die von jedem Einstiegspunkt aufgerufen werden kann. Zu den Einstiegspunkten gehören die CLI (cli.py), das Messaging-gateway (gateway/run.py), der ACP-Adapter für die Editorintegration, der Batch-Runner und ein API-Server.³ Sie alle rufen letztlich AIAgent.run_conversation() in run_agent.py auf. Diese Methode:

1. Erstellt über prompt_builder.py den System-Prompt aus SOUL.md, MEMORY.md, USER.md, skills, Kontextdateien und Tool-Anweisungen³
2. Ermittelt über runtime_provider.py den Laufzeitanbieter – in diesem Schritt werden Ihre Authentifizierung, die Basis-URL und der API-Modus ausgewählt³
3. Ruft den Anbieter in einem von drei API-Modi auf: chat_completions, codex_responses oder anthropic_messages³
4. Leitet alle zurückgegebenen Tool-Aufrufe über model_tools.py und die zentrale Tool-Registry (tools/registry.py) weiter³
5. Wiederholt die Schleife, bis das Modell eine endgültige Antwort erzeugt, und speichert die Sitzung anschließend mit FTS5 in SQLite³

Diese Schleife zu verstehen ist wichtig, da jede Funktion – Persönlichkeiten, Gedächtnis, skills, Komprimierung und Fallback – an eine dieser Phasen anknüpft. Wenn Sie einen Konfigurationsschlüssel lesen und sich fragen, was er bewirkt, lautet die Antwort meist: „Er ist ein Stellhebel für Phase 1, 2, 3 oder 4 der obigen Schleife.“

Plattformunabhängiger Kern. Eine einzige AIAgent-Klasse bedient CLI, gateway, ACP, Batch und den API-Server. Plattformspezifische Unterschiede liegen im Einstiegspunkt, nicht im Agenten selbst.³ Deshalb funktionieren dieselben Slash-Befehle sowohl im Terminal als auch in Telegram – sie werden über eine gemeinsame COMMAND_REGISTRY in hermes_cli/commands.py weitergeleitet.⁶

Die Verzeichnisstruktur ist das System. Hermes speichert alles unter ~/.hermes/ (oder bei nicht standardmäßigen profiles unter $HERMES_HOME):⁴

~/.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 der oben aufgeführten Dateien erfüllt eine bestimmte Aufgabe; ihre Zuständigkeiten überschneiden sich nicht. Wenn Sie wissen möchten, „wo Hermes X speichert“, finden Sie es an einer dieser Stellen.

Neuerungen in v0.20.0 (The Herald Release)

Hermes Agent v0.20.0 (Tag v2026.8.3, 3. August 2026) ist das aktuelle Funktionsrelease; v0.20.1 (13. August) und v0.20.2 (16. August) sind darauf aufbauende Stabilisierungsversionen. Mit v0.20.3 (Tag v2026.8.16.2, veröffentlicht am 17. August) und v0.20.4 (Tag v2026.8.18, 18. August) setzt sich die Folge der Sammelreleases fort, jeweils mit eigenen neuen Funktionen – weitere Informationen finden Sie im nachfolgenden Unterabschnitt. Der Zeitraum seit v0.19.0 umfasst etwa 3.650 Commits, 1.400 zusammengeführte PRs und 1.200 geschlossene Issues von mehr als 650 Mitwirkenden.²⁴

Drei Änderungen machen die Anweisungen früherer Versionen dieses Leitfadens hinfällig. Lesen Sie diese Hinweise zuerst:

• Node 26 ist jetzt erforderlich. Das Installationsprogramm setzt NODE_VERSION="26" fest und verweigert ältere Laufzeitumgebungen mit der Meldung „Node.js … is too old (Hermes requires Node >=26).“ Installationsprogramme, heal und upgrade setzen diese Voraussetzung allesamt durch. Beachten Sie, dass auf der Installationsseite der Dokumentationswebsite noch Node v22 angegeben ist – das Installationsskript und die Versionshinweise sind die neueren, maßgeblichen Quellen.²⁴
• pip und Homebrew wurden eingestellt und nicht lediglich als veraltet markiert. Wörtlich heißt es: „brew + pip/PyPI wheel channels retired (shell installer / Docker / Nix are the supported channels).“ Wenn Sie Hermes weiterhin über pip oder brew installiert haben, erhalten Sie über diesen Weg keine neuen Releases mehr.²⁴
• Das standardmäßige Iterationslimit für Tool-Aufrufe wurde von 90 auf 500 erhöht. Lange autonome Ausführungen stoßen damit nicht mehr an eine künstliche Grenze, und alle nachfolgend aufgeführten Schwellenwerte für Budgetengpässe werden anhand des neuen Höchstwerts berechnet. read_file liest standardmäßig außerdem 2.000 statt 500 Zeilen.²⁴

Weitere Neuerungen des Releases:

• Konversationsfähige Sprachausgabe. Streaming-TTS mit Unterbrechungsmöglichkeit und lokal auf dem Gerät erkannten Aktivierungswörtern.²⁴
• A2A v1.0. Ein Plugin für das Agent-zu-Agent-Protokoll, das die seit Langem bestehende Anfrage aus Issue #514 erfüllt.²⁴
• Signierte ausgehende Webhooks. hermes webhook unterstützte zuvor nur eingehende Webhooks; v0.20.0 ergänzt HMAC-signierte ausgehende Lebenszyklus-Webhooks für Sitzungs-, Turn- und Tool-Ereignisse.²⁴
• Quellenbasierte Zitate. Ein neuer skill mit einem Faktenprüfungsmodus.²⁴
• Neue Funktionen für CLI-Power-User. Mit !command können Sie einen Shell-Befehl sofort ausführen, ohne einen Modell-Turn zu verbrauchen; /init durchsucht das Projekt und erstellt oder aktualisiert eine AGENTS.md; /diff zeigt von jeder Oberfläche aus bereitgestellte, sämtliche oder sitzungsbezogene Änderungen; /context schlüsselt auf, womit das Kontextfenster belegt ist; /focus bietet eine Ansicht mit reduzierter Ausgabe, in der ausgeblendete Zeilen wieder eingeblendet werden können; mit Strg+S lässt sich ein halb fertig geschriebener Prompt zwischenspeichern. hermes import-agent migriert eine Claude Code- oder Codex-CLI-Konfiguration mit einem einzigen Befehl.²⁴
• Erweiterungen der Geheimnisverwaltung. Eine auf Hilfsbefehlen basierende Geheimnisquelle, die sich mit jedem Tresor kombinieren lässt, Token-Rotation mit einem einzigen Befehl und aussagekräftigen Startfehlern, ein optionaler verschlüsselter Notfall-Cache für Bitwarden, pro profile-Home begrenzte, vom Tresor eingespeiste Schlüssel sowie ${env:VAR}-SecretRef-Parität zwischen config.yaml und der MCP-Konfiguration. Das nachfolgend beschriebene Authentifizierungsmodell mit drei Pfaden bleibt unverändert.²⁴
• Schnellerer Warmstart. Die Kaltstartzeit von hermes -w sank von etwa 14 s auf 1,8 s.²⁴
• Desktop wurde zu einer Plattform. Artefakte mit versionierten Karten und isolierter Live-Vorschau, ein Plugin-SDK mit Kanban als erstem Desktop-Plugin, ein globales Tastenkürzel für die Schnelleingabe, mehrere GUI-Fenster, ein SSH-Remote-Backend-Modus und eine native Anmeldung nach RFC 8252.²⁴

Die Sammelreleases v0.20.3 und v0.20.4 (17.–18. August)

Nach v0.20.0 folgt das Projekt einem Rhythmus häufig getaggter Sammelreleases, wobei die beiden neuesten mehr als reine Stabilisierungsversionen sind. Beide weisen darauf hin, dass „full curated release notes for this window will ship with v0.21.0“ – die folgenden Zusammenfassungen beruhen daher auf den Beschreibungen der jeweiligen Release-Zeiträume und nicht auf einer kuratierten Funktionsliste.²³

v0.20.3 (ca. 250 Commits, ca. 125 PRs seit v0.20.2):

• Migration auf MCP 2.x SDK mit Unterstützung des zustandslosen Protokolls vom 28. Juli 2026. Hermes wechselt zur aktuellen MCP-SDK-Generation und unterstützt die zustandslose Revision des Protokolls.²³
• Bot Mode wird als gebündeltes Plugin ausgeliefert (hermes-bots), das das zentrale Teamkollegenprotokoll enthält.²³
• Ein CommandCode-Anbieter-Plugin ergänzt den Anbieterkatalog.²³
• Cua Driver 0.20-Laufzeitverträge für die Computernutzung sowie eine gehärtete Laufzeitzuständigkeit für den Subprozess Python (Isolierung von PYTHONHOME/PYTHONPATH).²³
• Zuverlässigkeit: Selbstheilung des cron-Schedulers (EMFILE-Wiederherstellung, Abgleich veralteter Ansprüche, erneute Aktivierung festgefahrener Aufgaben), Korrekturen gegen Datenverluste bei Sitzungsübergaben, selbstheilende Verbindungen zum Desktop-Remote-gateway sowie zahlreiche Verbesserungen im Ökosystem (Sicherheitsscans bei der Plugin-Installation, /worktree, Beibehaltung manueller Änderungen bei /rollback, Lesen von UTF-16-Dateien).²³

v0.20.4 (ca. 146 Commits, ca. 74 PRs seit v0.20.3):

• Die Glasoberfläche des Desktops: Arbeiten an Mattglas und Transparenz mit einem Frost-Auswahlwerkzeug und macOS-Vorauswahl.²³
• Eine SESSIONS|BOTS-Seitenleiste mit Tabs und Optionen zum Aus- und Einblenden einzelner Bots sowie Korrekturen für Bot Mode-Gruppenchats (lang laufende Mitglieder-Turns, Markdown-Darstellung, computerübergreifendes Routing).²³
• NVIDIA SkillEvaluator Tier 1-Hinweisscans bei der Installation von skills – bei der Installation eines skill werden Lizenz- und Sicherheitsprüfungen ausgeführt.²³
• Härtung des Medienversands über cron (konfigurierbares Zeitlimit, Anhänge bei manueller Ausführung, Anzeige verpasster Ausführungen), Korrekturen an Event-Loop-Threads und bei Zugriffskonflikten in SessionDB, ehrliche Statusmeldungen von hermes update bei geparkten Branches sowie native Betriebssystembenachrichtigungen für Kanban.²³

Die Aktualisierung erfolgt weiterhin unverändert: bei einer bestehenden Installation mit hermes update, bei einer Neuinstallation über das Shell-Installationsprogramm.²³

Neu in v0.19.0 (The Quicksilver Release)

Hermes Agent v0.19.0 (Tag v2026.7.20, 20. Juli 2026) ist nach der Geschwindigkeit des Götterboten benannt: Das Rückgrat des Releases ist reine Reaktionsfähigkeit, mit einer Verkürzung der Time-to-First-Token in der ersten Runde um ~80 % auf allen Plattformen. Darum gruppieren sich Terminal-Abrechnung, Secret-Quellen aus Passwortmanagern, standardmäßig intelligente Genehmigungen, beobachtbare Subagents und absturzsichere Antwortzustellung. Das Zeitfenster seit v0.18.0 ist das bislang größte Projektfenster: ~2.245 Commits, ~1.065 zusammengeführte PRs, ~3.300 geschlossene Issues und über 450 Community-Mitwirkende.²⁵

• ~80 % schneller zum ersten Token, überall. Das kalte Submit→Dispatch sank über CLI, gateway, TUI, Desktop und cron hinweg von ~4,3 s auf ~0,9 s — die Discord-Fähigkeitserkennung wurde aus dem kritischen Pfad entfernt, der Ollama-Probe wird bei bekannten Nicht-Ollama-Providern übersprungen, und blockierende Arbeit wurde aus der Agent-Initialisierung entfernt. Auch die wahrgenommene Latenz wurde verbessert: Reasoning-Modelle streamen ihre Überlegungen nun standardmäßig live (display.show_reasoning ist ON), und das Antwortfeld rendert pro Token statt pro Zeile.²⁵
• Rendering-Welle für Desktop und TUI. Die Desktop-App erhielt eine Geschwindigkeitsüberholung mit ~20 PRs: 14× weniger CPU im Streaming-Markdown-Splitter durch inkrementelles Block-Lexing, virtualisierte Diffs im Review-Bereich, zügiger Sitzungswechsel bei großen Transkripten sowie keine erneuten Renders der Seitenleiste und Tool-Zeilen mehr pro Token. Die TUI rendert gestreamtes Markdown nun inkrementell pro Block.²⁵
• pip- und Homebrew-Installationen sind veraltet. Beide Wege wurden als „unsupported legacy“-Installationen markiert, ihre Entfernung war geplant. Diese Entfernung ist inzwischen in v0.20.0 erfolgt — die brew- und pip/PyPI-Wheel-Kanäle wurden eingestellt; unterstützt bleiben der Shell-Installer, Docker und Nix.²⁵²⁴
• Secrets können aus Ihrem Passwortmanager stammen. Eine neue steckbare SecretSource-Schnittstelle ruft Secrets beim Laden aus Bitwarden und 1Password (op://-Referenzen) ab, unterstützt mehrere Vaults gleichzeitig, deterministische Priorität, Konfliktwarnungen und die Herkunft jeder Variablen — API-Schlüssel müssen nicht länger in einer Klartext-.env liegen. Künftige Vault-Provider lassen sich als Plugins ergänzen.²⁵
• Intelligente Genehmigungen sind jetzt Standard. Wenn Hermes einen markierten Befehl ausführen möchte, bewertet ein unabhängiger LLM-Reviewer ihn, statt Sie bei jedem einzelnen Befehl zu fragen — und jedes Urteil gilt nur für genau diesen Befehl. Benutzerdefinierte deny rules blockieren passende Befehle selbst im YOLO-Modus, /deny <reason> übermittelt Ihren Ablehnungsgrund, damit der Agent seinen Kurs korrigiert, und die Plugin-Aktion pre_tool_call approve (mit Rule-Keys wieder eingeführt) eskaliert einen Tool-Aufruf zu einer menschlichen Freigabe.²⁵
• Terminal-Abrechnung: /subscription und /topup. Verwalten Sie Ihren Nous Portal-Plan, ohne das Terminal zu verlassen — sehen Sie Ihren Plan und das verbleibende Kontingent, prüfen Sie exakt, was ein Upgrade kostet oder wann ein Downgrade wirksam wird, und wenden Sie es mit Rückgängig-Option an. Die Desktop-App erhält einen passenden Abrechnungs-Tab in den Einstellungen.²⁵
• Beobachten Sie Subagents bei der Arbeit; verlieren Sie nie wieder eine fertige Antwort. delegate_task-Dispatches liefern Live-Transkriptdateien zurück, die Sie mit tail -f verfolgen können, sobald Subagents starten — jeder Tool-Aufruf, jedes Ergebnis und jede gestreamte Antwort, ein menschenlesbares Log pro Child. Abschlüsse von Hintergrunddelegierungen bleiben Neustarts überdauernd erhalten, und finale gateway-Antworten werden in einem delivery-obligation ledger in state.db erfasst und beim nächsten Start erneut zugestellt, falls das gateway während des Sendens ausfällt. Die Konfigurationsoption max_async_children ist zugunsten einheitlicher Concurrency-Limits für Delegierungen veraltet.²⁵
• Ein gateway, viele profile. Ein einzelnes multiplexed gateway, das einen Bot-Token teilt, kann bestimmte Guilds, Channels oder Threads an unterschiedliche profile weiterleiten — jeweils mit vollständig isolierter Konfiguration, skills, memory und secrets — mit einem GATEWAY_MULTIPLEX_PROFILES-Override. Der Routing-Index wurde nach state.db verschoben; sessions.json ist nun ein optionaler Legacy-Spiegel.²⁵
• Provider- und Modell-Welle. Fireworks AI kommt als First-Class-Provider hinzu (Kostenschätzung, Platz 2 im Provider-Picker), ergänzt durch DeepInfra und Upstage Solar. Die Kataloge erhalten GPT-5.6 (Sol/Terra/Luna + Pro, Ende-zu-Ende verdrahtet), grok-4.5 (GA), kimi-k3 (kimi-k2.x eingestellt) und vollständig verdrahtetes Claude Sonnet 5. Ein enabled: false-Flag pro Provider und die Konfiguration excluded_providers entfernen ungenutzte Provider aus /model-Pickern und der Auflösung.²⁵
• Reasoning effort wird zum Regler. Neue Effort-Stufen max und ultra kommen auf allen Oberflächen hinzu, mit modellbezogenen Overrides in der Konfiguration, Effort pro Slot in MoA-Presets (Advisors denken intensiv nach, der Synthesizer bleibt schnell), taskbezogenem Effort für Hilfsmodelle und einem sitzungsbezogenen /reasoning in CLI.²⁵
• CLI- und MCP-Oberfläche. hermes sessions export schreibt Markdown-, Quarto-, HTML-, Prompt-only- und Hugging-Face-Trace-Formate mit optionaler Bereinigung über --redact; /model --once ermöglicht einen Modell-Override für eine Runde; Slash-skill-Aufrufe lassen sich stapeln (/skill-a /skill-b do XYZ); --safe-mode unterstützt die Fehlerbehebung; hermes config get/unset vervollständigen die Konfigurationsverwaltung; hermes serve wird zu einem echten Headless-Backend; und MCP-Tools übernehmen die Namenskonvention mcp__server__tool.²⁵

Wenn Sie von v0.18.x aktualisieren, verdienen zwei Änderungen vor allem anderen Aufmerksamkeit: Eine pip- oder Homebrew-Installation warnt nun als unsupported legacy (migrieren Sie zum Einzeilen-Installer), und max_async_children ist zugunsten der einheitlichen Concurrency-Limits für Delegierungen veraltet. Alles andere ist additiv — die wichtigsten Gründe für ein Upgrade sind die ~80%ige Verringerung der Latenz in der ersten Runde, intelligente Genehmigungen und das Delivery Ledger, das fertige Antworten absturzsicher macht.

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, anstatt Erfolg zu behaupten, und Ensemble Reasoning, das Sie tatsächlich prüfen können. Außerdem schließt es den gesamten P0/P1-Backlog — ungefähr 692 Aufgaben mit höchster Priorität wurden innerhalb von zwölf Tagen erledigt.²²

• Mixture-of-Agents als First-Class-Modell. MoA ist nun wie jedes andere Modell über alle Oberflächen hinweg auswählbar, und Ensemble Reasoning ist sichtbar: Die vollständige Ausgabe jedes Referenzmodells wird als eigener beschrifteter Block mit Live-Antwortstreaming gerendert — Sie können dem Ensemble beim Denken zusehen, statt eine intransparente zusammengeführte Antwort zu erhalten.²²
• Completion contracts für /goal. Der Agent überprüft seine eigene Arbeit, indem er die Projektprüfungen ausführt, bevor er ein Ziel als abgeschlossen meldet, statt Erfolg zu behaupten — auf sich selbst angewandtes Urteilsvermögen.²²
• /learn — beschreiben Sie beliebige Vorgänge als skill. Verwandeln Sie einen Workflow in einen wiederverwendbaren skill, indem Sie ihn beschreiben; generierte skills entsprechen automatisch den CONTRIBUTING.md-Konventionen des Repositorys.²²
• /journey-Timeline. Eine visuelle Historie von memory und skills im Zeitverlauf, inklusive Bearbeitung, sowie ein Memory-Graph auf dem Desktop.²²
• Fan-out von Hintergrund-Subagents. Delegieren Sie mehrere Aufgaben, die gleichzeitig ausgeführt werden, ohne die Unterhaltung zu blockieren — aus dem einzelnen Hintergrund-Subagent von v0.17.0 wird eine Flotte.²²
• Desktop Projects. First-Class-Coding-Projects mit einem Organisationsmodell aus Projekt/Repository/Lane.²²
• Scale-to-zero gateway. Gateways können bei Inaktivität ruhen 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 Aktualisierung des OAuth2-Tokens, ergänzt den Provider-Katalog.²²
• Editor-Befehl /prompt. Öffnet $EDITOR zum Verfassen mehrzeiliger Prompts, statt mit der Eingabezeile zu kämpfen.²²

Wenn Sie von v0.17.x aktualisieren, unterbricht hier nichts 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 zum Erfassen von skills.

Neuerungen in v0.17.0 (das Reach Release)

Hermes Agent v0.17.0 (Tag v2026.6.19, 19. Juni 2026) ist danach benannt, wie weit der Agent inzwischen reicht — neue Messaging-Kanäle, neue Modellanbieter sowie umfassendere Desktop- und Dashboard-Steuerung. Es 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 (Gerätecode-OAuth, hermes photon login); die WhatsApp Business Cloud API ist ein offizieller Meta-Adapter, der die Anforderung eines Bridge-Prozesses ersetzt; SimpleX erhält Gruppen, native Anhänge, Text-Batching und automatische Annahme; außerdem kommt Raft als gebündeltes Plattform-Plugin mit einem datenschutzvertraglich gestalteten Wake-Channel hinzu.²¹
• Neue Modelle und Anbieter. 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 nun dem modernen Thinking-Vertrag (sie senden niemals ein reasoning-Feld).²¹
• Desktop und Dashboard. Der Desktop ergänzt Hintergrund-Subagents mit Live-Streaming delegierter Aktivitäten in „Watch Windows“ (delegate_task(background=true)), eine Composer-Modellauswahl, neu belegbare Tastenkürzel, native Betriebssystembenachrichtigungen, Composer-Entwürfe pro Thread, Themes aus dem VS Code Marketplace sowie eine Benutzeroberfläche auf Japanisch und traditionellem Chinesisch. Das Dashboard ergänzt einen vollständigen Profile Builder (Modelle/Skills/MCPs ohne Bearbeitung von config.yaml), einen globalen Profilumschalter, einen überarbeiteten Skills Hub mit Sicherheitsprüfung, Automation Blueprints (parametrisierte Vorlagen für Formulare, Slash Commands, Unterhaltungen und Dokumente) sowie einen sicheren Login, der hinter dem OAuth-Gate 401 zurückgibt.²¹
• Skills und Tools. image_generate kann nun ein Quellbild bearbeiten und transformieren, statt nur eines von Grund auf zu erstellen — bei allen unterstützten Bildanbietern; das memory-Tool erhielt ein operations-Array für atomare Batch-Vorgänge zum Hinzufügen/Ersetzen/Entfernen in einem einzigen Aufruf; ein neuer simplify-code-Skill führt eine parallele Prüfung und Bereinigung durch drei Agents aus, die über eine Chesterton’s-Fence-Risikostufe gesteuert wird; und ein boolesches write_approval ersetzt das dreistufige write_mode.²¹
• Architektur. Hintergrund-Subagents geben sofort ein Handle zurück und führen ihr Ergebnis als neuen Turn wieder ein; ein MCP-Elicitation-Handler ermöglicht Bestätigungen während eines Tool-Aufrufs, und sich spät verbindende MCP-Tools werden zwischen Turns bereitgestellt (cache-sicher); cron wird zu einem pluggable CronScheduler mit einem Chronos-Managed-Cron-Anbieter; und ein neuer Managed Scope (/etc/hermes) ermöglicht Administratoren, benutzerunveränderliche Konfiguration festzulegen — neben einem Gateway-Gateway-Relay für Multi-Gateway-Topologien.²¹
• Neue Befehle. /version, /billing (interaktive Terminal-Abrechnung), hermes photon login (iMessage-Authentifizierung) und hermes curator run --consolidate — die Konsolidierung ist nun optional, sodass die reguläre Hintergrund-Kuration keine Tokens kostet.²¹
• Sicherheit. v0.17.0 schließt einen Bypass der Shell-Escape-Denylist, schlägt bei fehlenden Approval-Modulen und Gateway-Adaptern mit eigener Richtlinie sicher fehl, bereinigt die Umgebung für Cron-Job-Skript-Subprozesse, schwärzt Secrets in Request-Debug-Dumps, prüft MCP-Stdio-Konfigurationen auf Exfiltrationsmuster und aktualisiert urllib3 sowie PyJWT zur Behebung von CVEs.²¹

Wenn Sie von v0.16.x aktualisieren, beeinträchtigt nichts davon die CLI; es handelt sich um neue Kanäle, Modelle und Oberflächen rund um denselben Agenten. Die relayfreie iMessage-Integration, die offiziellen WhatsApp-Adapter und der administrative Managed Scope sind die wichtigsten Gründe für ein Upgrade.

Neuerungen in v0.16.0 (das Surface Release)

Hermes Agent v0.16.0 (Tag v2026.6.5, 5. Juni 2026) ist nach den neuen Oberflächen benannt, die es dem CLI-zentrierten Agenten voranstellt. Die wichtigste Neuerung: Hermes ist nicht länger auf das Terminal beschränkt.²⁰

• 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 Chatfenster mit Streaming, Drag-and-drop-Dateien, Einfügen von Zwischenablagebildern, eine Cmd+K-Palette, eine Sitzungsliste mit Archiv und Suche sowie eine Modellauswahl in der Statusleiste. Über ein sicheres WebSocket kann sie sich mit einem entfernten Hermes gateway verbinden und authentifiziert sich über OAuth oder Benutzername/Passwort; dabei stehen Remote-Hosts pro Profil und parallele Sitzungen mehrerer Profile zur Verfügung, die über profilübergreifende @session-Referenzen verbunden sind. Die Desktop-Benutzeroberfläche enthält außerdem eine vollständige Übersetzung ins vereinfachte Chinesisch (简体中文) über eine typisierte i18n-Schicht (display.language; Englisch bleibt die Standardsprache).²⁰
• Browser-Admin-Panel. Das lokale Web-Dashboard entwickelte sich von einer Statusansicht zu einem vollständigen Administrationspanel: ein MCP-Katalog mit Ein-/Aus-Schaltern, Verwaltung von Zugangsdaten, Erstellung von Webhooks und Hooks, Speicherkonfiguration, Gateway-Steuerung und eine Systemseite mit Prüfung vor Updates sowie Debug Share per Klick. Eine neue Channels-Seite konfiguriert jede Gateway-Messaging-Plattform (Telegram, Discord, Slack und weitere) im Browser. Die Authentifizierung ist nun austauschbar: Login mit Benutzername/Passwort, ein generischer selbstgehosteter OIDC-Anbieter, hermes dashboard register für einen selbstgehosteten OAuth-Client sowie Sitzungsrotation mittels Refresh Tokens.²⁰
• Neue CLI und Slash Commands. /undo [N] sichert die letzten N Benutzer-Turns mit vorausgefüllter Eingabe und Soft Delete und funktioniert in der CLI, der TUI sowie plattformübergreifend in Messaging-Diensten. Eine konfigurierbare Standardoberfläche (cli gegenüber tui) wird zusammen mit einer --cli-Überschreibung eingeführt; die TUI erhält einen einheitlichen /model-Befehl und ein Sessions-Overlay. hermes portal ist ein menschenlesbarer Alias für den Nous Portal-Onboarding-Ablauf, mit neuen Erststartpfaden für Quick Setup gegenüber Full Setup; zudem kommen zwei Diagnosebefehle 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 Key). Ein erstklassiger xAI Grok OAuth-Anbieter kommt zum Desktop-Launcher hinzu, die Modellauswahl unterstützt nun unscharfe Suche auf allen Oberflächen, Anbieter mit mehreren Endpoints werden unter einer Zeile zusammengefasst und die Aktualisierung des Katalogs erfolgt statt täglich nun stündlich.²⁰
• Schlankere Skills und Progressive Disclosure. Der Standard-Skillsatz entfernte redundante und ungenutzte Skills (Spotify wechselte zu einem nativen Plugin, Linear zu hermes mcp install linear, und mehrere veraltete Einträge wurden entfernt), verlagerte weitere in optional und ergänzte ein environments:-Frontmatter-Relevanz-Gate (kanban/docker/s6), das kontextspezifische Skills bis zur Anforderung aus dem Index heraushält. NVIDIA/skills ist nun neben OpenAI, Anthropic und HuggingFace eine standardmäßig vertrauenswürdige Skills-Hub-Quelle. MCP- und Plugin-Tools erhielten progressive (scoped) Tool Disclosure, und ein MCP-Fehler, der bei fehlendem Token fälschlich einen OAuth-Erfolg meldete, wurde behoben.²⁰
• Sicherheit. v0.16.0 fixiert gepatchtes Starlette (≥1.0.1) für CVE-2026-48710 (BadHost), verlagert SSRF-URL-Prüfungen in asynchronen Pfaden aus der Event Loop, entfernt den Bedrock-Inference-Bearer-Token aus der Subprozessumgebung, fügt bws_cache.json zum Dateisicherheits-Leseschutz hinzu, 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-Issues, davon waren 16 mit Security getaggt.²⁰

Wenn Sie von v0.15.x aktualisieren, ist nichts davon eine inkompatible Änderung an der CLI selbst; es sind ergänzende Oberflächen und Anbieter rund um denselben Agenten. Die Desktop-App und das Admin-Panel sind der Grund für ein Upgrade, wenn Sie Hermes für Benutzer ohne Terminal einsetzen oder ein entferntes gateway über einen Browser verwalten möchten.

Installation

Der Einzeilen-Installer ist der unterstützte Installationsweg. Er übernimmt Python, uv, Node.js, ripgrep, ffmpeg, das Klonen des Repositorys, die virtuelle Umgebung und den globalen Befehl hermes.⁷

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

Installationen über pip und Homebrew sind seit v0.19.0 veraltet. Das mit v0.14.0 eingeführte PyPI-Paket (pip install hermes-agent) und die Homebrew-Formel sind nun als Installationen mit „unsupported legacy“-Status gekennzeichnet — Hermes warnt überall davor (ohne die Nutzung zu blockieren), sobald eine davon erkannt wird; die Veröffentlichung über PyPI/Homebrew soll entfernt werden. Wenn Sie über pip oder brew installiert haben, migrieren Sie zum obigen Installer.²⁵

Funktioniert unter Linux, macOS, WSL2 und Android/Termux (der Installer erkennt Termux automatisch und wechselt zu einem getesteten Android-Bundle).⁷ Native Windows-Unterstützung ist inzwischen eine Tier-1-Plattform statt der mit v0.14.0 ausgelieferten frühen Beta — installieren Sie sie mit iex (irm https://hermes-agent.nousresearch.com/install.ps1). Einen Vorbehalt nennen die Dokumente ausdrücklich: macOS wird nur auf Apple Silicon unterstützt; Intel-Macs werden nicht unterstützt.²⁴ Historisch gesehen ergänzte v0.14.0 die native Windows-Unterstützung als frühe Beta über einen PowerShell-Installer, doch WSL2 bleibt für den produktiven Einsatz die sicherere Empfehlung, bis der Windows-Pfad ausgereift ist.¹⁹

Nach Abschluss:

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

Die einzige Voraussetzung ist git. Der Installer richtet Python 3.11 über uv automatisch ein (kein sudo erforderlich), außerdem Node.js 26 (für Browserautomatisierung und die WhatsApp-Bridge), ripgrep und ffmpeg. Node 26 ist seit v0.20.0 eine zwingende Mindestversion — der Installer lehnt alles Ältere ab und installiert stattdessen ein von Hermes verwaltetes Node.²⁴⁷

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 können.⁷ hermes dump ist der Diagnosebefehl, den Sie bei einer Hilfeanfrage in ein GitHub-Issue oder einen Discord-Thread einfügen sollten — er liefert eine Klartextzusammenfassung Ihrer gesamten Einrichtung, wobei Geheimnisse geschwärzt werden.⁸

Manuelle Installation

Wenn Sie vollständige Kontrolle benötigen — eine benutzerdefinierte Python-Version, bestimmte Extras oder 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 unterscheidet sich — er verwendet pip mit einer Constraints-Datei, nicht uv pip:

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

Der Grund: .[all] zieht auf Android über das Extra voice faster-whisper nach, das von ctranslate2-Wheels abhängt, die nicht für Android veröffentlicht werden.⁷

Authentifizierung & Anbieter

Hermes unterstützt etwa 22 erstklassige Anbieter sowie benutzerdefinierte Endpunkte (v0.19.0 ergänzt Fireworks AI, DeepInfra und Upstage Solar) und drei unterschiedliche Authentifizierungswege. Hier finden Sie die gesamte Authentifizierungsoberfläche, nach Pfaden organisiert, damit Sie den passenden Weg für Ihre Voraussetzungen finden.

Die drei Authentifizierungspfade

Jeder Anbieter in Hermes folgt einem von drei Authentifizierungsmustern:

Pfad 1 — API-Schlüssel in .env. Hinterlegen Sie Ihren Schlüssel in ~/.hermes/.env; Hermes liest ihn beim Start ein. Verwendet für 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 die meisten Drittanbieter.² Seit v0.19.0 muss der Schlüssel nicht mehr in einer Klartextdatei liegen: Eine einsteckbare SecretSource-Schnittstelle kann Geheimnisse beim Laden aus Bitwarden oder 1Password (op://-Referenzen) abrufen, wobei mehrere Tresore gleichzeitig aktiviert werden können, eine deterministische Priorität, Konfliktwarnungen und eine Herkunft pro Variable vorhanden sind — .env bleibt der Fallback. (Dies unterscheidet sich vom Bootstrap-Token des Bitwarden Secrets Manager aus v0.15.0, der Anbieterschlüssel hinter einem Token zusammenführte; SecretSource ersetzt die Klartextdatei selbst, und künftige Tresoranbieter lassen sich als Plugins hinzufügen.)²⁵

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

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

Die vollständige Anbietermatrix

Dies ist die vollständige Liste erstklassiger Anbieter mit dem genauen Einrichtungsablauf für jeden einzelnen.²

Ab v0.19.0 können Sie außerdem nicht verwendete Anbieter ausblenden: Ein anbieterbezogenes Flag enabled: false sowie der Konfigurationsschlüssel excluded_providers entfernen sie aus /model-Auswahlen und der integrierten Anbieterauflösung.²⁵

Anthropic: Drei Authentifizierungsmethoden

Anthropic erhält einen eigenen Abschnitt, weil Hermes drei unterschiedliche Wege zu Claude unterstützt und die richtige Wahl wichtig ist. Aus der Upstream-Dokumentation:²

# 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 auswählen, bevorzugt Hermes den eigenen Anmeldedatenspeicher von Claude Code, statt das Token in ~/.hermes/.env zu kopieren. Dadurch bleiben aktualisierbare Claude-Anmeldedaten aktualisierbar.² Falls Sie Claude Code bereits auf demselben Rechner 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 Kurzform für --provider anthropic.²

GitHub Copilot: Zwei Modi

Copilot wird in zwei Modi unterstützt: direkter Copilot-API (empfohlen) und Copilot ACP (startet den lokalen Copilot CLI als Unterprozess).²

# 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-Dokumentation in dieser Reihenfolge geprüft:² 1. Umgebungsvariable COPILOT_GITHUB_TOKEN 2. Umgebungsvariable GH_TOKEN 3. Umgebungsvariable GITHUB_TOKEN 4. gh auth token CLI-Fallback 5. OAuth-Device-Code-Anmeldung über hermes model

Der Tokentyp ist entscheidend. Der Copilot-API unterstützt keine klassischen Personal Access Tokens (ghp_*). Unterstützte Typen sind OAuth-Tokens (gho_*), fein abgestufte PATs (github_pat_* mit der Berechtigung Copilot Requests) und GitHub-App-Tokens (ghu_*). Falls Ihr gh auth token ein ghp_*-Token zurückgibt, verwenden Sie stattdessen hermes model, um sich über OAuth zu authentifizieren.²

Chinesische AI-Anbieter (erstklassige Unterstützung)

Hermes bietet integrierte Unterstützung für z.ai/GLM, Kimi/Moonshot, MiniMax (globale + China-Endpunkte) und Alibaba Cloud mit dedizierten Anbieter-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. Bei Verwendung des z.ai/GLM-Anbieters prüft Hermes mehrere Endpunkte (globale, chinesische und Coding-Varianten), um einen zu finden, der Ihren API-Schlüssel akzeptiert. Der funktionierende Endpunkt wird automatisch zwischengespeichert — für die meisten Benutzer ist kein GLM_BASE_URL erforderlich.²

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 Konversationssitzung auf denselben Server zu routen und zwischengespeicherte Systemprompts und den Verlauf wiederzuverwenden.² Automatisch; keine Konfiguration erforderlich.

Der Befehl hermes auth

hermes auth ist der Befehl zur Verwaltung von Anmeldedaten 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

Anmeldedatenpools ermöglichen die Rotation mehrerer API-Schlüssel oder OAuth-Tokens für denselben Anbieter — nützlich, um Ratenlimits über mehrere Schlüssel zu verteilen, ohne Code zu ändern.⁶ Die veralteten Befehle hermes login / hermes logout wurden entfernt; verwenden Sie stattdessen hermes auth.⁶

Benutzerdefinierte & selbstgehostete Endpunkte

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

Interaktive Einrichtung (empfohlen):

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

Manuelle 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 werden in config.yaml gespeichert; dies ist die zentrale Quelle für Hauptmodell, Anbieter und Basis-URL.² Die veralteten Umgebungsvariablen OPENAI_BASE_URL und LLM_MODEL werden nicht mehr für die Hauptmodellkonfiguration gelesen — verwenden Sie hermes model oder bearbeiten Sie config.yaml direkt.² (OPENAI_BASE_URL + OPENAI_API_KEY werden weiterhin als Fallback für den zusätzlichen Routingpfad provider: "main" berücksichtigt; löschen Sie sie daher nicht unbedacht, falls Sie sie dort verwenden.)⁴

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

Lokale LLM-Server (Einrichtungsvorlagen)

Die Upstream-Dokumentation enthält vollständige Einrichtungsanleitungen für Ollama, vLLM, SGLang, llama.cpp und LM Studio. Hier sind die zentralen Befehle, die Sie tatsächlich ausführen werden. Jeder ist darauf ausgelegt, einen funktionierenden Endpunkt bereitzustellen, auf den Hermes verweisen kann.²

Ollama — der einfachste lokale 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

Wichtiger Ollama-Stolperstein: Ollama verwendet standardmäßig sehr geringe Kontextlängen (4.096 Tokens bei weniger als 24 GB VRAM). Sie müssen sie über OLLAMA_CONTEXT_LENGTH oder eine Modelfile erhöhen — der OpenAI-kompatible API akzeptiert keine Kontextlänge vom Client, sodass Hermes sie nicht für Sie festlegen kann.² Für die Verwendung als Agent sollten Sie mindestens 16k–32k einstellen.

vLLM — leistungsstarkes 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-Aufrufe erfordern --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 werden Tool-Aufrufe als Klartext zurückgegeben.²

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

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-Stolperstein: Der Standardwert für max_tokens ist 128. Legen Sie auf dem Server --default-max-tokens fest oder konfigurieren Sie model.max_tokens in config.yaml, falls 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-Aufrufe erforderlich. Ohne diese Option ignoriert llama-server den Parameter tools vollständig, und das Modell versucht, Tools durch Schreiben von JSON in seinem Antworttext aufzurufen — was Hermes nicht als tatsächliche Tool-Aufrufe analysieren kann.²

LM Studio — Desktop-App mit GUI:

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

Wichtiger LM Studio-Stolperstein: LM Studio liest die Kontextlänge aus den Modellmetadaten, doch viele GGUF-Modelle melden Standardwerte von 2048 oder 4096. Legen Sie die Kontextlänge in den LM Studio-Modelleinstellungen immer ausdrücklich fest — 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 Anbieter

Falls Sie mit mehreren benutzerdefinierten Endpunkten arbeiten (beispielsweise einem lokalen Entwicklungsserver und einem entfernten GPU-Server), definieren Sie sie als benannte benutzerdefinierte Anbieter 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

Wechseln Sie dann während einer Sitzung mit der Dreifachsyntax 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 Anbieter auch über das interaktive Menü hermes model auswählen.²

Einsteckbare Anbieterarchitektur (v0.13.0+)

v0.13.0 liefert eine ProviderProfile-ABC sowie ein Verzeichnis plugins/model-providers/, damit sich externe Inferenzanbieter ohne Änderungen am Kern hinzufügen lassen.¹⁸ Falls ein Anbieter einen OpenAI-, Anthropic- oder Codex-kompatiblen API-Modus unterstützt, können Sie eine ProviderProfile-Unterklasse implementieren, welche Authentifizierungspfad, Basis-URL, Modellkatalog und Caching-Header deklariert; Hermes löst sie über denselben runtime_provider.py-Pfad auf, den auch die integrierten Anbieter verwenden. Diese Architekturänderung steht hinter der Anbietererweiterung in v0.13.0: Statt den Kerncode zur Aufnahme eines Anbieters zu bearbeiten, liefern Sie ein Plugin aus.

OpenAI-kompatibler lokaler Proxy (v0.14.0+)

hermes proxy stellt einen OpenAI-kompatiblen lokalen Endpunkt bereit, der auf dem OAuth-Anbieter basiert, bei dem Hermes bereits angemeldet ist — Claude Pro, ChatGPT Pro, SuperGrok oder einem anderen kompatiblen konfigurierten Anbieter.¹⁹ Das bedeutet, dass Tools mit einem OpenAI-ähnlichen API, darunter Codex CLI, Aider, Cline, Continue oder benutzerdefinierte Skripte, Ihre abonnementbasierte Hermes-Authentifizierung ohne separaten API-Schlüssel wiederverwenden können. Behandeln Sie den Proxy als lokale Entwickler-Infrastruktur: Binden Sie ihn bewusst, machen Sie ihn nicht breit verfügbar und beachten Sie anbieterspezifische Bedingungen.

Erkennung der Kontextlänge

Laut Upstream-Dokumentation werden zwei 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 verwendet dies, um zu entscheiden, wann der Verlauf komprimiert werden soll.
• model.max_tokens — die Ausgabebegrenzung (maximale Anzahl Tokens, die das Modell in einer einzelnen Antwort erzeugen darf). Hat nichts mit der Verlaufslänge zu tun.

Legen Sie context_length fest, wenn die automatische Erkennung die Fenstergröße falsch bestimmt:

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

Hermes verwendet eine mehrstufige Auflösungskette zur Erkennung von Kontextfenstern: Konfigurationsüberschreibung → benutzerdefinierter Anbieter pro Modell → persistenter Cache → Endpunkt /models → Anthropic /v1/models → OpenRouter API → Nous Portal → models.dev (von der Community gepflegte Registry für mehr als 3800 Modelle) → Fallback-Standardwerte (128K).² Das System ist anbieterbewusst, daher kann dasselbe Modell je nach bereitstellendem Anbieter unterschiedliche Kontextgrenzen haben (z. B. ist claude-opus-4.6 direkt bei Anthropic 1M, bei GitHub Copilot jedoch 128K).²

Intelligentes Modellrouting: Anbieterrotation & Fallback

Hermes bindet Sie nicht an ein Modell bei einem Anbieter. Intelligentes Modellrouting umfasst die Mechanismen, die entscheiden, welcher Anbieter und welches Modell eine bestimmte Anfrage tatsächlich bedient: Anmeldedatenpools verteilen die Last auf Schlüssel, ein konfigurierter Fallback übernimmt bei Ausfall des primären Modells, und die unten stehenden zusätzlichen Slots leiten Nebenaufgaben unabhängig von Ihrem Hauptmodell an günstigere Modelle weiter.²⁶ Konfigurieren Sie diese drei gemeinsam — sie machen den Unterschied zwischen einem Agenten, der an einem Ratenlimit hängen bleibt, und einem, der weiterarbeitet.

Anmeldedatenpools. Wenn Sie mehrere API-Schlüssel für denselben Anbieter haben, konfigurieren Sie über hermes auth eine Rotationsstrategie. So verteilen Sie Ratenlimits auf mehrere Schlüssel.⁶

Fallback-Modell. Konfigurieren Sie ein Ersatz-provider:model, zu dem Hermes automatisch wechselt, wenn Ihr primäres Modell ausfällt (Ratenlimits, 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 wechselt Modell und Anbieter mitten in der Sitzung, ohne Ihre Konversation zu verlieren. Er wird höchstens einmal pro Sitzung ausgelöst.² Unterstützte Anbieter für Fallbacks: 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.²

Zusätzliche Modelle

Hermes verwendet schlanke „zusätzliche“ Modelle für Nebenaufgaben: Bildanalyse, Zusammenfassung von Webseiten, Analyse von Browser-Screenshots, Klassifizierung der Freigabe gefährlicher Befehle, Kontextkomprimierung, Zusammenfassung der Sitzungssuche, Skill-Abgleich, MCP-Tool-Dispatch und Memory-Flush.⁴ Standardmäßig verwenden diese Gemini Flash über die automatische Erkennung (OpenRouter → Nous → Codex).

Sie können konfigurieren, welches Modell und welcher Anbieter für jede zusätzliche Aufgabe verwendet wird. Jeder zusätzliche Slot verwendet dieselben drei 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 Anbieteroption "main" bedeutet „den Anbieter verwenden, den mein Hauptagent nutzt“ — sie ist nur innerhalb der Konfigurationen auxiliary:, compression: und fallback_model: gültig. Für Ihre Einstellung model.provider auf oberster Ebene ist sie nicht gültig. Wenn Sie einen benutzerdefinierten OpenAI-kompatiblen Endpunkt als Hauptmodell verwenden, setzen Sie in Ihrem Abschnitt model: provider: custom.⁴

Warum das wichtig ist: Falls Sie nur Anthropic OAuth konfiguriert haben (ohne OpenRouter-Schlüssel), werden Ihre Bildverarbeitung, Webzusammenfassung und Komprimierung beeinträchtigt oder schlagen fehl, weil die standardmäßige zusätzliche Fallback-Kette zuerst OpenRouter versucht. Fügen Sie für zusätzliche Aufgaben einen OPENROUTER_API_KEY hinzu oder konfigurieren Sie jeden zusätzlichen Slot so um, dass er Ihren Hauptanbieter verwendet:

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

Dies ist der häufigste Stolperstein für neue Hermes-Benutzer, bei dem „meine Funktionen funktionieren stillschweigend nicht“ auftritt.

Konfigurationssystem

Hermes verfügt über ein mehrschichtiges Konfigurationssystem. Die Rangfolge zu verstehen, ist entscheidend, da 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 gehören diese Dateien zu 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 gegenüber .env — wenn beide gesetzt sind, hat config.yaml bei nicht vertraulichen Einstellungen Vorrang.⁴ Die Regel lautet: - Geheimnisse (API-Schlüssel, Bot-Tokens, Passwörter) → .env - Alles andere (Modell, Terminal-Backend, Komprimierungseinstellungen, Speicherlimits, Toolsets) → config.yaml

Auf Geheimnisse kann in config.yaml mit Interpolation im Shell-Stil verwiesen 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 get KEY        # Print a single value (v0.19.0+)
hermes config unset KEY      # Remove a key so the default applies again (v0.19.0+)
hermes config path           # Print the config file path
hermes config env-path       # Print the .env file path
hermes config check          # Check for missing options (after updates)
hermes config migrate        # Interactively add missing options

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

Rangfolge der Konfiguration

Hermes lädt die 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 Geheimnisse
5. Integrierte Standardwerte — werden angewendet, wenn keine andere Quelle einen Wert setzt

CLI-Flags haben bei diesem einzelnen Aufruf immer Vorrang. config.yaml ist die langfristige maßgebliche Quelle.

Lokalisierung (v0.13.0+)

v0.13.0 ergänzte 7 Gebietsschemata für CLI- und Gateway-Nachrichten: 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 Gebietsschemata und erhöht die Gesamtzahl auf 16.¹⁹ Die Dokumentation ist derzeit nur auf zh-Hans lokalisiert. Das Gebietsschema wird über die Umgebungsvariablen LC_ALL / LANG oder einen expliziten Schlüssel locale: in config.yaml bestimmt. Englisch bleibt die Standardsprache und die maßgebliche Quelle für jede Zeichenfolge, die von einer Übersetzung noch nicht abgedeckt ist.

Profile — Mehrere isolierte Hermes-Instanzen

Profile ermöglichen Ihnen mehrere isolierte Hermes-Instanzen, jeweils mit eigener Konfiguration, Sitzungen, Skills, Speicher und Gateway-PID. So können Sie „Hermes für die Arbeit“ und „persönliches Hermes“ parallel betreiben, ohne dass eine Instanz den Zustand der anderen sehen kann.⁶

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 Profil erhält sein eigenes HERMES_HOME (standardmäßig ~/.hermes-<name>/), sodass mehrere Profile das Gateway gleichzeitig ausführen können, ohne sich gegenseitig zu beeinträchtigen.⁶³

CLI-Befehle

Dieser Abschnitt ist das Praxisnachschlagewerk zu den übergeordneten CLI-Befehlen. Die maßgebliche, aus dem Code abgeleitete Referenz finden Sie in der CLI Commands Reference.⁶

Globale Optionen

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

Übergeordnete Befehle

hermes chat — Der wichtigste Einstiegspunkt

hermes ohne Argumente startet einen 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 zu einem 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 Protokollabfragen

hermes logs ist leistungsfähiger als tail -f für die Protokolldateien, weil Sie gleichzeitig nach Ebene, Sitzungs-ID und Zeitraum filtern können.⁶

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

Die Protokolldateien befinden sich in ~/.hermes/logs/:⁶ - agent.log — sämtliche Agentenaktivitäten (API-Aufrufe, Tool-Dispatch, Sitzungslebenszyklus, INFO+) - errors.log — nur Warnungen und Fehler (eine gefilterte Teilmenge von agent.log) - gateway.log — Aktivitäten des messaging gateway (Plattformverbindungen, Dispatch, webhooks)

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

hermes doctor — Diagnose

hermes doctor [--fix] ist der erste Befehl, den Sie ausführen sollten, wenn etwas nicht funktioniert. Er prüft die Gültigkeit der Konfiguration, vorhandene Abhängigkeiten, die Verfügbarkeit des API-Schlüssels und den Servicestatus und kann mit --fix automatische Reparaturen versuchen.⁶

Um Diagnosedaten mit anderen 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-Befehle

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

Sitzungssteuerung

Konfiguration & Modell

Der Befehl /model ist das zentrale Werkzeug, um den Provider während einer Sitzung zu wechseln:⁹

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

v0.19.0 fügt /model --once hinzu — eine Modellüberschreibung für einen Zug, die nach der Antwort automatisch wieder Ihr vorheriges Modell verwendet.²⁵

Tools, Skills & Informationen

Dynamische Skill-Slash-Befehle

Jedes installierte skill wird automatisch als Slash-Befehl 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

Seit v0.19.0 werden Slash-skill-Aufrufe gestapelt: /skill-a /skill-b do XYZ lädt beide skills in der angegebenen Reihenfolge in einem einzelnen Zug, mit Autovervollständigung und Ghost-Text für die verketteten Namen.²⁵

Sie können auch Schnellbefehle in config.yaml definieren, die einen kurzen Namen auf einen längeren Prompt abbilden:⁹

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.

Präfixabgleich

Befehle unterstützen Präfixabgleich: Die Eingabe von /h wird zu /help aufgelöst, /mod zu /model. Ist ein Präfix mehrdeutig, gewinnt die erste Registrierung in der Registry-Reihenfolge. Vollständige Befehlsnamen und registrierte Aliasse haben stets Vorrang vor Präfixübereinstimmungen.⁹

Messaging-spezifische Befehle

Einige Befehle funktionieren nur auf Messaging-Plattformen (Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant):⁹

• /status — Sitzungsinformationen anzeigen
• /sethome (Alias /set-home) — den aktuellen Chat als Plattform-Home markieren
• /approve [session|always] — einen ausstehenden gefährlichen Befehl genehmigen
• /deny [reason] — einen ausstehenden gefährlichen Befehl ablehnen. Seit v0.19.0 übermittelt /deny <reason> Ihren Ablehnungsgrund an den Agenten, damit er den Kurs korrigiert, statt blind erneut zu versuchen.²⁵
• /update — Hermes Agent auf die neueste Version aktualisieren
• /commands [page] — alle Befehle und skills durchsuchen (paginierte Ansicht)

Einige sind ausschließlich für CLI verfügbar: /skin, /tools, /toolsets, /browser, /config, /cron, /skills, /platforms, /paste, /statusbar, /plugins.⁹

Tools & Toolsets

Hermes verfügt über eine umfangreiche integrierte Tool-Registry für Websuche, Browserautomatisierung, Terminalausführung, Dateibearbeitung, Speicher, Delegierung, RL-Training, Nachrichtenübermittlung, Home-Assistant-Integration und mehr.¹⁰ Tools sind in logischen toolsets organisiert, die pro Plattform aktiviert oder deaktiviert werden können.

Kategorien auf hoher Ebene

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 während einer Sitzung auch ü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 sechs 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

Containerressourcen (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 werden mit Sicherheitsmaßnahmen ausgeführt: 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 die Hintergrundausführung mit expliziter Prozessverwaltung:¹⁰

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 können Sie SUDO_PASSWORD in ~/.hermes/.env festlegen.¹⁰

Multi-Agent Kanban (v0.13.0+)

v0.13.0 macht die Zusammenarbeit mehrerer Agenten zu einem erstklassigen Grundbaustein: einem dauerhaften Kanban-Board, das Aufgaben, Status und Worker-Identität agenten- und neustartübergreifend verfolgt.¹⁸ Das Board sorgt dafür, dass ein Schwarm von Hermes-Workern Aufgaben tatsächlich abschließt, statt bei blockierten Übergaben stehenzubleiben.

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

Was ist ein Hermes-Schwarm?

Ein Schwarm besteht aus mehreren Hermes-Workern, die parallel mit einem gemeinsamen Kanban-Board arbeiten. Er ist kein separates Subsystem, das Sie aktivieren müssen – vielmehr ermöglicht ihn erst das Board. Das Board liefert das eine, was parallele Agenten nicht selbst bereitstellen können: eine einzige verbindliche Antwort auf Welche Aufgabe sollte ich als Nächstes übernehmen, und arbeitet bereits jemand daran?

v0.15.0 erhob dieses Muster zu einer unterstützten Topologie und ergänzte eine Schwarmtopologie für die Koordination paralleler Worker, die automatische Zerlegung eines übergeordneten Ziels in Teilaufgaben, Modellüberschreibungen pro Aufgabe, geplante Aufgaben und Worktree-Verwaltung, damit parallele Worker nicht im selben Checkout kollidieren.²⁸

Die praktische Form: Geben Sie dem Schwarm ein Ziel, lassen Sie die automatische Zerlegung daraus Board-Aufgaben erstellen, und lassen Sie Worker die Aufgaben beanspruchen, ausführen und Ergebnisse zurückgeben. Das Wiederholungsbudget gilt pro Aufgabe (max_retries), sodass eine anfällige Teilaufgabe nicht die Toleranz des gesamten Durchlaufs aufbraucht. Da das Board dauerhaft ist, übersteht ein Schwarm Neustarts – Worker verbinden sich erneut und setzen die Arbeit mit demselben Status fort.

Ein Schwarm ist nur so gut wie seine Zerlegung. Das Board koordiniert Worker; es macht aus einem schlecht aufgeteilten Ziel kein gutes. Aufgaben mit gemeinsamem verborgenem Zustand werden weiterhin miteinander konkurrieren, unabhängig davon, ob Worktrees verwendet werden oder nicht.

Skills-System

Skills sind bei Bedarf ladbare Wissensdokumente, die der Agent bei Bedarf laden kann. Sie folgen dem Muster der progressiven Offenlegung, um den Tokenverbrauch zu minimieren, und sind mit dem offenen Standard von agentskills.io kompatibel.¹¹

Alle Skills befinden sich in ~/.hermes/skills/ — dem primären Verzeichnis und der maßgeblichen Quelle. Bei einer Neuinstallation werden gebündelte Skills aus dem Repository kopiert. Über den Hub installierte und vom Agent erstellte Skills werden ebenfalls hier abgelegt.¹¹

Progressive Offenlegung

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, 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 für Fallback-Skills nützlich — kostenlose oder lokale Alternativen, die nur angezeigt werden sollen, wenn ein Premium-Tool nicht verfügbar ist:¹¹

Beispiel: Der integrierte Skill duckduckgo-search verwendet fallback_for_toolsets: [web]. Wenn Sie FIRECRAWL_API_KEY festgelegt 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 Agent — wenn er einen nicht trivialen Workflow herausfindet, speichert er den Ansatz als Skill für die spätere Wiederverwendung.¹¹

Wann der Agent Skills erstellt:¹¹ - Nach dem erfolgreichen Abschluss einer komplexen Aufgabe (mehr als 5 Tool-Aufrufe) - Wenn er auf Fehler oder Sackgassen stieß und den funktionierenden Weg fand - Wenn der Benutzer seinen Ansatz korrigierte - Wenn er einen nicht trivialen Workflow entdeckte

Aktionen:¹¹

Skill Hub

Skills aus Online-Registrierungen 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-Quellen (ohne Einrichtung durchsuchbar): openai/skills, anthropics/skills, huggingface/skills, NVIDIA/skills, garrytan/gstack. Die Quelle claude-marketplace wurde in v0.20.0 entfernt; browse-sh ersetzte sie in der Quellenliste.¹¹²⁴

Sicherheitsprüfung

Alle über den Hub installierten Skills durchlaufen einen Sicherheitsscanner, der auf Datenexfiltration, Prompt Injection, destruktive Befehle, Signale in der Lieferkette und weitere Bedrohungen prüft.¹¹

Vertrauensebenen:¹¹

--force kann nicht gefährliche Richtlinienblockierungen für Community-Skills überschreiben. Eine dangerous-Bewertung des Scans wird dadurch nicht überschrieben.¹¹

Externe Skill-Verzeichnisse

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

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

Pfade unterstützen die Erweiterung von ~ und die Ersetzung von Umgebungsvariablen ${VAR}. Externe Verzeichnisse sind schreibgeschützt — wenn der Agent einen Skill erstellt oder bearbeitet, schreibt er ihn immer nach ~/.hermes/skills/. Bei einem Skill-Namen an beiden Orten hat die lokale Version Vorrang.¹¹

Persistenter Speicher

Hermes verfügt über einen begrenzten, kuratierten Speicher, der sitzungsübergreifend erhalten bleibt. Der Speicher des Agenten besteht aus zwei Dateien, die beide in ~/.hermes/memories/ gespeichert werden:¹²

Beide werden als eingefrorene Momentaufnahme beim Sitzungsstart in den System Prompt eingefügt. Der Agent verwaltet seinen eigenen Speicher über das Tool memory — add, replace oder remove.¹²

Muster der eingefrorenen Momentaufnahme: Die Einfügung in den System Prompt wird beim Sitzungsstart einmalig erfasst und ändert sich während der Sitzung nicht. Das ist beabsichtigt — so bleibt der Prefix Cache von LLM für eine bessere Leistung erhalten. Änderungen während einer Sitzung werden sofort auf der Festplatte gespeichert, erscheinen jedoch erst in der nächsten Sitzung im System Prompt.¹²

Was gespeichert werden sollte

Diese Informationen speichern (der Agent macht das proaktiv):¹² - Benutzerpräferenzen: „Ich bevorzuge TypeScript gegenüber JavaScript“ → user - Fakten zur Umgebung: „Dieser Server läuft mit Debian 12 und PostgreSQL 16“ → memory - Korrekturen: „Verwenden Sie für Docker-Befehle kein sudo; der Benutzer gehört zur Docker-Gruppe“ → memory - Konventionen: „Das Projekt verwendet Tabs, eine Zeilenbreite von 120 Zeichen und Docstrings im Google-Stil“ → memory - Abgeschlossene Arbeiten: „Datenbank am 2026-01-15 von MySQL nach PostgreSQL migriert“ → memory

Diese Informationen überspringen:¹² - Triviale oder offensichtliche Informationen - Fakten, die sich leicht erneut ermitteln lassen - Rohe Datendumps (zu groß für den Speicher) - Sitzungsspezifische Ephemera - Informationen, die bereits in Kontextdateien vorhanden sind

Sitzungssuche

Über MEMORY.md und USER.md hinaus kann der Agent mit dem Tool session_search seine vergangenen Unterhaltungen durchsuchen. Alle CLI- und Messaging-Sitzungen werden mit FTS5-Volltextsuche in SQLite (~/.hermes/state.db) gespeichert. Abfragen liefern relevante vergangene Unterhaltungen mit einer Zusammenfassung durch Gemini Flash.¹²

Externe Speicheranbieter

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

Externe Anbieter laufen parallel zum integrierten Speicher (und ersetzen ihn nie) und ergänzen Funktionen wie Wissensgraphen, 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 integrierte Speicher ist stets aktiv.⁶

Automatische Sitzungsfortsetzung (v0.13.0+)

v0.13.0 macht Unterbrechungen mitten in der Agentenarbeit überlebbar. Der gateway setzt unterbrochene Sitzungen nach einem Neustart automatisch fort; Neustarts über /update bewahren den Sitzungsstatus während des Upgrades; das Neuladen von Quelldateien während der Entwicklung hält die aktive Sitzung am Leben, statt eine neue zu erzwingen.¹⁸ Praktisch bedeutet das: Lang laufende gateway-Arbeiten und cron-gesteuerte Jobs verlieren beim Neustart des Prozesses nicht mehr ihr Kontextfenster.

Checkpoints v2 (v0.13.0+)

Die Zustandsspeicherung wurde in v0.13.0 als Single-Store-Design mit echtem Pruning, Festplattenleitplanken und keinen verwaisten Shadow-Repos neu geschrieben.¹⁸ Das vorherige Checkpoint-System sammelte bei lang laufenden profiles Zustand auf der Festplatte an; der v2-Store setzt der lokalen Checkpoint-Speicherung eine harte Obergrenze und entfernt die doppelte Buchführung, die dieses Wachstum verursachte. 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 Nr. 1 im System Prompt und ersetzt die fest codierte Standardidentität.¹³

Hermes erstellt automatisch eine Standarddatei SOUL.md unter ~/.hermes/SOUL.md (oder $HERMES_HOME/SOUL.md für benutzerdefinierte profiles). Vorhandene Benutzerdateien werden niemals überschrieben. Hermes lädt SOUL.md ausschließlich aus HERMES_HOME — das aktuelle Arbeitsverzeichnis wird nicht durchsucht. 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:¹³ - Tonfall - Kommunikationsstil - Grad der Direktheit - Standardinteraktionsstil - Stilistische Aspekte, die vermieden werden sollen - Umgang von Hermes mit Unsicherheit, Widerspruch und Mehrdeutigkeit

Weniger geeignet ist sie für:¹³ - Einmalige Projektanweisungen - Dateipfade - Repository-Konventionen - Temporäre Workflow-Details

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

SOUL.md vs. AGENTS.md

Dies ist die wichtigste Unterscheidung bei der Identitätsverwaltung von Hermes:¹³

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

AGENTS.md — Projektarchitektur, Codierungskonventionen, Tool-Präferenzen, Repository-spezifische Workflows, Befehle, Ports, Pfade und Hinweise zur Bereitstellung.

Eine hilfreiche Regel: Wenn es Ihnen überall folgen soll, gehört es in SOUL.md. Gehört es zu einem Projekt, gehört es in AGENTS.md.¹³

Integrierte Persönlichkeiten

Hermes enthält integrierte Persönlichkeiten, 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 dann mit /personality codereviewer.

SOUL.md vs. /personality

SOUL.md ist die grundlegende Stimme. /personality ist eine Überlagerung auf Sitzungsebene.¹³ Behalten Sie eine pragmatische Standarddatei SOUL.md bei und verwenden Sie dann /personality teacher für eine Nachhilfesitzung oder /personality creative für ein Brainstorming.

Nous Tool Gateway (v0.10.0+)

Seit Hermes Agent v0.10.0 (2026-04-16) erhalten zahlende Nous Portal-Abonnenten über ihre bestehenden Portal-Zugangsdaten verwalteten Zugriff auf eine kuratierte Auswahl an Tools — ohne zusätzliche API-Schlüssel verwalten zu müssen.³⁰ Der Hermes CLI selbst bleibt MIT-lizenziert und vollständig Open Source. Neu ist, dass Ihre Portal-Authentifizierung nun mehr als nur Modellinferenz freischaltet.

Was das Gateway umfasst

So funktioniert es

Das Gateway ist über ein neues Konfigurationsfeld use_gateway pro Tool optional aktivierbar. Wenn Sie Portal-Zugangsdaten in hermes auth hinterlegt und das Gateway für ein Tool aktiviert haben, werden die Aufrufe dieses Tools über Portal geleitet. Andernfalls wird Ihr direkter API-Schlüssel (falls vorhanden) verwendet.

# 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

Laufzeitpriorität: Wenn das Gateway verfügbar ist und für ein Tool use_gateway: true gesetzt wurde, bevorzugt Hermes das Gateway, selbst wenn Sie zusätzlich einen direkten API-Schlüssel konfiguriert haben. Das ist für die Abrechnung relevant — Gateway-Aufrufe werden Ihrem Nous Portal-Abonnement belastet, nicht dem Guthaben Ihres direkten API-Schlüssels.

Das Gateway aktivieren

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

Das Abonnement wird automatisch anhand der Portal-OAuth-Zugangsdaten erkannt, die Sie bereits in hermes auth hinterlegt haben — ein separater Anmeldeschritt ist nicht erforderlich. Seit v0.19.0 können Sie das Abonnement auch innerhalb einer Sitzung verwalten: /subscription zeigt Ihren Tarif und das verbleibende Kontingent an, zeigt genau vorab, was ein Upgrade kostet oder wann ein Downgrade wirksam wird, und wendet die Änderung mit Hinweisen zu geplanten Änderungen und einer Rückgängig-Option an; /topup fügt Guthaben hinzu. Die Desktop-App verfügt über einen entsprechenden Tab für die Abrechnungseinstellungen.²⁵

Preise und Zugriff

Preise und Tarifnamen werden auf der Nous Portal-Preisseite veröffentlicht (https://portal.nousresearch.com/pricing). Dieser Leitfaden führt keine Tarife auf, da sie in die Verantwortung des Portal-Produkts fallen, nicht des Hermes CLI, und sich unabhängig von Hermes-Releases ändern. Registrieren Sie sich unter https://portal.nousresearch.com/ und prüfen Sie die Preisseite auf aktuelle Tarife.

Hinweis zur Einstellung

• Die Umgebungsvariable HERMES_ENABLE_NOUS_MANAGED_TOOLS wurde in v0.10.0 entfernt. Verwaltete Tools werden nun über das Konfigurationsfeld use_gateway pro Tool aktiviert und durch den Status Ihres Portal-Abonnements gesteuert.³⁰

Einordnung: Was dieses Release nicht ist

Der Hermes Agent CLI ist nicht an ein Abonnement gebunden. Das Projekt ist weiterhin MIT-lizenziert, und alle Kernfunktionen (CLI, skills, memory, Messaging-Gateway, cron, MCP, lokales Dashboard, BYOK für jeden Anbieter) funktionieren Ende zu Ende, ohne dass Sie jemanden bezahlen müssen. v0.10.0 fügt einen bequemen Weg für Benutzer hinzu, die bereits für Nous Portal zahlen — es entfernt nichts vom kostenlosen Weg.

Messaging-Gateway

Hermes kann als langlebiger Gateway-Prozess ausgeführt werden, der 28 Messaging-Plattformen über einen einzigen Gateway-Prozess verbindet: 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 einen generischen Webhook-Adapter.^329171819 v0.9.0 fügte iMessage über BlueBubbles hinzu (automatische Webhook-Registrierung, Einrichtungsassistent, Absturzresistenz) sowie native WeChat-Unterstützung über iLink Bot API mit WeCom-Callback-Modus für Unternehmens-Apps.¹⁶ v0.11.0 fügte QQBot hinzu.²⁹ v0.12.0 fügte Microsoft Teams und Tencent Yuanbao hinzu.¹⁷ v0.13.0 fügte Google Chat als 20. Plattform hinzu, basierend auf derselben einsteckbaren Adapterarchitektur; IRC und Microsoft Teams wurden zudem auf das neue Adaptermuster mit generischen Plugin-Hooks env_enablement_fn / cron_deliver_env_var migriert.¹⁸ v0.14.0 fügt LINE und SimpleX Chat hinzu 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) fügt relay-freies iMessage über Photon Spectrum hinzu (Gerätecode-OAuth mit hermes photon login — kein Mac-/BlueBubbles-Relay erforderlich), den offiziellen WhatsApp Business Cloud API-Adapter (der die Anforderung eines Bridge-Prozesses ersetzt), 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.⁶

Wie Nachrichten fließen

Aus der Upstream-Architekturdokumentation:³

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 durchläuft 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 senden — der Plattformunterschied besteht nur am Rand.³

v0.19.0 fügt profilbasierte Nachrichtenweiterleitung und dauerhafte Zustellung hinzu. Ein einzelnes multiplexiertes Gateway, das einen Bot-Token teilt, kann bestimmte Guilds, Kanäle oder Threads an unterschiedliche profile weiterleiten — jeweils mit vollständig isolierter Konfiguration, skills, memory und secrets — mit einer Überschreibung durch GATEWAY_MULTIPLEX_PROFILES; zudem sorgt eine Härtungswelle dafür, dass ein falsch konfiguriertes Profil nicht mehr das gesamte Gateway außer Betrieb setzen kann. Intern wurde der Routing-Index nach state.db verschoben (sessions.json ist nun ein optionaler Legacy-Spiegel), und endgültige Antworten werden in einem dauerhaften Zustellverpflichtungs-Ledger rund um das Senden an die Plattform erfasst — eine abgeschlossene Antwort, die auf einen Gateway-Absturz trifft, wird beim nächsten Start erneut zugestellt, statt unbemerkt verloren zu gehen.²⁵

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 über seine Messaging-Plattform; Sie genehmigen ihn mit hermes pairing approve; anschließend ist er autorisiert.⁶

Geplante Aufgaben (Cron)

Hermes verfügt über ein erstklassiges Cron-System, bei dem Jobs Agent-Aufgaben und keine Shell-Befehle sind. Jeder geplante Job wird mit einem neuen AIAgent, dem konfigurierten Prompt und optional angehängten skills ausgeführt und stellt Ergebnisse an jede Plattform zu:³⁶

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 direkt im Gespräch 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 werden in JSON gespeichert 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"

Seit v0.19.0 werden MCP-Tools dem Modell gemäß der Namenskonvention mcp__server__tool bereitgestellt — jeder Tool-Name enthält seinen Servernamen, sodass zwei Server, die dasselbe Tool bereitstellen, nicht länger kollidieren — und MCP-Server-Log-Benachrichtigungen werden in agent.log angezeigt.²⁵

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

hermes mcp serve
hermes mcp serve -v    # Verbose

Kontextkomprimierung

Hermes komprimiert lange Unterhaltungen automatisch, um innerhalb des Kontextfensters Ihres Modells zu bleiben. Der Komprimierungs-Zusammenfasser ist ein separater LLM-Aufruf — Sie können ihn auf jeden Provider oder Endpunkt verweisen.⁴

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 zur Komprimierung den gesamten mittleren Abschnitt der Unterhaltung erhält.⁴

Warnungen bei Budgetdruck

Wenn der Agent an einer komplexen Aufgabe mit vielen Tool-Aufrufen arbeitet, kann er sein Iterationsbudget aufbrauchen (Standard: 500 Runden seit v0.20.0, zuvor 90), ohne dies zu bemerken. Bei Budgetdruck wird das Modell automatisch gewarnt:⁴

Stream-Timeouts

Die Streaming-Verbindung von LLM verfügt über zwei Timeout-Ebenen, die sich für lokale Provider (localhost, LAN-IP-Adressen) automatisch anpassen:⁴

Der Socket-Lese-Timeout wird für lokale Endpunkte auf 30 Minuten erhöht, weil lokale LLMs bei großen Kontexten vor der Ausgabe des ersten Tokens mehrere Minuten für das Prefill benötigen können.⁴

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 Ihren gateway, ohne Konfigurationsdateien oder das Terminal zu verwenden.¹⁶ Starten Sie es mit hermes dashboard. Dies ist der einfachste Onboarding-Weg 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 bei Übereinstimmung in Echtzeit benachrichtigt werden.¹⁶ Überwachen Sie Fehler, warten Sie auf bestimmte Ereignisse („listening on port“) oder verfolgen Sie Build-Protokolle — ganz ohne Polling. Zusammen mit notify_on_complete aus v0.8.0 (das über den Abschluss von Hintergrundaufgaben informiert) verfügt Hermes nun über eine vollständige Beobachtungsebene für Hintergrundprozesse.¹⁵

Austauschbare Context Engine (v0.9.0+)

Die Kontextverwaltung ist jetzt über hermes plugins als austauschbarer Slot verfügbar. Sie können benutzerdefinierte Context Engines einsetzen, die steuern, was der Agent in jeder Runde sieht — etwa durch Filterung, Zusammenfassung oder domänenspezifische Kontextinjektion.¹⁶ Dadurch wird die Kontextstrategie von der Kernschleife des Agenten entkoppelt und eine Kontextanpassung pro Projekt oder Domäne ermöglicht.

Backup & Wiederherstellung (v0.9.0+)

hermes backup erstellt ein vollständiges Archiv Ihrer Konfiguration, Sitzungen, skills und Erinnerungen. hermes import stellt diese aus einem Backup-Archiv wieder her.¹⁶ Nutzen Sie dies für Migrationen zwischen Geräten, Snapshots vor größeren Änderungen oder um eine bewährte Konfiguration mit Teammitgliedern 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.¹⁶

Sicherheits-Härtung (v0.13.0+)

v0.13.0 hat 8 P0-Sicherheitsprobleme geschlossen und einen Standardwert zugunsten des Benutzers geändert.¹⁸ v0.14.0 folgt mit weiteren 12 P0- und 50 P1-Schließungen, darunter Härtungen gegen sudo-Brute-Force und sudo-stdin, Korrekturen für Umgehungen gefährlicher Befehle, Bereinigung von Tool-Fehlern vor ihrer erneuten Einspeisung in das Modell, Dashboard-Plugin-API-Authentifizierung, SSRF-Abdeckung für den skills-hub sowie das Scannen von Supply-Chain-Hinweisen während der Installation.¹⁹

Wenn Sie eine Hermes-Bereitstellung betreiben, sollten Sie v0.13.0 und v0.14.0 als sicherheitsrelevante Upgrades und nicht nur als Funktionserweiterungen behandeln. v0.13.0 schließt die Discord-Cross-Guild-Umgehung und zwei TOCTOU-Fenster; v0.14.0 ergänzt eine weitere Härtungsrunde für die sudo-Behandlung, die erneute Einspeisung von Tool-Fehlern, Plugin-APIs, skills-hub-SSRF und Abhängigkeitswarnungen.

Architektur für Praktiker

Dieser Abschnitt richtet sich an Personen, die verstehen möchten, was unter der Haube passiert, damit sie Fehler beheben, Hermes erweitern oder die Performance einschätzen können. Er fasst die Upstream-Architekturdokumentation zusammen.³

Einstiegspunkte → AIAgent

Jeder Einstiegspunkt 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 angepasst.³

„47 Tools / 20 toolsets“ vs. „28 Tools“ in Ihrem Banner. Die Zahl „47 Tools“ entspricht dem gesamten Tool-Register des Upstream-Repositorys — also jedem Tool, für das Hermes Quellcode bereitstellt, über alle toolsets hinweg. Ihr tatsächlich laufendes CLI zeigt in seinem Startbanner eine kleinere Zahl an (die Installation, anhand derer ich diesen Leitfaden überprüft habe, meldet 28 tools / 89 skills). Das ist kein Fehler. Viele toolsets sind optional und müssen in config.yaml unter toolsets: ausdrücklich aktiviert werden — Adapter für Messaging-Plattformen, Browserautomatisierung, umfangreichere Scraping-Tools usw. Die Gesamtzahl im Register zeigt, „was verfügbar ist“; die Zahl im Banner zeigt, „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 über den Block toolsets: in ~/.hermes/config.yaml (oder innerhalb einer laufenden Sitzung mit /tools list / /tools enable <name> / /tools disable <name> — beim Entfernen eines Tools wird die Sitzung zurückgesetzt, damit der Agent sein Tool-Manifest neu erstellt).

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 Tupel aus (provider, model) für mehr als 18 Provider (api_mode, api_key, base_url) zu und verarbeitet dabei OAuth-Abläufe, Credential-Pools und Aliasauflö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

Aus der Upstream-Architekturseite.³

Reihenfolge der Prompt-Zusammenstellung

Der Prompt-Stack umfasst:¹³

1. SOUL.md (Agentenidentität — oder integrierter Fallback, falls nicht verfügbar)
2. Verhaltensempfehlungen mit Tool-Bezug
3. Speicher-/Benutzerkontext (MEMORY.md, USER.md)
4. Hinweise zu Skills
5. Kontextdateien (AGENTS.md, .cursorrules)
6. Zeitstempel
7. Plattformspezifische Formatierungshinweise
8. Optionale System-Prompt-Overlays wie /personality

SOUL.md bildet die Grundlage — alles andere baut darauf auf.¹³

Sitzungsspeicherung

SQLite-basierte Sitzungsspeicherung mit FTS5-Volltextsuche. Sitzungen verfügen über Abstammungsverfolgung (Eltern-/Kindbeziehungen über Komprimierungen hinweg), Isolation pro Plattform sowie atomare Schreibvorgänge mit Behandlung von Zugriffskonflikten.³

Plugin-System

Drei Erkennungsquellen: ~/.hermes/plugins/ (Benutzer), .hermes/plugins/ (Projekt) und pip-Einstiegspunkte. Plugins registrieren Tools, Hooks und CLI-Befehle über einen Kontext-API. Speicher-Provider 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

Aus der Upstream-Architekturseite:³

Migration von OpenClaw

Hermes Agent ist der Nachfolger von OpenClaw. Falls 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 die Legacy-Verzeichnisse ~/.clawdbot und ~/.moldbot) und schreibt nach ~/.hermes.⁶

Direkt importiert (mehr als 30 Kategorien): SOUL.md, MEMORY.md, USER.md, AGENTS.md, Skills aus 4 Quellverzeichnissen, Standardmodell, benutzerdefinierte Provider, MCP-Server, Tokens und Allowlists für Messaging-Plattformen (Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), Agent-Standardeinstellungen (Reasoning-Aufwand, Komprimierung, menschliche Verzögerung, Zeitzone, Sandbox), Richtlinien zum Zurücksetzen von Sitzungen, Genehmigungsregeln, TTS-Konfiguration, Browsereinstellungen, Tool-Einstellungen, exec-Timeout, Befehls-Allowlist, gateway-Konfiguration und API-Schlüssel aus 3 Quellen.⁶

Zur manuellen Prüfung archiviert: cron-Jobs, Plugins, Hooks/Webhooks, Speicher-Backend (QMD), Skills-Registry-Konfiguration, UI/Identität, Logging, Multi-Agent-Setup, Kanalbindungen, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md.⁶

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

Fehlerbehebung

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

Der erste Fehler, auf den jede frische Installation stößt: Hermes hat noch keinen aufgelösten Provider. Das bedeutet genau, was dort steht — keiner der drei Authentifizierungspfade hat einen nutzbaren Provider hervorgebracht. Führen Sie Folgendes aus:

hermes model

Die interaktive Auswahl führt durch jeden unterstützten Provider, einschließlich der OAuth-Gerätecode-Flows (Nous Portal, GitHub Copilot, Anthropic, OpenAI Codex) und benutzerdefinierter Endpoints für selbst gehostete Server. Wenn Sie erwartet haben, dass bereits ein Provider konfiguriert ist, zeigt hermes doctor, welche Zugangsdaten Hermes tatsächlich sehen kann. Die üblichen Ursachen sind ein an der falschen Stelle hinterlegter API-Schlüssel (er gehört in .env oder wird über hermes config set gesetzt, nicht in Ihr Shell-Profil), abgelaufene OAuth-Zugangsdaten in ~/.hermes/auth.json oder ein benutzerdefinierter Endpoint in config.yaml, dessen base_url verloren gegangen ist. Die Authentifizierungspfade werden in Authentication & Providers ausführlich behandelt.²⁷

„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-Endpoint Ihres Servers, doch viele lokale Server melden niedrige Standardwerte. Legen Sie sie explizit in config.yaml 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 Implementierung des Servers nicht.²

Antworten werden mitten im Satz abgeschnitten

Dafür gibt es zwei mögliche Ursachen:²

1. Niedrige Ausgabelimitierung (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. Kontexterschöpfung — 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:²

Gespiegelte Netzwerkverbindung (Windows 11 22H2+): Bearbeiten Sie %USERPROFILE%\.wslconfig:

[wsl2]
networkingMode=mirrored

Führen Sie anschließend wsl --shutdown aus und starten Sie neu. Danach funktioniert localhost bidirektional.

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

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

Der Modellserver muss außerdem an 0.0.0.0 statt an 127.0.0.1 gebunden werden — 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 befindet sich alles?

hermes status und hermes dump helfen Ihnen hier weiter. hermes logs list zeigt alle Logdateien mit ihren Größen an. hermes config path gibt den Speicherort der Konfigurationsdatei aus. hermes config env-path gibt den Speicherort von .env aus.⁶

FAQ

Was ist der Unterschied zwischen Hermes Agent und Claude Code?

Claude Code ist der offizielle CLI von Anthropic, 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 Endpoint.¹² Hermes bringt zudem ein Messaging gateway für Telegram/Discord/Slack/WhatsApp/Signal mit, das Claude Code nicht bietet.

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

Ja. Auf drei Arten:²

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, sofern verfügbar, den Zugangsdaten-Speicher von Claude Code.
3. Setzen Sie als Fallback einen manuellen ANTHROPIC_TOKEN (Setup-Token oder OAuth-Token).

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

Wie wechsle ich Provider, ohne meine Unterhaltung zu verlieren?

Verwenden Sie innerhalb einer Sitzung /model provider:model. Der Unterhaltungsverlauf, der Speicher und die skills werden vollständig übernommen:⁹

/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 stoßen auf den Fallback für Hilfsmodelle. Vision, Web-Zusammenfassungen, Komprimierung und andere Nebenaufgaben verwenden ein separates Hilfs-LLM — standardmäßig Gemini Flash über die automatische Erkennung (OpenRouter → Nous → Codex). Wenn keines davon konfiguriert ist und Sie nur Anthropic eingerichtet haben, verschlechtern sich diese Funktionen unbemerkt.⁴

Lösung: Fügen Sie entweder einen OPENROUTER_API_KEY für Hilfsaufgaben hinzu oder konfigurieren Sie die Hilfsslots neu, damit sie Ihren primären Provider verwenden. Beachten Sie, dass die Kontextkomprimierung in ihrem eigenen compression:-Block der obersten Ebene liegt und summary_provider erwartet, nicht auxiliary.compression.provider — der Slot auxiliary.compression stellt lediglich ein timeout bereit. Vollständige Lösung:

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

compression:
  summary_provider: "main"

Was ist der Unterschied zwischen SOUL.md und AGENTS.md?

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

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

Profile. Jedes Profil erhält sein eigenes HERMES_HOME, seine eigene Konfiguration, seinen 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 Endpoints. Hermes funktioniert mit jedem OpenAI-kompatiblen Server: Ollama, vLLM, SGLang, llama.cpp/llama-server, LM Studio, LocalAI, Jan oder Ihrem eigenen.² Eine serverbezogene Einrichtung finden Sie unter Custom & Self-Hosted Endpoints.

Warum zeigt mein Startbanner weniger Tools an, als laut Guide in Hermes enthalten sind?

Der Guide nennt 47 Tools / 20 toolsets aus der Upstream-Architekturregistrierung — das ist die Gesamtzahl der Tools, für die Hermes über alle toolsets hinweg Quellcode bereitstellt. Ihre laufende Installation zeigt im Banner eine kleinere Zahl an (die für diesen Guide 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 unter toolsets: in ~/.hermes/config.yaml ausdrücklich aufgeführt werden, bevor sie geladen werden. Gesamtzahl der Registrierung = „was verfügbar ist, wenn Sie es aktivieren.“ Gesamtzahl im Banner = „was Ihr aktuelles Profil tatsächlich geladen hat.“ Verwenden Sie hermes tools --list, um zu sehen, welche toolsets aktiv sind und welche verfügbar, aber deaktiviert sind. Schalten Sie einzelne toolsets zur Laufzeit mit /tools enable <name> und /tools disable <name> um (das Deaktivieren löst ein Zurücksetzen der Sitzung aus, damit der Agent sein Tool-Manifest mit der neuen Struktur neu erstellt).

Wie behandelt Hermes einen Modell-Fallback, wenn mein primärer Provider ausfällt?

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

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

Wenn das primäre Modell ausfällt (Rate Limit, Serverfehler, Authentifizierungsfehler), wechselt Hermes mitten in der Sitzung zum Fallback, ohne den Unterhaltungsverlauf zu verlieren. Dies geschieht höchstens einmal pro Sitzung.

Kann der Agent seine eigenen skills mit der Zeit verbessern?

Ja — das ist der „selbstverbessernde“ Teil von Hermes Agent. Der Agent kann über das Tool skill_manage skills erstellen, aktualisieren und löschen. Wenn er einen nicht trivialen Workflow herausfindet, speichert er den Ansatz als skill für die spätere Wiederverwendung.¹¹ Der Agent erstellt skills nach komplexen Aufgaben (5+ Tool-Aufrufe), wenn er auf Fehler stößt und 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 ausgeführt werden:⁶

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

Änderungsprotokoll

Referenzen