Hermes Agent: Das Praxishandbuch (2026)

Kurzfassung: Hermes Agent ist ein selbstoptimierender Open-Source-KI-Agent von Nous Research. Er läuft als CLI und als plattformübergreifendes Messaging-gateway, speichert eine dauerhafte Identität und einen persistenten Speicher auf der Festplatte, bündelt skills, die sich durch ihre Nutzung verbessern, und funktioniert mit jedem OpenAI-kompatiblen LLM-Anbieter — Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Qwen Cloud, Hugging Face, Google, xAI/SuperGrok oder Ihrem eigenen selbst gehosteten Endpunkt.¹²¹⁹ Die aktuelle Version ist v0.21.7 (Tag v0.21.7, 11. Oktober 2026), der fünfte kumulative Patch der v0.21-Reihe und der erste, bei dem sämtliche Kanäle über die neue Stable-Release-Pipeline des Projekts ausgeliefert werden; Neuerungen in v0.21.7 erläutert die Änderungen, anschließend sind die Versionsabschnitte vom neuesten zum ältesten geordnet.⁵⁶ Die größte Hürde für die meisten neuen Benutzer ist die Anbieterauthentifizierung: Beim Tag v0.21.6 enthält Hermes 39 Anbieter in seiner statischen Auswahlliste und erweitert diese automatisch anhand von 41 mitgelieferten Anbieter-Plugins sowie benutzerdefinierten Endpunkten. Dazu kommen drei unterschiedliche Authentifizierungswege (API-Schlüssel in .env, OAuth über hermes model oder ein benutzerdefinierter Endpunkt in config.yaml).⁵³⁵⁵ Mit dem Authentifizierungsmodell sollten Sie sich zuerst vertraut machen — alles Weitere hängt davon ab, welcher Anbieter aufgelöst wird.

Hermes Agent arbeitet als vollständige Agentenlaufzeit, nicht als Chat-Wrapper. Er liest Ihr Dateisystem, führt Befehle in Sandbox-Backends aus, extrahiert Inhalte aus dem Web, startet Subagenten, führt geplante cron-Jobs aus, kommuniziert über einen einzigen gateway-Prozess mit Telegram/Discord/Slack/WhatsApp/Signal/Email und erstellt aus Erfahrungen eigene skills.¹ Die CLI ist eine Terminal-Benutzeroberfläche, die auf einer Konversationsschleife in run_agent.py aufbaut; das gateway ist ein dauerhaft laufender Prozess, der Nachrichten von Messaging-Plattformen durch dieselbe Konversationsschleife leitet.³

Der Unterschied zwischen gelegentlicher und professioneller Hermes-Nutzung beruht auf fünf Systemen. Wenn Sie diese beherrschen, wird Hermes zum Kraftmultiplikator:

1. Anbieterauflösung: wie Authentifizierungsabläufe API-Aufrufen zugeordnet werden
2. Konfigurationshierarchie: config.yaml + .env + auth.json + SOUL.md + AGENTS.md
3. Tool- und toolset-System: welche Aktionen der Agent ausführen kann, mit plattformspezifischen Beschränkungen
4. Skills-System: prozeduraler Speicher, den der Agent erstellt und weiterentwickelt
5. Gateway + cron + profiles: Hermes dort ausführen, wo Sie arbeiten, nicht nur dort, wo Sie sich gerade befinden

Wichtigste Erkenntnisse

• Für die Anbieterauthentifizierung gibt es drei Wege, nicht nur einen. API-Schlüssel in .env, OAuth über hermes model/hermes auth oder ein benutzerdefinierter Endpunkt in config.yaml. Wählen Sie den Weg, der zu Ihrem Anbieter passt, nicht den, der Ihnen vertraut erscheint.
• Ein Anbieterwechsel erfordert nur einen einzigen Befehl. hermes model führt Sie interaktiv durch alle unterstützten Anbieter einschließlich OAuth-Anmeldungen, und mit /model provider:model wechseln Sie während einer Sitzung, ohne den Verlauf zu verlieren.²
• Zwei Dateien bilden die vom Benutzer bearbeitbare Konfigurationsoberfläche. ~/.hermes/config.yaml enthält Einstellungen und ~/.hermes/.env Geheimnisse. auth.json, SOUL.md, MEMORY.md und skills/ werden direkt von Hermes verwaltet — Sie können SOUL.md manuell bearbeiten, die übrigen Elemente werden jedoch vom Agenten selbst verändert.⁴
• Hermes ist der Nachfolger von OpenClaw. Wenn Sie migrieren, importiert hermes claw migrate automatisch mehr als 30 Kategorien von Zustandsdaten.⁵
• Hilfsaufgaben verwenden standardmäßig Ihr Hauptmodell. Bilderkennung, Genehmigungsklassifizierung, Komprimierung und Sitzungstitel werden als separate „auxiliary“-LLM-Aufrufe ausgeführt. Beim Tag leitet auto sämtliche Aufrufe an Ihr primäres Chatmodell weiter – Sie müssen nichts konfigurieren, doch bei teuren Reasoning-Modellen verursachen diese Nebenaufgaben erhebliche Zusatzkosten. Weisen Sie einzelne auxiliary.<task>-Slots günstigen, schnellen Modellen zu, wenn dies relevant ist.⁴³⁴

Jeder folgende Abschnitt stützt sich auf die Upstream-Dokumentation unter hermes-agent.nousresearch.com/docs und den Quellbaum unter github.com/NousResearch/hermes-agent. Jede Tatsachenbehauptung enthält eine Fußnote, die auf die jeweilige Upstream-Seite verweist.

Wählen Sie Ihren Weg

So funktioniert Hermes: das mentale Modell

Hermes basiert auf einer einzigen Konversationsschleife, die von jedem Einstiegspunkt aufgerufen werden kann. Zu den Einstiegspunkten gehören die CLI (cli.py), der Messaging-gateway (gateway/run.py), der ACP-Adapter für die Editorintegration, der Batch-Runner und ein API-Server.³ Letztlich rufen sie alle AIAgent.run_conversation() in run_agent.py auf. Diese Methode:

1. Erstellt über agent/prompt_builder.py den System-Prompt aus SOUL.md, MEMORY.md, USER.md, skills, Kontextdateien und Tool-Anleitungen (bei der Aufteilung im September 2026 wurde sie in das neue Paket agent/ verschoben)³
2. Bestimmt über runtime_provider.py den Laufzeit-Provider — in diesem Schritt werden Ihre Authentifizierung, die Basis-URL und der API-Modus ausgewählt³
3. Ruft den Provider 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, weil jede Funktion — Persönlichkeiten, Speicher, skills, Komprimierung und Fallback — an eine dieser Phasen anknüpft. Wenn Sie einen Konfigurationsschlüssel sehen und sich fragen, was er bewirkt, lautet die Antwort meist: „Er steuert Phase 1, 2, 3 oder 4 der oben beschriebenen Schleife.“

Plattformunabhängiger Kern. Eine einzige AIAgent-Klasse dient der CLI, dem gateway, ACP, Batch-Verarbeitung und dem API-Server. Plattformspezifische Unterschiede befinden sich im Einstiegspunkt, nicht im Agenten selbst.³ Deshalb funktionieren dieselben Slash-Befehle im Terminal und 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.

Neu in v0.21.7 (die Zusammenfassung vom 11. Oktober)

Hermes Agent v0.21.7 (Tag v0.21.7, datiert auf den 11. Oktober 2026 und veröffentlicht am 12. Oktober) ist die aktuelle Version und die fünfte schlanke Sammelversion der v0.21.x-Reihe. Anders als v0.21.6, das nur den Tag und das Docker-Image bereitstellte, deckt diese Version alle Kanäle ab: die Desktop-App (macOS auf Apple silicon und Windows), die Builds für den Microsoft Store und MSIX, das Installationsprogramm, Docker und Hermes Cloud. Seit v0.21.6 umfasst sie „740 Nicht-Merge-Commits“ in „4.156 geänderten Dateien“, „204 zusammengeführte PRs“ und „69 geschlossene Issues“ (der Vergleich auf GitHub zählt einschließlich Merges 777 Commits). Kuratierte Hinweise werden erneut auf v0.22.0 verschoben. Folgende Änderungen sind in der Version dokumentiert und im Quellcode des Tags geprüft:⁵⁶⁵⁷

• Quellcodeinstallationen folgen jetzt getaggten Versionen. hermes update wechselt in einem Checkout des offiziellen Repositorys zur neuesten veröffentlichten Version vX.Y.Z und deren exaktem Commit, statt jedem Commit auf main zu folgen. Eine Installation, die der neuesten Version bereits voraus ist, bleibt bis zur nächsten Version auf ihrem aktuellen Stand. Zudem setzt der Resolver einen Checkout bei unklarer Lage nie aufgrund einer Vermutung zurück: Ist die Beziehung unbekannt (flache Historie, GitHub nicht erreichbar), bleibt HEAD unverändert. Um weiterhin jedem Commit zu folgen, führen Sie hermes update --set-channel main aus; --channel <name> überschreibt die Auswahl für einen einzelnen Lauf (stable und canary wählen veröffentlichte Versionen, main die Branch-Spitze). Die Auswahl wird für jede Installation unter update.installs in config.yaml gespeichert. Als Schlüssel dient eine aus dem Installationspfad abgeleitete ID (hermes update --install-id zeigt sie an), da ein einziges ~/.hermes gleichzeitig eine Host-Installation, ein Docker-gateway und die Desktop-App bedienen kann. Forks, Mirrors und Ursprünge mit lokalen Pfaden folgen weiterhin main; Store-, MSIX- und gebündelte Desktop-Installationen bleiben unverändert.
• Die Desktop-App bietet denselben Schalter. Unter Einstellungen ▸ Info ▸ Updates gibt es für Quellcodeinstallationen nun die Zeile Update-Kanal („Stabile Versionen“ oder „Jeder Commit“); außerdem zeigt der Aktualisierungsdialog den aktuell verwendeten Kanal an.
• Reasoning bleibt beim Fortsetzen erhalten. Signierte Thinking-Blöcke werden nach hermes chat --resume sowie beim nächsten gateway-Durchlauf erneut übermittelt, sofern der Upstream sie verifiziert. Außerdem lehnen Reasoning-Modelle mit Bedrock Converse fortgesetzte Sitzungen nicht mehr ab. Wird eine Signatur vom Upstream abgelehnt, erhält sie einen Fingerabdruck und wird aus neu erstellten Anfragen herausgefiltert, statt die Sitzung zu unterbrechen.
• Updates schlagen hinter bestimmten Firewalls nicht mehr fehl. Installationen auf main rufen keinen Versionsdatensatz mehr ab, den regionale Firewalls mit 403 beantworten. Bei der Stable-Prüfung wird Ihr GitHub-Token verwendet, sofern einer festgelegt ist (GITHUB_TOKEN oder gh auth login). Wird der Token abgelehnt, erfolgt ein anonymer Wiederholungsversuch. Ein GitHub-Ratenlimit wird außerdem als Ratenlimit gemeldet und nicht mehr als „keine Version“.
• Holographic verlässt den Kernbestand. Als integrierte Speicher-Provider verbleiben nur ByteRover und RetainDB; Holographic wird aus dem Plugin-Katalog installiert (Community-Stufe, requires_hermes: ">=0.21.5"), und die automatische Migration berücksichtigt es wie die anderen sechs. Siehe Externe Speicher-Provider.
• Der Plugin-Katalog ist von 493 auf 552 Einträge gewachsen, darunter laut Versionshinweisen memory-shield, command-ledger, Memoria, Model Router, wyoming-voice-bridge, codex-account-switch und redline. Die Provider-Plugins bleiben bei 41 Verzeichnissen und die statische Auswahl bei 39 Zeilen.
• Ebenfalls laut Versionshinweisen: Plugins können integrierte Desktop-Aktionen ausführen (ctx.runAction, beispielsweise view.showBrowser) und über die Sprechblase des Pets kommunizieren (ctx.pet.say); Codex-Anfragen werden vom Kern gestellt, sodass Plugins den Token nie erhalten; ein während einer Sitzung installiertes skill erreicht das Modell ohne Neuaufbau des Prompts; Krea 2 Medium Turbo ist für neue zahlende Abonnenten der standardmäßige Bildkanal, mit einem FAL-Fallback, wenn das verwaltete Krea eine Anfrage ablehnt; Desktop-Updates sind schneller; angeheftete Installationen checken nur den Pin aus; und Komprimierungsmarkierungen werden an Relay ausgegeben (agent/relay_compaction.py erzeugt hermes.compaction-Datensätze als NeMo-Relay-Markierungen).

Aktualisierung: Die Desktop-App aktualisiert sich selbst, Store-Installationen werden über den Store aktualisiert; für die CLI verwenden Sie hermes update oder den Einzeiler des Installationsprogramms; Docker und Hermes Cloud laden nousresearch/hermes-agent:stable (oder :latest).⁵⁶

Neuerungen in v0.21.6 (Das Rollup vom 8. Oktober)

Hermes Agent v0.21.6 (Tag v0.21.6, 8. Oktober 2026) war vom 8. bis zum 11. Oktober die aktuelle Version, das vierte schlanke Rollup der v0.21.x-Reihe und die erste Veröffentlichung über die neue Stable-Release-Pipeline des Projekts: „eine Attempt-Ref, ein getestetes Docker-Image und ein Receipt-Tag bei der Veröffentlichung“. Ausgeliefert werden ausschließlich der Tag, das GitHub-Release und das Docker-Image; die Desktop-App, die Termux-Pakete und der Microsoft-Store-Build behalten bis zum nächsten gebündelten Release ihre aktuellen Versionen. Das Zeitfenster seit v0.21.5 ist das bislang größte: „8.867 Non-Merge-Commits“ in „8.342 geänderten Dateien“, „2.106 zusammengeführte PRs“ und „3.027 geschlossene Issues“ (der GitHub-Vergleich zählt einschließlich Merges 9.180 Commits). Kuratierte Hinweise werden erneut auf v0.22.0 verschoben. Das Release führt auf, was nicht dokumentiert wird; jeder nachfolgende Punkt wurde im Quellcode am Tag überprüft:⁵⁴⁵⁵

• Live-Transkription während des Sprechens. Mit stt.streaming: true wird partieller Text bereits während einer Äußerung auf dem CLI, in der TUI und auf dem Desktop gestreamt. Die Funktion ist standardmäßig deaktiviert, arbeitet mit den STT-Anbietern openai, xai und elevenlabs (stt.streaming_model bezeichnet das eine Modell mit Deltas während der Äußerung, bei OpenAI gpt-live-transcribe) und greift bei einem Streaming-Fehler auf den Dateipfad zurück.
• Sprachinteraktionen erhalten einen eigenen Modellplatz. auxiliary.voice_chat leitet eine gesprochene Interaktion (CLI-Spracheingabe, eine Sprachkonversation auf dem Desktop oder in der TUI, eine Sprachnachricht in einem Messaging-Dienst) an ein schnelleres Modell als das Hauptmodell der Sitzung weiter, standardmäßig mit reasoning_effort: none. Das Routing wird nach dem Aufbau des System-Prompts gebunden und vor der Speichersynchronisierung sowie der Hintergrundüberprüfung wieder aufgehoben. Eine Interaktion, die den Komprimierungsschwellenwert des Sprachmodells überschreiten würde, verbleibt beim Hauptmodell. Siehe Hilfsmodelle.
• Drittanbieter-Plugins können außerhalb des Prozesses ausgeführt werden. plugins.isolation: host (Standardwert: in_process) lädt allgemeine Plugins in einem Plugin-Host-Prozess pro profile und verweigert jeden anderen Pfad, über den Benutzercode innerhalb des Prozesses importiert würde (Kategorieanbieter, Modellanbieter-profile, Dashboard-Plugin-APIs); gebündelte Plugins verbleiben innerhalb des Prozesses. Wenn ein Plugin hängen bleibt oder abstürzt, fällt sein Host aus, nicht das gateway. Siehe Plugin-System.
• Vier weitere Speicheranbieter verlassen den Kern-Quellbaum. Honcho, Mem0, OpenViking und Supermemory werden nun aus dem Plugin-Katalog installiert (Community-Stufe, gepflegt von ihren jeweiligen Anbietern) und folgen damit Hindsight; zum gebündelten Angebot gehören ByteRover, Holographic und RetainDB. Die mit v0.21.5 eingeführte automatische Migration deckt alle acht Namen ab. Siehe Externe Speicheranbieter.
• Die Plugin-Kompatibilitätsschicht wurde entfernt. hermes_cli/plugin_compat.py ist nur noch ein inaktiver Stub, COMPAT_MANIFEST.md und die Shims wurden gelöscht und plugins.allow_deprecated_imports existiert nicht mehr; ein Plugin, das weiterhin einen Pfad aus der Zeit vor der Aufteilung importiert, kann nicht importiert werden. Siehe Plugin-System.
• hermes status beginnt mit einer Zusammenfassung. Die Standardausgabe enthält eine Zeile pro Komponente; --full (Alias --all) gibt sämtliche Abschnitte aus und --deep führt die langsamen Prüfungen aus. In den Versionshinweisen wird außerdem ein Flag namens --short erwähnt; der Parser am Tag kennt dieses nicht, da die Zusammenfassung bereits der Standard ist.
• Erweiterbare, mehrschichtige Sprachpakete. display.language akzeptiert jede ID, die von den gebündelten Katalogen (17 am Tag), dem Overlay-Verzeichnis des profile oder einem Plugin-Sprachpaket bereitgestellt wird. hermes config set display.language <id> erkennt zunächst die Plugins, sodass ein gerade installiertes Paket akzeptiert wird. Core- und TUI-Zeichenfolgen werden in getrennten Schichten ausgeliefert (locales/<lang>.yaml und locales/<lang>.tui.yaml, am Tag 16 TUI-Pakete). Siehe Lokalisierung.
• Drei neue Anbieter-Plugins: lmstudio, solstice und tencent-tokenhub erhöhen die Zahl der Verzeichnisse unter plugins/model-providers/ von 38 auf 41; die statische Auswahlliste bleibt bei 39 Zeilen. Die Auswahlmenüs von Nous und OpenRouter ergänzen GPT-6.1 Sol (mit einer -pro-Variante), Claude Sonnet 5.5 und Claude Haiku 5.5; die Listen von openai-api und Bedrock ergänzen GPT-6.1 Sol. Lokale Modelle: hermes model listet Modelle von Ollama, LM Studio und Ollama Cloud direkt auf, und die gebündelte lokale Laufzeitumgebung ergänzt llama.cpp-CUDA-Builds (llamacpp-cuda), laut Release unter Linux für x64 und arm64.
• Die Genehmigungsregeln erhalten zwei neue Erkennungsmechanismen. Ein Upload mit curl oder wget (-d, -F, -T), der eine nach einem Geheimnis benannte Variable oder eine Anmeldedatendatei überträgt, sowie eine solche Datei, die über eine Pipe an einen Upload übergeben wird, werden als mögliche Datenexfiltration gekennzeichnet. Ein unsichtbares oder bidirektionales Unicode-Steuerzeichen in einem Befehl wird als mögliche Verschleierung markiert, da sich der genehmigte Befehl von dem tatsächlich ausgeführten unterscheiden könnte.
• Cron übersteht einen nicht beschreibbaren Speicher. Bei einer vollen Festplatte oder einem schreibgeschützten Mount (ENOSPC, EROFS, EACCES) stuft das System den cron-Speicher einmalig herab, statt bei jedem 60-Sekunden-Takt zu warnen, prüft höchstens einmal pro Minute erneut und meldet den Zustand über hermes cron status und hermes doctor (das Release ergänzt außerdem eine Warnung im Hauptkanal).
• Die Discord-Einrichtung prüft das Bot-Token und gibt den Einladungslink aus – einschließlich der vom Adapter benötigten Berechtigungsbits. Außerdem weist sie ausdrücklich auf ein weiterhin deaktiviertes Message Content Intent hin, da Discord die Verbindung des Bots andernfalls ablehnt. Siehe Messaging-gateway.
• Außerdem: activate.fish, das fish-Gegenstück zum Entwicklungsumgebungs-Skript ./activate; laut Versionshinweisen eine vereinheitlichte Kanban-Workflow-Definition; sowie Funktionen, die im Release aufgeführt sind, aber nicht mit dem Desktop-Build dieser Version ausgeliefert werden: favorisierte und angeheftete Modelle am Anfang der Desktop-Auswahl, ein Nutzungschip, bevor ein Abonnement sein Limit erreicht, Hinweise zu Ratenbegrenzungen der Anbieter mit Grund und Endzeitpunkt, eine Auswahl des Diff-Umfangs im Überprüfungsbereich und eine Keep-awake-Funktion, die der Interaktion folgt.

Sicherheitskorrekturen, die im Release alle mit Quellenangabe aufgeführt werden: vier von Tenable Research gemeldete Probleme bei der Dashboard-Authentifizierung (ein gefälschter X-Forwarded-For-Header konnte die Ratenbegrenzung der Passwortanmeldung zurücksetzen und die Obergrenze pro IP umgehen; nicht authentifizierte Anmeldeanfragen konnten unbegrenzt große Werte in das Authentifizierungs-Auditprotokoll schreiben; die öffentlichen /auth/-Routen hatten keine Begrenzung der Body-Größe; und die native Anmeldung konnte Anmeldecodes an eine Nicht-Loopback-Weiterleitung senden, was die Übernahme einer Sitzung ermöglichte); automatische git-Aufrufe (Snapshots des Sitzungsarbeitsbereichs, Subagent-Worktrees, Kanban, Worktree-Bereinigung, hermes -w) konnten vor dem ersten Prompt die in der eigenen Konfiguration eines nicht vertrauenswürdigen Repositorys definierten Filterprogramme clean, smudge oder process ausführen und verweigern den Vorgang nun, wenn sich die Filter nicht neutralisieren lassen; außerdem konnte ein in Anführungszeichen gesetzter Anzeigename in einem From-Header einer E-Mail die E-Mail-Zulassungsliste als erlaubter Absender passieren – dieser wird nun nach dem Entfalten mit parseaddr geparst (GHSA-rxqh-5572-8m77). Behandeln Sie diesen Tag bei jeder Dashboard-, gateway- oder E-Mail-Bereitstellung als sicherheitsrelevantes Upgrade.⁵⁴⁵⁵

Aktualisierung: hermes update oder der einzeilige Installer-Befehl; Docker und Hermes Cloud laden nousresearch/hermes-agent:stable (oder :latest).⁵⁴

Neuerungen in v0.21.5 (Das Rollup vom 24. September)

Hermes Agent v0.21.5 (Tag v2026.9.24, 24. September 2026) war vom 24. September bis zum 8. Oktober die aktuelle Version und das dritte schlanke Rollup der v0.21.x-Reihe: „Dieser Tag bündelt die seit v0.21.4 zusammengeführten rund 460 PRs in einem stabilen, getaggten Release für nachgelagerte Verbraucher“. Kuratierte Hinweise werden erneut auf v0.22.0 verschoben. Die für Betreiber relevanten Änderungen wurden im Quellcode am Tag überprüft:⁵²⁵³

• Der Hindsight-Speicher verlässt den Kern-Quellbaum. Der gebündelte Hindsight-Anbieter und das pip-Extra hermes-agent[hindsight] wurden entfernt; Hindsight wird nun aus dem Plugin-Katalog installiert und von Vectorize gepflegt; in den Versionshinweisen wird dies nicht erwähnt. Wenn Ihre Konfiguration memory.provider: hindsight festlegt, installiert hermes update das Katalog-Plugin in jedem profile-Stammverzeichnis, in dem es genannt wird. Fehlt es weiterhin, wird es beim ersten Start des Agenten installiert, sofern security.allow_lazy_installs nicht auf false gesetzt ist (führen Sie in diesem Fall hermes plugins install hindsight aus). Einstellungen, .env-Schlüssel und Speicherdaten bleiben unverändert. Siehe Externe Speicheranbieter.
• gateway.multiplex_profiles: false wird nicht mehr unterstützt. Das gateway schreibt die Einstellung direkt in true um und zeigt einmalig einen eingerahmten Hinweis an. Ein benanntes profile, das ein eigenes gateway beibehalten muss, setzt in seiner eigenen config.yaml die Option gateway.standalone: true; um ein bereitgestelltes profile offline zu nehmen, parkt hermes -p <name> gateway stop dieses nun, ohne den Host anzuhalten. Siehe Messaging-gateway.
• Neue Modelle in den Auswahlmenüs von Nous und OpenRouter: GPT-6 Sol und GPT-6 Luna (jeweils mit einer -pro-Variante) sowie Claude Opus 5.5.
• Die Plugin-Kompatibilität war bei diesem Tag unverändert: plugins.allow_deprecated_imports: true funktionierte weiterhin. v0.21.6 entfernt die Schicht und den Schlüssel (siehe Neuerungen in v0.21.6).

Aktualisierung: hermes update oder der einzeilige Installer-Befehl; die Images von Docker und Hermes Cloud werden aus nousresearch/hermes-agent:v2026.9.24 erstellt.⁵²

Neuerungen in v0.21.4 (der zweite Rollup-Patch)

Hermes Agent v0.21.4 (Tag v2026.9.21, 21. September 2026) ist das zweite bewusst schlank gehaltene Rollup der v0.21.x-Reihe. Die eigene Beschreibung lautet: „Patch-Release. Dieser Tag bündelt die seit v0.21.3 zusammengeführten rund 1.800 PRs zu einem stabilen, mit einem Tag versehenen Release für nachgelagerte Nutzer (Docker-Images, Hermes Cloud, gehostete Bereitstellungen).“ Der Zeitraum seit v0.21.3 umfasst „5.071 Non-Merge-Commits“ in „5.169 geänderten Dateien“, „1.812 zusammengeführte PRs“ und „2.116 geschlossene Issues“. Gemessen an der Commit-Anzahl ist dies der zweitgrößte Zeitraum zwischen zwei Tags in der Projektgeschichte, nur übertroffen von den 5.139 Commits in v0.21.1; gemessen an den zusammengeführten PRs ist es der größte. Die kuratierte Darstellung wird erneut aufgeschoben, wörtlich: „Die vollständigen kuratierten Release Notes für diesen Zeitraum erscheinen mit v0.22.0 und dokumentieren alles ab v0.21.0“ und „Nichts aus diesem Zeitraum wird ausgelassen.“ Die Mitteilung führt allerdings auf, was sie nicht dokumentiert. Jeder der folgenden Punkte wurde im Quellcode des Tags überprüft; wenn ein Punkt einen bestehenden Abschnitt dieses Leitfadens betrifft, ist der Verweis direkt eingefügt.⁵⁰⁵¹

• Ein gateway pro Host, und Desktop verbindet sich, statt einen neuen Prozess zu starten. Vorgesehen sind ein hermes serve und ein hermes gateway run pro Host und OS-Benutzer, die jeweils sämtliche profile bündeln. Durchgesetzt wird dies über eine neue hostweite Singleton-Ebene: eine für die gesamte Laufzeit des erfolgreichen Prozesses gehaltene Host-Sperre sowie ein Rendezvous-Datensatz mit (pid, createTime). Dadurch kann ein zweiter Aufruf nachweisen, dass der Eigentümer derselbe aktive Prozess ist, und sich mit ihm verbinden, statt einen zweiten Port zu belegen. Veraltete Zustände werden nachgewiesen, niemals lediglich angenommen. Die Desktop-App wendet dasselbe Prinzip auf ihrer Seite an und verbindet sich mit dem laufenden Host-Backend, statt ein zweites zu starten. Unter Messaging Gateway finden Sie die technischen Einzelheiten.⁵¹
• Connectors werden zu einem einzigen, vom Backend verwalteten Vorgang mit einer einheitlichen Einrichtungskarte. Ein manage_connections-tool-Aufruf steuert im Backend eine rein datenbasierte Zustandsmaschine für Verbindungen. Desktop, TUI und CLI stellen sie alle als dieselbe Einrichtungskarte dar: ein Feld je fehlendem Zugangsdatenwert, wobei die Aktion der Karte erst freigegeben wird, wenn jedes erforderliche Feld Text enthält. Weitere Informationen finden Sie im Unterabschnitt zur kostenlosen Nous-Stufe.⁵¹
• --format stream-json: maschinenlesbare Einzeldurchläufe. hermes chat -q ... --format stream-json gibt für CI-Runner und Orchestratoren ein JSON-Objekt pro stdout-Zeile aus: zunächst ein system/init-Ereignis, danach text-Deltas sowie tool_use- und tool_result-Ereignisse und schließlich einen abschließenden result-Umschlag mit Exit-Code, endgültigem Text und Token-Statistiken. Diagnosemeldungen und die Sitzungs-ID verbleiben auf stderr, die Tool-Ausgabe ist pro Ereignis auf 5.000 Zeichen begrenzt, und das Flag impliziert --quiet, erfordert -q oder --query-file (ohne eines davon Exit-Code 2) und kann nicht mit --tui kombiniert werden. Die Optionstabelle für hermes chat enthält das Flag.⁵¹
• skills.auto_load bindet skills in jede Sitzung ein. Unter skills.auto_load in config.yaml aufgeführte Namen werden in jeder neuen Sitzung vollständig geladen – gleichermaßen in CLI, TUI, gateway, cron und API – und einmalig aufgelöst, wenn der Prompt erstmals erstellt wird. Das Skills System erhält einen Unterabschnitt zu fest eingebundenen skills.⁵¹
• Eine decline-Option für nicht autorisierte Direktnachrichten. unauthorized_dm_behavior erhält neben pair und ignore einen dritten Wert: decline sendet eine einmalige höfliche Ablehnung und reagiert anschließend 24 Stunden lang nicht mehr auf diesen Absender. Siehe Benutzerautorisierung und Kopplung.⁵¹
• mcp.discovery_concurrency begrenzt gleichzeitige MCP-Verbindungen bei der Erkennung. Der Standardwert ist 4, 0 bedeutet unbegrenzt. Jeder konfigurierte Server wird weiterhin verbunden, die Verbindungen werden lediglich nicht mehr alle gleichzeitig hergestellt. Siehe MCP-Integration.⁵¹
• session_search erhält Zeitgrenzen und einen erneuten Suchversuch. Die Suchstruktur akzeptiert after-/before-Grenzen (ISO-Angaben oder relative Zeiträume wie 7d). Liefert eine aus mehreren Wörtern bestehende Abfrage keine Ergebnisse, wird die Suche wiederholt und dabei nach EINEM BELIEBIGEN Begriff gesucht, statt nach der impliziten UND-Verknüpfung aller Begriffe durch FTS5. Siehe Sitzungssuche.⁵¹
• hermes sessions set-journal-mode delete|wal: der Offline-Konverter für den Journal-Modus. Dies ist der Weg zur Selbsthilfe bei einer state.db, die im falschen SQLite-Journal-Modus feststeckt – wofür zuvor PRAGMA journal_mode=DELETE manuell ausgeführt werden musste. Beenden Sie zuerst das gateway, das dashboard und jede CLI-Instanz: Der Befehl verweigert die Ausführung, solange ein fremder Prozess die Datenbank geöffnet hält, wechselt den Modus, ohne auf geöffnete Prozesse zu warten, und überprüft anschließend die Header-Bytes der SQLite-Datei. Unter Windows gibt es keine Suche nach Prozessen, welche die Datei geöffnet halten. Dort wird die Ausführung daher verweigert, bis Sie nach dem manuellen Beenden sämtlicher Hermes-Prozesse --force übergeben. hermes doctor verweist nun darauf. Der Eintrag für hermes sessions unter Befehle der obersten Ebene enthält den Befehl.⁵¹
• Desktop: eine Schrifteinstellung, Engine-Updates mit einem Klick und die Deinstallation von plugins. In den Einstellungen gibt es nun ein Feld für die Schriftfamilie, das pro profile unter desktop.font_family gespeichert wird. Es überschreibt die Sans-Serif-Schrift des Themes im Chat und in der Benutzeroberfläche. Die Vorschlagsliste beginnt mit barrierearmen Schriftarten (OpenDyslexic, Atkinson Hyperlegible, Lexend); ein leeres Feld überlässt die Auswahl dem Theme. Die verwaltete Laufzeitumgebung für lokale Modelle zeigt bei Verfügbarkeit eines Updates die Schaltfläche „Engine aktualisieren“ an. Nach einem fehlgeschlagenen Update bleibt sie sichtbar, sodass Sie es direkt erneut versuchen können. Außerdem lässt sich ein plugin im Plugins-Hub nach Bestätigung in einem Dialogfeld deinstallieren.⁵¹
• Videokataloge: LTX 2.5 und Kling O3. Das FAL-Videoplugin ergänzt ltx-2.5 (das quelloffene Audio-/Videomodell von Lightricks: natives Audio, Bild-zu-Video mit bis zu 20 s/4K, Voreinstellungen für Kamerabewegungen, günstige Stufe – fal lehnt Clips über 10 s bei 1440p/2160p ab) und kling-o3 (die führende Modellfamilie von Kuaishou, Premium-Stufe: natives Storytelling über mehrere Einstellungen, optionales Audio, 3–15 s).⁵¹
• Der Pluginkatalog wird zu einem ausgelieferten Verzeichnis und einer Website. Das Verzeichnis plugin-catalog/ des Repositorys wuchs von 9 Einträgen bei v2026.9.14 auf 228 bei diesem Tag – ein geprüftes YAML pro plugin, jeweils an eine exakte Commit-SHA gebunden. Die Dokumentationswebsite erstellt nun außerdem je eine Seite pro plugin und Autor, auf der die README-Datei des plugins aus dem festgelegten Commit dargestellt wird. Alle zehn im Release genannten Community-plugins sind im Tag als Katalogeinträge enthalten. Unter Plugin System finden Sie die Einzelheiten.⁵¹
• Hinzu kommt eine umfangreiche Reihe von Fehlerbehebungen für die profile-/Multiplex-Isolierung, cron, Kanban, Desktop und state.db, die im Release lediglich als Kategorie genannt wird. Die kuratierte Dokumentation dieser Korrekturen bleibt v0.22.0 vorbehalten.⁵⁰

Die Rücknahme der Plugin-Kompatibilität ist auch in diesem Zeitraum noch nicht erfolgt. COMPAT_MANIFEST.md, compat_manifest.json und die Kompatibilitäts-Shims sind bei v2026.9.21 weiterhin vorhanden. Die einzigen Änderungen an hermes_cli/plugin_compat.py in diesem Zeitraum sind ein prozessweiter Scan-Cache (ein Multiplex-gateway erkennt plugins einmal pro bereitgestelltem profile; das erneute Parsen des Quellcodes jedes plugins kostete im Startpfad etwa 0,4 s pro profile) und Trefferpfade im POSIX-Format unter Windows (#112576). Das Datumstor und der Ausweg über einen literalen booleschen Wert bleiben unverändert, sodass betroffene plugins mit plugins.allow_deprecated_imports: true weiterhin geladen werden. Der Kompatibilitätskasten unter Plugin System beschreibt den aktuellen Stand.⁴²

Der Aktualisierungsvorgang bleibt unverändert: hermes update für Git-Installationen oder das Shell-Installationsprogramm für Neuinstallationen. Docker- und Hermes Cloud-Images werden aus diesem Tag erstellt (nousresearch/hermes-agent:v2026.9.21).⁵⁰

Neuerungen in v0.21.3 (der Patch vom 14. September)

Hermes Agent v0.21.3 (Tag v2026.9.14, 14. September 2026) umfasst drei weitere Tage aus main und wurde mit einer aus zwei Punkten bestehenden Mitteilung veröffentlicht. Der Grund: Cloud-Agenten aktualisieren sich automatisch auf den neuesten Release-Tag, und die Korrekturen an der Anmeldung beim remote gateway mussten sie erreichen. (1) Sitzungen im remote dashboard werden durch stoßweise Aktualisierungsanfragen nicht mehr widerrufen: Beide Aktualisierungspfade im gateway – die Cookie-Prüfung und die native Bearer-Route von Desktop – führen nun gleichzeitig eingehende Anfragen mit demselben rotierenden Aktualisierungstoken zu einem einzigen Durchlauf zusammen. Dadurch kann eine Welle von Anfragen nach dem Aufwachen eines Desktop-Systems kein bereits rotiertes Token mehr an die Wiederverwendungserkennung des Portals senden und so die gesamte Sitzung widerrufen. Zudem erfolgt die Aktualisierung außerhalb der Ereignisschleife, sodass ein langsamer Identitätsanbieter /api/status nicht mehr blockiert. (2) Langlebige Prozesse erzeugen keine doppelten Writer-Handles für state.db mehr: gateway, dashboard-/Desktop-Backend, ACP und CLI-Reader stellen schreibgeschützte Verbindungen her, während Writer innerhalb desselben Prozesses das Handle aus der Registry gemeinsam nutzen. Die Statistik für diesen Zeitraum: „1.036 Non-Merge-Commits“ in „2.642 geänderten Dateien“ und „338 zusammengeführte PRs“. Alles Weitere wird bewusst aufgeschoben: Das Release nennt ausdrücklich, was nicht dokumentiert wird (Auswahl der Reasoning-Intensität in jedem Modellwähler, OpenRouter OAuth PKCE, HEIF-/HEIC-/AVIF-Dekodierung, eine Welle neuer FAL-Katalogeinträge, in Slack eingefügte Tabellen und das Agent Sessions API, die Verweigerung des state.db-WAL-Modus auf VM-übergreifenden Dateisystemen und mehr) und verpflichtet sich wörtlich zu einer kuratierten Dokumentation: „Die vollständigen kuratierten Release Notes für diesen Zeitraum erscheinen mit v0.22.0 und dokumentieren alles ab v0.21.0“ und „Nichts aus diesem Zeitraum wird ausgelassen.“⁴⁹

Und die Frist für die Plugin-Kompatibilität trat planmäßig in Kraft. Die für den 14. September 2026 angekündigte Entfernung aus v0.21.1 wurde im ausgelieferten Code als Datumstor wirksam, nicht als Rücknahme des Codes: Beim Tag v2026.9.14 enthält hermes_cli/plugin_compat.py den Eintrag COMPAT_REMOVAL_DATE = 2026-09-14, und removal_in_effect() gibt ab diesem Datum true zurück (oder sobald die Manifestdatei nicht mehr vorhanden ist). Ein betroffenes externes plugin wird deshalb beim Laden deaktiviert und mit einem roten Hinweis versehen. Was noch NICHT geschehen ist: die Rücknahme, durch welche die alten Importpfade tatsächlich gelöscht werden. COMPAT_MANIFEST.md, compat_manifest.json und die Kompatibilitäts-Shims sind beim Tag weiterhin vorhanden – ebenso bei v2026.9.21 und mit Stand vom 22. September auch auf main. Deshalb funktioniert plugins.allow_deprecated_imports: true weiterhin als Ausweg: Sobald der Loader fortfahren darf, lassen sich die alten Pfade noch auflösen. Dabei gibt es zwei Fallstricke: Der Schlüssel muss ein literaler boolescher YAML-Wert sein (der Code akzeptiert ausschließlich den booleschen Wert True; eine Zeichenfolge in Anführungszeichen wie "true" oder "false" gilt entsprechend dem Quellcodekommentar „Literal boolean only“ als nicht gesetzt). Außerdem funktioniert dieser Ausweg nicht mehr, sobald die Rücknahme erfolgt, da dann die Pfade selbst verschwinden. Der Kompatibilitätskasten unter Plugin System beschreibt den aktuellen Stand.⁴²⁴⁹

Neues in v0.21.2 (das state.db-Patch-Release)

Hermes Agent v0.21.2 (Tag v2026.9.11, 11. September 2026) dient vor allem dazu, die Probleme zu beheben, die v0.21.0 verursacht hat. Das Release bringt es auf den Punkt: „v0.21.0 enthielt eine umfassende Überarbeitung der Verbindungsverwaltung des Sitzungsspeichers, die bei einigen Installationen state.db anfällig machte: Zweite Schreibprozesse hoben gegenseitig ihre Sperren auf, intakte Datenbanken wurden als beschädigt gemeldet und eine einzige fehlerhafte Zeile brachte sessions list zum Absturz. Dieses Release beseitigt diese Fehlerklasse und bündelt alles Weitere, was in den vier Tagen seit v0.21.1 in main aufgenommen wurde.“ Anders als die bewusst knappen Hinweise zu v0.21.1 dokumentiert dieses Release seine wichtigsten Neuerungen selbst. Die Statistik für diesen Zeitraum nennt „947 Nicht-Merge-Commits“ in „1.869 geänderten Dateien“ sowie „312 zusammengeführte PRs“ von „140 Mitwirkenden“; die kuratierte Dokumentation des gesamten v0.21.x-Zeitraums bleibt v0.22.0 vorbehalten.⁴⁸

• Die state.db-Zuverlässigkeitsoffensive: sechs PRs, 44 geschlossene Issues. Die Empfehlungen des Releases für Betreiber stehen an erster Stelle – und auch Sie sollten sie zuerst beachten: Falls Ihre state.db unter 0.21.0 oder 0.21.1 beschädigt wurde, führen Sie hermes doctor aus. Der Befehl unterscheidet nun zwischen strukturellen Schäden und Schäden am Volltextsuchindex, statt alles als „FTS-Schreibkorruption“ zu bezeichnen. Reicht eine Neuerstellung nicht aus, verweist er auf hermes sessions recover --inspect-only (offline, nicht destruktiv und an ein profile gebunden; prüft die Lesbarkeit der kanonischen Tabellen, ohne eine Ausgabedatenbank anzulegen). Die Ursachenbehebung entfernt jeden zweiten Schreibprozess aus dem Speicher: profile-gateways schrieben den Zustand gehosteter Räume alle 5 Sekunden in die übergeordnete state.db. Diese Koordination erfolgt nun in einer eigenen shared-state.db, sodass profile-gateways den zentralen Sitzungsspeicher nie mit Schreibzugriff öffnen. Das Dashboard versucht es zuerst schreibgeschützt; crons Lebenszyklus-Schutz greift über die registrierte Verbindungsverwaltung zu, statt ein unvermitteltes open() auf einer aktiven Datenbank aufzurufen (wodurch die POSIX-Sperren des gateways aufgehoben werden – das klassische Rezept für eine beschädigte SQLite-Datenbank); und doctor --fix verweigert einen checkpoint, dessen Sicherheit nicht nachgewiesen werden kann. Weitere Verbesserungen: Schäden am FTS-Index beeinträchtigen jetzt lediglich die Suche, während der Index später neu aufgebaut wird, anstatt den gesamten Durchlauf abzubrechen. Eine einzelne beschädigte Zeile bringt sessions list, den Export oder die Erkenntnisgewinnung nicht mehr zum Absturz (fehlerhafte Zeilen erscheinen als ?, begleitet von einer Warnung mit dem Namen der Sitzung). Sitzungen werden nie an die Datenbank eines anderen profile gebunden und lesen auch nicht daraus. Zudem beansprucht ein schreibgeschützter Zugriff nicht mehr die Schreibsperre, sodass ein einmaliger hermes-Aufruf hinter einem ausgelasteten gateway statt nach 4–20 Sekunden Wartezeit fehlzuschlagen nun 0,01 Sekunden benötigt.⁴⁸
• Verstärkte Isolierung mehrerer profile. Seit v0.19.0 wiederholt dieser Leitfaden die Aussage des Projekts, dass das profile-Routing jedem profile „vollständig isolierte Konfigurationen, skills, Speicher und Geheimnisse“ bietet. In v0.21.2 hatte dieses Versprechen noch Lücken, die nun geschlossen sind: Bots sekundärer profile übernahmen die Positivlisten des Standard-profile, Adapter konnten Anmeldedaten an den Host des Standard-profile senden, stdio-MCP-Server erhielten die Vault-Geheimnisse des Standard-profile, die MEDIA:-Übermittlung konnte .env/auth.json/state.db eines anderen profile anhängen, Webhook- und Feishu-Callbacks konnten vom zugewiesenen profile abweichen und sekundäre profile konnten über prozessbezogene Zwischenspeicher den Nous-Bearer eines Geschwister-profile übernehmen (#107609-#107630). Wenn Sie mehrere profile über ein einziges gemultiplextes gateway betreiben, ist dies das Release, ab dem der Isolierungsanspruch tatsächlich erfüllt wird.⁴⁸
• Der passwortblinde Anmeldedaten-Vault. Der Agent kann sich nun im Browser anmelden, bezahlen und Adressen ausfüllen, indem er 1Password, Bitwarden oder den lokalen Hermes-Vault verwendet, ohne jemals ein Geheimnis zu sehen. Zwei-Faktor-Codes stammen entweder aus einem gespeicherten Authentifizierungsschlüssel (TOTP: ein Base32-Seed oder eine otpauth://totp-URI; zählerbasiertes HOTP wird abgelehnt) oder werden über Ihre Benutzeroberfläche abgefragt. Jedes Backend stellt dem Agenten dieselbe Struktur bereit – Anmeldemetadaten sowie einen undurchsichtigen, mit einem Namensraum versehenen Handle (vault_ lokal, op:, bw:). Das Passwort wird erst beim Ausfüllen aufgelöst. Externe Passwortmanager bleiben gesperrt, bis Sie sie für die Sitzung entsperren, und das Masterpasswort „ist niemals ein tool-Argument, niemals argv und wird niemals gespeichert“. Dies baut auf der SecretSource-Arbeit aus v0.19.0 auf, durch die die API-Schlüssel der Anbieter aus der Klartextdatei .env entfernt wurden; der Vault schützt nun auf dieselbe Weise die Browser-Anmeldedaten des Agenten.⁴⁸
• Ein kuratierter, per SHA fixierter Plugin-Katalog. hermes plugins browse listet „jeden kuratierten Eintrag des Plugin-Katalogs“ auf, hermes plugins search durchsucht den Katalog und hermes plugins install löst Katalognamen ebenso wie Git-URLs und owner/repo auf. hermes plugins pack ergänzt dies um „deklarative, gemeinsam nutzbare Plugin-Sammlungen“: Eine einzelne hermes-pack.yaml fixiert eine Gruppe von Plugins auf exakte Commit-SHAs; pack install führt gewöhnliche fixierte Installationen aus, wobei die Zustimmung zu den Funktionen weiterhin für jedes Plugin einzeln gilt; pack export erzeugt ein pack aus der aktuellen Installation und pack show dient als Probelauf. Der Befehlsblock unter Plugin-System enthält die neuen Unterbefehle.⁴⁸
• Kostenlose Nous-Stufe und geführter Erststart. Neuinstallationen bieten sofort kostenlose Inferenz und Konnektoren sowie einen einzigen Befehl zur Anmeldung. /login funktioniert innerhalb eines Chats und Konnektor-tools (Gmail, Linear, Notion und weitere) lassen sich über tool_search durchsuchen. Der geführte Erststart der Desktop-Anwendung wird durch HERMES_GUEST_ONBOARDING=1 gesteuert, wobei ausschließlich der exakte Wert 1 die Funktion aktiviert: Der eigene Test der Desktop-Anwendung bestätigt, dass 'true', '0' und ein leerer Wert sie deaktiviert lassen. Die Startentscheidung wird außerdem in die Umgebung des erzeugten Backends geschrieben, damit kein geerbter Wert unbeabsichtigt übernommen wird. Siehe Nous Tool Gateway.⁴⁸
• Spawn-Stürme des Desktop-Backends gehören der Vergangenheit an. Bot Mode erzeugte beim Start und bei jeder Aktualisierung der Liste bisher für jedes profile ein Backend oder stellte eine Verbindung dazu her. Beim Überfahren der Bot-Liste mit dem Mauszeiger wurde für jede Zeile ein Backend erzeugt, und ein profile-Wechsel konnte ein doppeltes primäres Backend starten. All diese Probleme wurden in diesem Zeitraum behoben.⁴⁸

Der Aktualisierungsvorgang bleibt unverändert: hermes update für eine bestehende Installation oder das Shell-Installationsprogramm für eine Neuinstallation.⁴⁸

Neuerungen in v0.21.1 (der Rollup-Patch)

Hermes Agent v0.21.1 (Tag v2026.9.7, 7. September 2026) fällt bewusst knapp aus: ein „Patch-Release“, das „den aktuellen Stand von main seit v0.21.0 für mit Tags versehene Deployments und nachgelagerte Nutzer bündelt“. Der Haupttext nennt die Zahlen für diesen Zeitraum – „5.139 Non-Merge-Commits in 4.364 geänderten Dateien (+601.014 / -768.419)“ und „632 zusammengeführte PRs“ – und vertagt dann die eigentliche Darstellung: „Vollständige kuratierte Release Notes für diesen Zeitraum werden mit v0.22.0 veröffentlicht.“ Damit ist dies der größte Zeitraum zwischen zwei aufeinanderfolgenden Tags in der Projektgeschichte (kein vorheriger Zeitraum zwischen benachbarten Tags übertrifft die 2.790 Non-Merge-Commits von v2026.7.20..v2026.7.30), veröffentlicht mit den kürzesten Release Notes. Bis v0.22.0 die kuratierte Dokumentation liefert, zeigen die folgenden sechs Bereiche, was den Betrieb von Hermes mit diesem Tag verändert; jeder Punkt wurde im Quellcode überprüft.⁴¹

• Die Codebasis wurde zerlegt, und am 14. September lief die Frist für die Plugin-Kompatibilität ab. Bei der Zerlegung im September 2026 (PR #102117) wurden die großen Module des Repositorys in spezialisierte Dateien aufgeteilt: Ein neues Paket agent/ enthält die Interna der Konversationsschleife (214 Module auf oberster Ebene sowie sieben Unterpakete; prompt_builder.py befindet sich nun unter agent/prompt_builder.py, während run_agent.py weiterhin die Heimat von AIAgent ist), die Subcommand-Parser von CLI wurden in das Paket hermes_cli/subcommands/ verschoben (61 Module), die statische Liste CANONICAL_PROVIDERS wanderte von hermes_cli/models.py nach hermes_cli/models_catalog_static.py (die Liste selbst blieb unverändert: 39 statische Einträge, weiterhin automatisch um die 39 mitgelieferten Provider-Plugin-Ordner ergänzt), und delegate_task wurde auf etwa ein Dutzend Module unter tools/delegate_tool_* verteilt. Interne Importpfade sind kein stabiler API. Deshalb exportiert eine neue Datei COMPAT_MANIFEST.md im Stammverzeichnis des Repositorys 1.148 „moved-lazy“-öffentliche Namen erneut unter ihren alten Modulpfaden, wobei bei der Auflösung für jeden Namen einmal pro Prozess eine HermesPluginCompatWarning ausgegeben wird. Die Kompatibilitätsschicht war nur vorübergehend vorgesehen, und ihre Entfernung trat planmäßig am 2026-09-14 in Kraft, sechs Tage nach dem Tag – nicht als Rücknahme einer Codeänderung, sondern durch eine bereits im ausgelieferten Code enthaltene Datumsschranke. Seit diesem Datum wird ein betroffenes Drittanbieter-Plugin nicht geladen: Das Banner von CLI, hermes doctor und hermes update zeigen einen roten Hinweis mit dem Namen des deaktivierten Plugins an, die Desktop-Anwendung zeigt einmalig einen modalen Dialog, und hermes plugins list nennt den Grund. Wenn Sie externe Plugins verwenden, prüfen Sie diese: hermes plugins compat <path> gibt für jede Fundstelle file:line mit altem Pfad -> neuem Pfad aus und beendet sich mit Status 1, solange noch Fundstellen vorhanden sind (--json liefert eine maschinenlesbare Ausgabe; ohne Argumente wird die gesamte installierte Plugin-Sammlung geprüft). Als Ausweichlösung für ein Plugin, dessen Autor noch nicht nachgezogen hat, dient plugins.allow_deprecated_imports: true in config.yaml; sie funktioniert weiterhin: Die Änderung, mit der die alten Importpfade tatsächlich entfernt werden, war mit Stand vom 22. September noch nicht enthalten (überprüft bis Tag v2026.9.21 sowie auf main). Daher lassen sich die alten Pfade weiterhin auflösen, sobald der Loader fortfahren darf. Einzelheiten zu den Folgen finden Sie oben unter Neuerungen in v0.21.2; der Abschnitt Plugin-System enthält den Kasten zum aktuellen Stand.⁴²
• Gateway-Konversationen werden überhaupt nicht mehr zeitgesteuert rotiert. Die Dokumentation zum Sitzungslebenszyklus formuliert die Vereinbarung nun ausdrücklich: „Weder Inaktivität noch verstrichene Zeit führen jemals zur Rotation einer Konversation. /new und /reset setzen eine ausdrückliche Grenze; die Kontextkomprimierung verwaltet weiterhin lange Verläufe. Veraltete Timer-Konfigurationen werden ignoriert. Der vorhandene Datentyp SessionResetPolicy besteht lediglich als inaktive Kompatibilitätsstruktur und nicht als Laufzeitrichtlinie.“ Grenzen werden ausdrücklich von Benutzern gesetzt. Wenn Sie Sitzungs-Reset-Timer aus der OpenClaw-Ära mit hermes claw migrate übernommen haben, sind diese nun inaktive Daten. Siehe Messaging-Gateway.⁴³
• Die Autorisierung von MCP erhält einen Gerätecode-Ablauf. hermes mcp login <name> unterstützt nun --flow {browser,device}: browser bezeichnet den bestehenden PKCE-Ablauf, device eine Gerätecode-Anmeldung gemäß RFC 8628 für Rechner, auf denen ein Browser-Callback unpraktisch ist, und das Flag überschreibt die Einstellung oauth.flow des Servers. In diesem Zeitraum wurde auch die übrige Authentifizierungsoberfläche von MCP gehärtet: Die profile-Zugehörigkeit wird in allen OAuth-Sitzungen durchgesetzt, fehlerhafte Metadaten-Caches von OAuth werden ignoriert, anstatt einen Server zu blockieren, und die Desktop-Anwendung leitet OAuth von MCP über clientlokale Callbacks weiter. Ebenfalls neu: -t/--toolsets filtert nun auch, welche konfigurierten MCP-Server überhaupt gestartet werden. Dadurch überspringt ein einmaliger Lauf mit hermes -z -t <toolsets> den Kaltstart nicht benötigter Server. Der Befehlsblock unter MCP-Integration enthält nun login und reauth [--all]; beide gab es bereits vor diesem Zeitraum, sie waren hier jedoch noch nicht dokumentiert.⁴⁴
• Delegation bildet Hintergrundarbeit jetzt ehrlich ab. Sechs Zuverlässigkeitsänderungen an delegate_task, die alle direkt aus dem Quellcode des Delegationswerkzeugs beim betreffenden Tag hervorgehen. (1) Ein Hintergrund-Batch wird standardmäßig als EINE Fertigstellung zurückgegeben. Mit delegation.independent_completions lässt sich der Aufruf stattdessen in Fertigstellungseinheiten aufteilen: Aufgaben mit demselben group-Wert werden zusammengefasst und gemeinsam gemeldet, während jede nicht gruppierte Aufgabe nach ihrem Abschluss einzeln gemeldet wird. Diese Voreinstellung ist bewusst gewählt – laut Quellcode hat eine Flut einzelner Fertigstellungen „Orchestratoren fragmentiert, die dafür keinen Plan hatten“. (2) Die Hintergrundprozesse eines untergeordneten Agenten werden beim Beenden des Agenten beendet, sofern er sie nicht mit process_manage(action="handoff") an den übergeordneten Agenten übergibt. Nicht übergebene Restprozesse werden im Ergebnis als orphaned_processes benannt; Prozesse des untergeordneten Agenten, die beendet wurden, ohne jemals ausgelesen worden zu sein, erscheinen einschließlich eines Auszugs ihrer Ausgabe als unread_completions. Die Haltung hinter diesem Design lautet laut Docstring im Quellcode: Der übergeordnete Agent „muss dies von der Laufzeit erfahren“, anstatt der Behauptung eines untergeordneten Agenten zu vertrauen, ein „Watcher laufe“. (3) delegation.fallback_providers wird zu einer echten Konfigurationsoberfläche: null übernimmt die Kette des übergeordneten Agenten für nicht festgelegte untergeordnete Agenten, [] deaktiviert Fallbacks, und ein über Provider, Endpunkt oder Modell festgelegter untergeordneter Agent erhält keinen Fallback, sofern diese Einstellung keinen definiert. (4) Die Fallback-Kette eines untergeordneten Agenten wird über den kanonischen Normalisierer aufgelöst, sodass fehlerhafte Einträge verworfen werden, anstatt das Starten eines Agenten zu verhindern. (5) Bei einem Absturz während einer Einheit gehen bereits abgeschlossene untergeordnete Agenten nicht mehr verloren: Jeder abgeschlossene untergeordnete Agent einer Einheit mit mehreren Agenten wird dauerhaft in der eigenen Zeile der Einheit erfasst und bleibt als Teilergebnis im wiederhergestellten Ergebnis erhalten. (6) Subagents übernehmen niemals die einstündige Prompt-Cache-Stufe: Ein delegierter untergeordneter Agent wird auf die 5-Minuten-Stufe zurückgestuft, weil die einstündige Stufe preislich für eine Person ausgelegt ist, die längere Zeit nicht am Rechner arbeitet, und nicht für einen Schub parallel ausgeführter untergeordneter Agenten.⁴⁵
• Provider und Modelle. Die Kataloge erhalten OpenAIs GPT-6 Astra und Astra Pro mit den Geschwindigkeitsstufenvarianten -fast/-flex („doppelter Preis, Prioritätsstufe“ / „halber Preis, Flex-Stufe“) in den Katalogen von Nous Portal und OpenRouter. Auf der ChatGPT/Codex-Route von OAuth ist Astra an das Konto gebunden (nur die aktive kontobezogene Erkennung darf es anbieten) und erhält eine optionale Auswahlvariante -900k, die das angegebene Kontextfenster von 272K auf aktiv überprüfte rund 900K erhöht; das Suffix wird niemals übertragen. Hinzu kommen anthropic/claude-fable-5.1, google/gemini-3.7-flash und gemini-3.8-flash, qwen/qwen3.8-max-0902 und qwen3.8-flash sowie Metas Muse-Spark-1.3-Familie (1M Kontext, einschließlich Contributor-Varianten) und ein Meta-Provider-Plugin namens muse-image zur Bilderzeugung. Tavily kommt als Backend für Websuche und Extraktion hinzu (TAVILY_API_KEY; bei Auswahl von Tavily über hermes tools funktioniert es auch ohne Schlüssel). Eine verwaltete llama.cpp-Laufzeit macht lokale Modelle zu einer vollwertigen Option (offizielle Binärdateien, ein überwachter llama-server, Einrichtung mit einem Klick über die Desktop-Anwendung), und externe Prozess-Provider außerhalb des Repositorys erhalten einen eigenen Auflösungszweig. Für den Betrieb relevant: Die Remote-Kataloge der Modellauswahl werden nun alle 20 Minuten aktualisiert (model_catalog.ttl_minutes, Standardwert 20); der veraltete Schlüssel ttl_hours wird nur dann berücksichtigt, wenn ein Benutzer ihn ausdrücklich gesetzt hatte.⁴⁶
• Desktop: Seite kommentieren, Sitzung steuern. Der integrierte Browser erhält einen Kommentarmodus: Klicken Sie auf Annotate, anschließend auf ein beliebiges Element der aktiven Seite (oder ziehen Sie einen Rahmen darum) und geben Sie eine Notiz ein. Gespeicherte Kommentare bleiben als nummerierte Markierungen sichtbar und senden niemals eigenständig eine Nachricht. Wenn Sie fertig sind, übergibt „Add N comments“ den gesamten Batch an den Composer, einschließlich eines zugeschnittenen Screenshots pro Markierung. Jeder Elementkommentar enthält außerdem seinen CSS-Selektor, sein Markup und die für das Layout relevanten berechneten Stile, damit der Agent das Element in Ihrem Quellcode findet, anstatt anhand eines Bildes raten zu müssen. Passwort- und ausgeblendete Werte sowie Attribute, deren Namen auf Schlüssel hindeuten, werden geschwärzt, bevor das Markup die Seite verlässt. Größere Batches werden nach Seitenbereichen gruppiert. So werden aus gut zwanzig Kommentaren nur wenige Arbeitspakete, die üblicherweise verschiedene Dateien betreffen – und sich deshalb sicher auf parallele Arbeitskräfte verteilen lassen. Ergänzend gibt es strukturierte Sitzungssteuerungen samt Automatisierungsoptionen, das Erstellen von Sitzungen per Ziehen, eine Sitzungsimportansicht für Transkripte anderer Coding-Agenten, display.resume_last_session (standardmäßig true: Bei einem Kaltstart wird der letzte Chat oder die letzte Seite erneut geöffnet), eine einmalige Einwilligungsabfrage mit der Option browser.use_real_profile, wenn ein Browser-Bereich erstmals bei deaktivierter Einstellung geöffnet wird, einen integrierten Katalog optionaler skills unter Capabilities -> Skills mit Installation per Klick sowie Russisch als neue Sprache für die Desktop-Benutzeroberfläche (die 17 Gebietsschemakataloge von CLI bleiben unverändert).⁴⁷

Der Aktualisierungsvorgang bleibt unverändert: hermes update für eine bestehende Installation oder das Shell-Installationsprogramm für eine Neuinstallation. Die kuratierte Dokumentation dieses Zeitraums bleibt v0.22.0 vorbehalten; die oben beschriebenen Bereiche zeigen, was sich mit diesem Tag ändert.⁴¹

Neuerungen in v0.21.0 (The Pantheon Release)

Hermes Agent v0.21.0 (Tag v2026.8.31, 31. August 2026) ist das aktuelle Funktionsrelease und zugleich die kuratierte Dokumentation, auf die sämtliche gebündelten v0.20.x-Updates verwiesen hatten: „Dieses Release bündelt alle Infrastruktur-Patch-Tags von v0.20.1 bis v0.20.6 – diese Zeiträume sind hier vollständig dokumentiert.“ Inhaltlich knüpft es an Herald an: „Mit v0.20.0 wurde Hermes zum Herold – er sprach und überbrachte anderen Agenten Botschaften. In v0.21.0 versammeln sich die Götter.“ Die Statistikzeile im Wortlaut: „Seit v0.20.0: ~5.800 Commits · ~2.475 zusammengeführte PRs · ~5.680 geänderte Dateien · ~869.000 Einfügungen · ~135.000 Löschungen · ~2.100 geschlossene Issues · über 760 Mitwirkende“.³⁵

Das Release ist nach Funktionsbereichen gegliedert; diese Zusammenfassung folgt derselben Struktur. Wenn eine Funktion einen bestehenden Abschnitt dieses Leitfadens betrifft, finden Sie den Verweis direkt im jeweiligen Eintrag.

• Bot Mode: Ihre Agenten werden zu einer integrierten Gemeinschaft. Bot Mode entwickelt sich vom gebündelten hermes-bots-Plugin des v0.20.3-Zeitraums zu einem standardmäßig aktivierten Bestandteil der Desktop-App. Jedes Agenten-profile erhält einen Namen, ein deterministisches Avatar-Gesicht mit Steuerelementen zum Zufallsgenerieren und Sperren sowie einen Platz in einer gemeinsamen Übersicht. Sie erstellen Gruppenchats im Discord-Stil, in denen mehrere Bots und Sie sich in einem Raum unterhalten, erwähnen über den Nachrichten-Editor jeden beliebigen Bot mit @ und versehen Räume mit Namen und Bildern. Zum Funktionsumfang gehören Agent-zu-Agent-Nachrichtenkarten mit Absenderangabe, Zustellhinweise auf Absenderseite, Paint-first-Hydration für sofortiges Aufwachen, ein Bereich für Routinen sowie eine Neuentwicklung auf Grundlage des App-Designsystems. Das Release selbst formuliert es so: „Früher bedeutete ‚Multi-Agent‘ vor allem technische Verkabelung; heute sieht es aus wie eine Chat-App voller Kollegen.“³⁵
• hermes peer: Bot-zu-Bot-Direktnachrichten zwischen Ihren Agenten. Jeder Hermes-Agent kann jeden anderen über dessen Handle kontaktieren – über profiles und gateways hinweg, aus CLI oder direkt aus einer Unterhaltung heraus. Bitten Sie etwa Ihren Recherche-Bot, seine Ergebnisse an Ihren Coding-Bot weiterzugeben, und lesen Sie die Antwort dort, wo Sie sich gerade befinden. „Antworten gehen im kanonischen Bot Chat des jeweiligen Agenten ein. Unterhaltungen zwischen Agenten bleiben dadurch dauerhaft erhalten und nachvollziehbar, statt nach einmaligem Senden zu verschwinden.“ Der Befehl hermes peer (Peers hinzufügen/auflisten/entfernen sowie dm) ist in der Tabelle Befehle der obersten Ebene aufgeführt.³⁵
• Cron-Jobs mit Gedächtnis. Geplante Jobs vergessen nicht mehr nach jedem Lauf alles: Cron-Agenten laden und aktualisieren wie alle anderen Agenten einen dauerhaften Speicher, continuity=true übernimmt die Ausgabe eines Laufs in den nächsten, sodass ein Monitor bereits gemeldete Inhalte erkennen und Duplikate vermeiden kann, und jeder Job erhält einen dauerhaften Notizblock. Jobs im Monitor-Modus überspringen LLM vollständig, wenn sich nichts geändert hat; der Reasoning-Aufwand lässt sich für jeden Job festlegen und Cron-Ausgaben können im kanonischen Bot Chat eines Bots eingehen, wo dieser tatsächlich darauf antwortet. Der Abschnitt Geplante Aufgaben (Cron) dokumentiert nun die At-Tag-Mechanik der einzelnen Funktionen.³⁵³⁷
• Live-Orchestrierung von Subagenten. delegate_task erhält Steuerungsaktionen: Sie können laufende Unteragenten auflisten, einen von ihnen während der Ausführung durch eine Kurskorrektur neu ausrichten oder ihn vorzeitig stoppen und das Teilergebnis behalten. Unteragentenausgaben lassen sich anhand eines JSON-Schemas validieren, die Kosten jeder Delegierung werden in den Ergebnissen ausgewiesen und die Standardwerte steigen auf 250 Iterationen pro Unteragent sowie 10 gleichzeitig laufende Unteragenten – die einheitlichen Obergrenzen, die max_async_children in v0.19.0 ersetzt haben.³⁵³⁸
• Die MCP-Kommandozentrale. MCP-Server und der Katalog werden auf einer einzigen Desktop-Seite zusammengeführt. Diese bietet einen „Beliebiges einfügen“-Import per Drag-and-drop, Hintergrundprüfungen des Systemzustands, die Sie vor dem Fehlschlagen eines Tool-Aufrufs zur erneuten Authentifizierung auffordern, eine Kosten- und Nutzungsübersicht für die gesamte Flotte (Schätzungen der Schema-Token sowie 30-Tage-Nutzung pro Server) und hermes://-Deep-Links, über die sich ein MCP-Server nach ausdrücklicher Bestätigung installieren lässt. Siehe MCP-Integration.³⁵
• Eine Leistungswelle für CLI. Strg+P öffnet eine unscharfe Befehlspalette, die auch über /palette erreichbar ist. Die /model-Auswahl filtert bereits während der Eingabe, /status zeigt Reasoning-Modus, ausstehende Genehmigungen und Kontextnutzung, und die Statusleiste kann mit separaten Umschaltern für jedes Feld die aktuelle Cache-Trefferquote in Prozent, die Latenz und die Token pro Sekunde anzeigen. Hinzu kommen ein globaler Not-Aus, das Anheften und Lösen von Sitzungen, wechselnde Platzhalter im Nachrichten-Editor und Terminal-Haustiere. Ein Hinweis zur Benennung: Das Release bezeichnet eine Genehmigungsprüfung im Probelauf als hermes approval-check; im betreffenden Tag heißt diese Oberfläche jedoch hermes approvals test – einen Unterbefehl approval-check gibt es nicht.³⁵⁴⁰
• Der Agent steuert den Browser der Desktop-App. Der integrierte Browser ist nicht länger nur ein Fenster, das der Agent betrachten kann: Hermes navigiert darin, klickt auf Elemente und liest Inhalte direkt aus. Seiten lassen sich zudem im Systembrowser öffnen, wobei vollständige Link-Kontextmenüs zur Verfügung stehen.³⁵
• Sechs neue Provider und eine Welle neuer Modelle im Katalog. Meta Model API (Muse Spark), CommandCode, Tencent TokenPlan, Nebius Token Factory, Ramp Router und Actual Computer. Drei davon (Meta AI, CommandCode und Actual Computer) wurden bereits in früheren gebündelten Zeiträumen eingeführt und waren schon in der Provider-Matrix enthalten. Neu hinzu kommen Tencent TokenPlan, Nebius Token Factory und Ramp Router sowie die neue Alibaba-Token-Plan-SKU aus der Dokumentation. Die Kataloge werden um GLM-5.3-Flash, qwen3.8-max/flash, Gemini 3.7 Flash, MiniMax M3 free, Nemotron 3.5 Lightning und Muse Spark 1.2 erweitert. Damit gehen zwei strukturelle Änderungen einher: Mit model_overrides in config.yaml können Sie das Kontextfenster oder die Preisangaben jedes Modells anpassen, ohne auf ein Release zu warten. Außerdem können Provider nun als über Entry Points erkannte, per pip installierte Pakete ausgeliefert werden; eine zentrale Registry für Auswahlwarnungen weist darüber hinaus in sämtlichen Auswahloberflächen darauf hin, wenn ein Modell mit Ihren Daten trainiert.³⁵³⁶
• Umfassende Sicherheitshärtung. Schreibzugriffe auf geschützte Agentenanweisungsdateien (AGENTS.md, skills und Speicher) erfordern jetzt immer eine Genehmigung, damit ein durch Prompt Injection manipulierter Agent seine eigenen dauerhaften Anweisungen nicht unbemerkt umschreiben kann. Eine umfassende Überarbeitung der Schwärzung schließt Lücken, durch die Geheimnisse über Terminalfehler, Lesezugriffe auf .env, checkpoints und ACP-Protokolle offengelegt werden konnten. Das Genehmigungssystem erkennt nun auch destruktive Windows-Befehle; macOS-Berechtigungen bleiben dank einer stabilen TCC-Signaturidentität (hermes desktop --setup-tcc-identity) über Updates hinweg erhalten. Außerdem wurden der Blender-MCP-Katalogeintrag und der zugehörige skill nach einer Kompromittierung des vorgelagerten Projekts entfernt. Einzelheiten zum betreffenden Tag finden Sie unter Sicherheitshärtung.³⁵³⁹
• Weiterentwicklung des gateway. Slack erhält native Live-Karten mit echten Streaming-Antworten und optionalen Plan-/Aufgabenkarten sowie die Möglichkeit, ausgehende Linkvorschauen zu unterdrücken. Telegram bekommt eine Inline-Auswahl, über die sich jeder Befehl und skill mittels @botname durchsuchen lässt, wodurch die Obergrenze des Telegram-Befehlsmenüs umgangen wird. Auch der Relay-Pfad wird ausgereifter: native Plugin-Initialisierung, Live-Kartenaktionen mit Entwurfs-Streaming, Segmentierung von Sitzungsspannen und wiederhergestellte Sprachnachrichten-STT. Über einen gateway-Steuerungssocket können Flotten-Clients den gateway abfragen, während Updater ihn geordnet pausieren können, statt den gesamten Prozessbaum zu beenden. Zudem erfasst der Turn-Reaper die Stacks blockierter Worker, sobald der Watchdog ausgelöst wird.³⁵
• Eine Welle neuer skills. Acht wiederhergestellte Produktivitäts-skills (document-to-action-items, meeting-action-items, email-inbox-triage, github-issue-to-pr, weekly-review-planning, competitor-news-monitor, product-price-monitor und social-media-content-calendar), aus HAR-Dateien abgeleitete API-Clients („Beobachten Sie eine Website einmal und rufen Sie anschließend ihre verborgene API direkt und ohne Browser auf“), publish-site, session-librarian, blocked-page-recovery, merge-reconciler, plan-interrogation sowie ein beratender SKILL.md-Linter bei der Erstellung.³⁵

In diesem Zeitraum rückgängig gemacht (nicht enthalten): Sowohl der Model-Council-Modus (/council) als auch die DCP-context engine wurden zunächst integriert und anschließend zurückgesetzt. Der ausschließlich auf WS basierende gateway-Server (#94245) wurde zusammengeführt und danach ebenfalls zurückgesetzt (#96118), sodass FastAPI weiterhin Teil des Desktop-Startpfads ist. Die sequenznummerierte Ereigniswiedergabe (#94219) und die verlustfreie Desktop-Wiederverbindung über WebSocket wurden hingegen tatsächlich ausgeliefert. Electron wurde auf 40.10.2 zurückgesetzt. Sollten Community-Berichte zu den v0.20.x-Zeiträumen eine dieser Funktionen erwähnt haben, sind sie in diesem Release nicht enthalten.³⁵

Der Aktualisierungsvorgang bleibt unverändert: hermes update bei einer bestehenden Installation oder das Shell-Installationsprogramm für Neuinstallationen. Der gebündelte Unterabschnitt unter dem nachfolgenden Herald-Release bleibt die nach Tags gegliederte Dokumentation dazu, welche Änderungen in welchem Zeitraum eingeführt wurden.³⁵

Neuerungen in v0.20.0 (The Herald Release)

Hermes Agent v0.20.0 (Tag v2026.8.3, 3. August 2026) war das Funktionsrelease, bevor v0.21.0 sämtliche Änderungen zusammenführte. v0.20.1 (13. August) und v0.20.2 (16. August) sind darauf aufbauende Stabilisierungsversionen, während v0.20.3 (Tag v2026.8.16.2, veröffentlicht am 17. August), v0.20.4 (Tag v2026.8.18, 18. August), v0.20.5 (Tag v2026.8.19, veröffentlicht am 21. August) und v0.20.6 (Tag v2026.8.27, 27. August) die Reihe der Rollups mit eigenen Funktionsfenstern fortsetzen — siehe den nachfolgenden Unterabschnitt. Das Zeitfenster 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 frühere Anweisungen dieses Leitfadens hinfällig. Lesen Sie diese zuerst:

• Node 26 ist jetzt erforderlich. Das Installationsprogramm legt NODE_VERSION="26" fest und lehnt ältere Laufzeitumgebungen mit „Node.js … is too old (Hermes requires Node >=26)“ ab. Installationsprogramme, heal und upgrade setzen diese Anforderung gleichermaßen durch. Beachten Sie, dass auf der Installationsseite der Dokumentationswebsite noch Node v22 genannt wird — das Installationsskript und die Versionshinweise sind die neueren, maßgeblichen Quellen.⁵⁹
• pip und Homebrew wurden eingestellt, nicht nur als veraltet gekennzeichnet. Wörtlich: „brew + pip/PyPI wheel channels retired (shell installer / Docker / Nix are the supported channels).“ Wenn Sie Hermes noch ü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 Durchläufe stoßen dadurch nicht mehr an eine künstliche Grenze, und sämtliche nachfolgend beschriebenen Schwellenwerte für Budgetdruck werden anhand des neuen Limits berechnet. read_file gibt zudem standardmäßig 2.000 statt 500 Zeilen zurück.⁵⁹

Die weiteren Neuerungen des Releases:

• Konversationsmodus per Sprache. Streaming-TTS mit Unterbrechungsmöglichkeit und lokal auf dem Gerät erkannten Aktivierungswörtern.⁵⁹
• A2A v1.0. Ein Protokoll-Plugin für die Kommunikation zwischen Agenten, das die langjährige Anforderung 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.⁵⁹
• Quellengestützte Zitate. Ein neuer skill mit Faktenprüfungsmodus.⁵⁹
• Eine Welle neuer Funktionen für CLI-Power-User. Mit !command führen Sie einen Shell-Befehl sofort aus, ohne einen Modell-Turn zu verbrauchen. /init durchsucht das Projekt und erstellt oder aktualisiert eine AGENTS.md. /diff zeigt auf jeder Oberfläche vorgemerkte, sämtliche oder sitzungsbezogene Änderungen. /context schlüsselt auf, was das Kontextfenster belegt. /focus bietet eine Ansicht mit reduzierter Ausgabe, in der sich ausgeblendete Zeilen wieder einblenden lassen. Mit Strg+S können Sie eine nur teilweise verfasste Eingabe zwischenspeichern. hermes import-agent migriert eine Claude Code- oder Codex-CLI-Konfiguration mit einem einzigen Befehl.⁵⁹
• Erweiterungen für die Verwaltung von Geheimnissen. Eine mit jedem Tresor kombinierbare Befehlsquelle für Geheimnisse, Token-Rotation mit einem einzigen Befehl und aussagekräftigen Startfehlern, ein optionaler verschlüsselter Notfall-Cache für Bitwarden, pro profile-Home beschränkte und 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. Der Kaltstart von hermes -w wurde von etwa 14 s auf 1,8 s verkürzt.⁵⁹
• Desktop wurde zu einer Plattform. Artefakte mit versionierten Karten und isolierter Live-Vorschau, ein Plugin-SDK mit Kanban als erstem Desktop-Plugin, ein globaler Hotkey für die Schnelleingabe, mehrere GUI-Fenster, ein SSH-Modus für Remote-Backends und native Anmeldung gemäß RFC 8252.⁵⁹

Die Rollups v0.20.3, v0.20.4, v0.20.5 und v0.20.6 (17.–27. August)

Nach v0.20.0 veröffentlichte das Projekt in hoher Frequenz mit Tags versehene Rollups, die über reine Stabilisierung hinausgingen. Bei allen vier wurden kuratierte Hinweise auf dieselbe Weise zurückgestellt — in jedem hieß es, dass „full curated release notes for this window will ship with v0.21.0“ — und v0.21.0 hat sie inzwischen bereitgestellt: Neuerungen in v0.21.0 oben ist die kuratierte Dokumentation dieses gesamten Zeitraums. Das Release bestätigt, dass die Zeitfenster „are fully documented here“. Die nachfolgenden Blöcke bleiben als zeitgenössische Aufzeichnung der einzelnen Tags erhalten — sie zeigen, welche Änderungen mit welchem Tag eingeführt wurden, während die kuratierten Hinweise diese zusammenfassen.^58233035

v0.20.3 (ca. 250 Commits und 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 erscheint als mitgeliefertes Plugin (hermes-bots), das das zentrale Protokoll für Teammitglieder enthält.⁵⁸
• Ein CommandCode-Provider-Plugin ergänzt den Provider-Katalog.⁵⁸
• Cua Driver 0.20-Laufzeitverträge für die Computernutzung sowie eine robustere Verwaltung der Python-Laufzeitumgebung von Unterprozessen durch PYTHONHOME/PYTHONPATH-Isolierung.⁵⁸
• Zuverlässigkeit: Selbstreparatur des cron-Schedulers (EMFILE-Wiederherstellung, Abgleich veralteter Ansprüche und erneute Aktivierung festgefahrener Jobs), Korrekturen gegen Datenverlust bei Sitzungsübergaben, Selbstreparatur der Remote-gateway-Verbindung auf dem Desktop sowie zahlreiche Portierungen aus dem Ökosystem (Sicherheitsprüfung bei Plugin-Installationen, /worktree, Erhalt manueller Änderungen durch /rollback und Lesen von UTF-16-Dateien).⁵⁸

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

• Die Glasoberfläche des Desktops: mattes Glas und Transparenzeffekte mit Auswahl der Froststärke und Vorauswahl für macOS.⁵⁸
• Eine SESSIONS|BOTS-Seitenleiste mit Registerkarten und der Möglichkeit, einzelne Bots ein- oder auszublenden, ergänzt durch Korrekturen für Gruppenchats im Bot Mode (lang andauernde Turns von Mitgliedern, Markdown-Darstellung und maschinenübergreifendes Routing).⁵⁸
• NVIDIA SkillEvaluator Tier 1 führt bei der Installation von skills beratende Prüfungen durch — Lizenz- und Sicherheitsprüfungen werden ausgeführt, wenn Sie einen skill installieren.⁵⁸
• Robustere Medienübertragung für cron (konfigurierbarer Timeout, Anhänge bei manueller Ausführung und Anzeige verpasster Ausführungen), Korrekturen für Event-Loop-Threads und Ressourcenkonflikte in SessionDB, ehrliche Angaben von hermes update zu geparkten Branches sowie native Betriebssystembenachrichtigungen für Kanban.⁵⁸

v0.20.5 (ca. 746 Commits und ca. 323 PRs seit v0.20.4):

• Die schlüssellose Webebene: Die Websuche funktioniert bei Neuinstallationen ohne jegliche API-Schlüssel — durch kostenlose Rotation über 5 Anbieter mit Ring-Failover.²³
• Eine CLI-Politurwelle: eine unscharfe Suche im /model-Auswahlmenü, eine Befehlspalette über Strg+P und eine ausführlichere /status-Anzeige.²³
• Bot Mode wird erwachsen: Threads in Gruppenräumen, einklappbare Gesprächszusammenfassungen, Blob-Gesichter als Avatare sowie PDF-/Dateianhänge per Drag-and-drop.²³
• Werkzeuge für Flotten und Worktrees: Belege von hermes update, hermes update --plan (in den Versionshinweisen als „fleet --plan verification“ bezeichnet; das Flag gehört zu hermes update, nicht zu einem fleet-Befehl, und laut Parser-Hilfe wird es „Show the update plan and exit without changing anything“) sowie hermes worktree list/prune.²³²⁷
• Cron-Jobs erhalten dauerhaften Speicher und eine pro Job konfigurierbare Reasoning-Intensität, ergänzt durch aus den Composio-Evaluierungsergebnissen abgeleitete Regeln für die Ausführungsdisziplin und Schutzmechanismen gegen Laufzeitstillstände, Rückfragen mit mehreren Fragen, den opencode-freien Provider ohne Authentifizierung sowie Desktop-Performanceverbesserungen (Paint-first-Hydration des Bot Mode und React Compiler in beiden Renderern).²³

v0.20.6 (Tag v2026.8.27, 27. August — ca. 1.313 Commits und ca. 525 PRs seit v0.20.5):

Das Release bezeichnet sich ausdrücklich als „Patch release. This tag rolls up the ~525 PRs merged since v0.20.5 into a stable tagged release for downstream consumers“. Laut eigener Beschreibung umfasst das Zeitfenster etwa 1.313 Commits in rund 1.557 Dateien (+177.113 / −21.682) — etwa 525 zusammengeführte PRs.³⁰ Die wichtigsten Punkte aus dieser Beschreibung:

• Zustimmungspflichtiges Browsen mit dem echten profile — beim lokalen Browsen kann Ihr standardmäßiges Chromium-profile verwendet werden, unter Windows mit einem zustimmungspflichtigen Ablauf zum Schließen.³⁰
• Der Desktop-Browser erhält ein eigenes Betriebssystemfenster, ergänzt durch eine verwaltete SSH-Engine für Remote-Updates und eine profile-Leiste für Flotten.³⁰
• Erweiterter Remote-MCP-Katalog: mehr als 50 im Livebetrieb geprüfte, von Anbietern gehostete Server, darunter Cloudflare, Grafana Cloud, Better Stack und Railway.³⁰
• Optionale Verschlüsselung gespeicherter Geheimnisse über den Betriebssystem-Schlüsselbund — keine macOS-Schlüsselbundabfragen mehr bei jedem Start.³⁰
• Neue Modelle in den Auswahlmenüs: GLM-5.3-Flash, MiniMax M3 free und MiniMax H3 Max video.³⁰
• TTL-Ergebniscaching für web_search/web_extract und tool_search mit mehreren Abfragen und Wortstammerkennung.³⁰
• Lean-tail-Komprimierung ist jetzt die Standardeinstellung — der nachfolgende Abschnitt Kontextkomprimierung dokumentiert die Konfiguration zum Zeitpunkt des Tags.³⁰³¹
• Terminal-Backends sind jetzt austauschbar — siehe Terminal-Backends.³⁰³²
• Transparenz bei Updatern und Flotten: Updater pausieren gateways über den Kontroll-Socket, anstatt deren Prozessbäume zu beenden, und über Images oder Pakete verwaltete Installationen verweigern unsichere direkte Aktualisierungen.³⁰
• Dauerhafte Bestätigungen von cron-Vorfällen mit klareren Fehlermeldungen bei unterschiedlichen Codeversionen, Steuerungsmöglichkeiten für Link-Vorschauen in Slack und gemeinsam genutzte Docker-Containeridentitäten.³⁰

Der Aktualisierungsvorgang bleibt unverändert: hermes update für eine bestehende Installation oder das Shell-Installationsprogramm für eine Neuinstallation.⁵⁸²³³⁰

Neues in v0.19.0 (The Quicksilver Release)

Hermes Agent v0.19.0 (Tag v2026.7.20, 20. Juli 2026) ist nach der Schnelligkeit des Götterboten selbst benannt: Im Mittelpunkt des Releases steht kompromisslose Reaktionsfähigkeit – mit einer um etwa 80 % kürzeren Zeit bis zum ersten Token beim ersten Durchlauf auf allen Plattformen. Hinzu kommen Abrechnungsfunktionen im Terminal, Passwortmanager als Quellen für Geheimnisse, standardmäßig aktivierte intelligente Genehmigungen, beobachtbare Subagents und eine ausfallsichere Antwortzustellung. Seit v0.18.0 gab es mehr Änderungen als in jedem bisherigen Release-Zeitraum des Projekts: etwa 2.245 Commits, rund 1.065 zusammengeführte PRs, ungefähr 3.300 geschlossene Issues und mehr als 450 Mitwirkende aus der Community.⁶⁰

• Überall etwa 80 % schneller bis zum ersten Token. Die Zeit vom Absenden bis zur Verarbeitung sank beim Kaltstart im CLI, gateway, TUI, Desktop und cron gleichermaßen von etwa 4,3 s auf rund 0,9 s – die Discord-Funktionserkennung wurde aus dem kritischen Pfad entfernt, die Ollama-Prüfung wird bei bekannten Nicht-Ollama-Anbietern übersprungen und blockierende Arbeit aus der Agenteninitialisierung beseitigt. Auch die wahrgenommene Latenz wurde optimiert: Reasoning-Modelle streamen ihre Gedankengänge jetzt standardmäßig live (display.show_reasoning ist aktiviert), und das Antwortfeld wird mit jedem Token statt erst nach jeder Zeile aktualisiert.⁶⁰
• Rendering-Optimierungen für Desktop und TUI. Die Desktop-App erhielt mit etwa 20 PRs eine umfassende Geschwindigkeitsoptimierung: 14-mal weniger CPU-Auslastung im Streaming-Markdown-Splitter dank inkrementeller Blockanalyse, virtualisierte Diffs im Prüfbereich, schnelles Wechseln zwischen Sitzungen auch bei umfangreichen Transkripten sowie keine erneuten Render-Vorgänge der Seitenleiste und Werkzeugzeilen mehr bei jedem Token. Die TUI rendert gestreamtes Markdown nun blockweise und inkrementell.⁶⁰
• Installationen über pip und Homebrew sind veraltet. Beide Wege wurden als „nicht unterstützte Legacy-Installationen“ gekennzeichnet und sollten entfernt werden. Diese Entfernung ist inzwischen mit v0.20.0 erfolgt – die Kanäle brew und pip/PyPI wheel wurden eingestellt; unterstützt werden nur noch das Shell-Installationsprogramm, Docker und Nix.⁶⁰⁵⁹
• Geheimnisse können aus Ihrem Passwortmanager stammen. Eine neue, erweiterbare SecretSource-Schnittstelle ruft Geheimnisse beim Laden aus Bitwarden und 1Password (op://-Referenzen) ab. Mehrere Tresore lassen sich gleichzeitig verwenden; dabei gelten eine deterministische Prioritätsreihenfolge, Konfliktwarnungen und Herkunftsangaben für jede Variable – API-Schlüssel müssen somit nicht mehr in einer unverschlüsselten .env-Datei gespeichert werden. Weitere Tresoranbieter lassen sich künftig als Plugins ergänzen.⁶⁰
• Intelligente Genehmigungen sind jetzt Standard. Wenn Hermes einen gekennzeichneten Befehl ausführen möchte, bewertet ihn ein unabhängiger LLM-Prüfer, statt Sie bei jedem einzelnen Befehl zur Bestätigung aufzufordern – und jedes Urteil gilt ausschließlich für genau diesen Befehl. Benutzerdefinierte Ablehnungsregeln blockieren übereinstimmende Befehle selbst im YOLO-Modus, mit /deny <reason> übermitteln Sie den Grund Ihrer Ablehnung, damit der Agent seinen Kurs korrigieren kann, und die pre_tool_call-Genehmigungsaktion des Plugins – nun wieder mit Regelschlüsseln verfügbar – leitet einen Werkzeugaufruf zur menschlichen Freigabe weiter.⁶⁰
• Abrechnung im Terminal: /subscription und /topup. Verwalten Sie Ihren Nous Portal-Tarif, ohne das Terminal zu verlassen: Sehen Sie Ihren Tarif und das verbleibende Kontingent ein, prüfen Sie vorab die genauen Kosten eines Upgrades oder den Zeitpunkt, zu dem ein Downgrade wirksam wird, und wenden Sie die Änderung mit Rückgängig-Option an. Die Desktop-App erhält einen entsprechenden Reiter für Abrechnungseinstellungen.⁶⁰
• Beobachten Sie Subagents bei der Arbeit und verlieren Sie nie wieder eine fertige Antwort. Aufrufe von delegate_task geben Dateien mit Live-Transkripten zurück, die Sie unmittelbar nach dem Start der Subagents mit tail -f verfolgen können – jeder Werkzeugaufruf, jedes Ergebnis und jede gestreamte Antwort erscheinen in einem menschenlesbaren Protokoll pro untergeordnetem Agenten. Abschlüsse delegierter Hintergrundaufgaben bleiben über Neustarts hinweg erhalten. Abschließende gateway-Antworten werden zudem in einem Zustellungsverpflichtungsregister in state.db erfasst und beim nächsten Start erneut zugestellt, falls der gateway während des Sendens ausfällt. Die Konfigurationsoption max_async_children ist zugunsten einheitlicher Parallelitätsgrenzen für Delegierungen veraltet.⁶⁰
• Ein gateway, viele profile. Ein einzelner multiplexierter gateway, der ein gemeinsames Bot-Token verwendet, kann bestimmte Guilds, Kanäle oder Threads verschiedenen profiles zuordnen – jeweils mit vollständig isolierter Konfiguration sowie eigenen skills, Speicherinhalten und Geheimnissen. Eine Überschreibung ist über GATEWAY_MULTIPLEX_PROFILES möglich. Der Routing-Index wurde nach state.db verschoben; sessions.json dient jetzt nur noch als optionaler Legacy-Spiegel.⁶⁰
• Neue Anbieter und Modelle. Fireworks AI erhält vollständige Unterstützung einschließlich Kostenschätzung und Platz 2 in der Anbieterauswahl; hinzu kommen DeepInfra und Upstage Solar. Die Kataloge werden um GPT-5.6 (Sol/Terra/Luna + Pro, vollständig integriert), grok-4.5 (GA), kimi-k3 (kimi-k2.x wurde eingestellt) und das vollständig integrierte Claude Sonnet 5 erweitert. Mit dem anbieterspezifischen Flag enabled: false und der Konfiguration excluded_providers lassen sich ungenutzte Anbieter aus den /model-Auswahllisten und der Modellauflösung entfernen.⁶⁰
• Der Reasoning-Aufwand wird einstellbar. Die neuen Aufwandsstufen max und ultra stehen auf allen Oberflächen zur Verfügung. Hinzu kommen modellspezifische Überschreibungen in der Konfiguration, ein individueller Aufwand pro Slot in MoA-Voreinstellungen – Berater denken gründlich, während die Synthese schnell bleibt –, ein aufgabenspezifischer Aufwand für Hilfsmodelle sowie ein sitzungsbezogener /reasoning-Befehl im CLI.⁶⁰
• Oberflächen für CLI und MCP. hermes sessions export exportiert Markdown, Quarto, HTML, reine Prompts und Hugging Face-Traces; mit der optionalen Einstellung --redact werden vertrauliche Inhalte bereinigt. /model --once überschreibt das Modell für einen einzelnen Durchlauf, Slash-skill-Aufrufe lassen sich kombinieren (/skill-a /skill-b do XYZ), --safe-mode unterstützt die Fehlerdiagnose, hermes config get/unset vervollständigen die Konfigurationsverwaltung, hermes serve wird zu einem echten Headless-Backend und MCP-Werkzeuge übernehmen die Namenskonvention mcp__server__tool.⁶⁰

Wenn Sie von v0.18.x aktualisieren, sollten Sie vor allem 2 Änderungen beachten: Installationen über pip oder Homebrew werden nun als nicht unterstützte Legacy-Installationen bemängelt – wechseln Sie zum Einzeilen-Installationsprogramm – und max_async_children ist zugunsten einheitlicher Parallelitätsgrenzen für Delegierungen veraltet. Alle anderen Änderungen sind Ergänzungen. Die wichtigsten Gründe für ein Upgrade sind die um etwa 80 % geringere Latenz beim ersten Durchlauf, intelligente Genehmigungen und das Zustellungsregister, das fertige Antworten vor Verlusten durch Abstürze schützt.

Neues in v0.18.0 (The Judgment Release)

Hermes Agent v0.18.0 (Tag v2026.7.1, 1. Juli 2026) ist nach dem Urteilsvermögen benannt: Der Agent überprüft seine eigene Arbeit, statt lediglich Erfolg zu melden, und sein Ensemble-Reasoning lässt sich tatsächlich nachvollziehen. Zudem wird der gesamte P0/P1-Rückstand abgearbeitet – etwa 692 Aufgaben mit höchster Priorität wurden innerhalb von 12 Tagen gelöst.²²

• Mixture-of-Agents als vollwertiges Modell. MoA kann nun wie jedes andere Modell auf allen Oberflächen ausgewählt werden, wobei das Ensemble-Reasoning sichtbar bleibt: Die vollständige Ausgabe jedes Referenzmodells erscheint als eigener beschrifteter Block und die Antworten werden live gestreamt – Sie können dem Ensemble beim Denken zusehen, statt lediglich eine undurchsichtige zusammengeführte Antwort zu erhalten.²²
• Abschlussverträge für /goal. Bevor der Agent ein Ziel als abgeschlossen meldet, überprüft er seine eigene Arbeit, indem er die Prüfungen des Projekts ausführt, statt einfach Erfolg zu behaupten – Urteilsvermögen auf sich selbst angewandt.²²
• /learn – beschreiben Sie etwas und machen Sie daraus ein skill. Verwandeln Sie einen Arbeitsablauf in ein wiederverwendbares skill, indem Sie ihn beschreiben; generierte skills entsprechen automatisch den Konventionen in CONTRIBUTING.md des Repositorys.²²
• /journey-Zeitleiste. Ein visueller Verlauf von Speicherinhalten und skills im Zeitverlauf einschließlich Bearbeitungsfunktionen sowie ein Speichergraph auf dem Desktop.²²
• Parallele Verteilung auf Hintergrund-Subagents. Delegieren Sie mehrere Aufgaben, die gleichzeitig ausgeführt werden, ohne die Unterhaltung zu blockieren – aus dem einzelnen Hintergrund-Subagent in v0.17.0 wird eine ganze Flotte.²²
• Desktop Projects. Vollwertige Programmierprojekte mit einem Organisationsmodell aus Projekt, Repository und Lane.²²
• Auf null skalierbarer gateway. Gateways können bei Inaktivität in den Ruhezustand wechseln und das kontrollierte Beenden laufender Aufgaben koordinieren, sodass Bereitstellungen nahtlos erfolgen – besonders relevant für alle, die Hermes als permanent verfügbaren Dienst betreiben.²²
• Unterstützung für Google Vertex AI. Gemini-Zugriff über GCP-Dienstkonten mit automatischer Aktualisierung von OAuth2-Tokens als neuer Bestandteil des Anbieterkatalogs.²²
• Editor-Befehl /prompt. Öffnet $EDITOR, damit Sie mehrzeilige Prompts verfassen können, ohne sich mit der Eingabezeile abzumühen.²²

Wenn Sie von v0.17.x aktualisieren, gibt es hier keine inkompatiblen Änderungen am CLI. Die wichtigsten Gründe für ein Upgrade sind Abschlussverträge – Ziele, die sich selbst überprüfen –, vollwertiges MoA mit nachvollziehbaren Ensembles und /learn zum Erfassen von skills.

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

Hermes Agent v0.17.0 (Tag v2026.6.19, 19. Juni 2026) trägt seinen Namen aufgrund der inzwischen deutlich größeren Reichweite des Agenten – mit neuen Messaging-Kanälen, neuen Modellanbietern und umfassenderer Steuerung von Desktop und Dashboard. Die Version erweitert v0.16.x; die CLI-Oberfläche bleibt unverändert.²¹

• Neue Messaging-Kanäle. iMessage funktioniert nun über Photon Spectrum (Gerätecode-OAuth, hermes photon login) ohne Mac-Relay; die WhatsApp Business Cloud API ist ein offizieller Meta-Adapter, der keinen Bridge-Prozess mehr erfordert; SimpleX unterstützt jetzt Gruppen, native Anhänge, Textbündelung und automatische Annahme; außerdem kommt Raft als gebündeltes Plattform-Plugin mit einem durch Datenschutzvorgaben abgesicherten Wake-Channel-Konzept hinzu.²¹
• Neue Modelle und Anbieter. Der Katalog wurde um z-ai/glm-5.2 (1 Mio. Kontext), anthropic/claude-fable-5, laguna-m.1, nemotron-3-ultra und grok-composer-2.5-fast (das Cursor-Modell über xAI OAuth, 200.000 Kontext) erweitert. 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. Die Desktop-App erhält Hintergrund-Subagenten, deren delegierte Aktivitäten über Live-„Watch-Windows“ gestreamt werden (delegate_task(background=true)), einen Composer-Modellselektor, neu belegbare Tastenkürzel, native Betriebssystembenachrichtigungen, eigene Composer-Entwürfe pro Thread, Themes aus dem VS Code Marketplace sowie eine Benutzeroberfläche auf Japanisch und traditionellem Chinesisch. Das Dashboard bietet einen vollständigen profile-Builder (Modelle/skills/MCPs ohne Bearbeitung von config.yaml), einen globalen profile-Umschalter, einen überarbeiteten Skills Hub mit Sicherheitsprüfung, Automation Blueprints (parametrisierte Vorlagen für Formulare, Slash Commands, Unterhaltungen und Dokumentation) sowie eine sichere Anmeldung, die hinter dem OAuth-Gate den Statuscode 401 zurückgibt.²¹
• Skills und Tools. image_generate kann nun bei jedem unterstützten Bildanbieter ein Ausgangsbild bearbeiten und transformieren, statt ausschließlich neue Bilder zu erzeugen; das memory-Tool wurde um ein operations-Array ergänzt, das atomare Batch-Vorgänge zum Hinzufügen, Ersetzen und Entfernen in einem einzigen Aufruf ermöglicht; ein neuer simplify-code-skill führt parallel eine Überprüfung und Bereinigung durch drei Agenten aus, die durch eine Chesterton’s-Fence-Risikostufe abgesichert ist; zudem ersetzt der boolesche Wert write_approval den dreistufigen write_mode.²¹
• Architektur. Hintergrund-Subagenten geben sofort ein Handle zurück und speisen ihr Ergebnis als neuen Turn wieder ein; ein MCP-Elicitation-Handler ermöglicht Bestätigungen während eines Tool-Aufrufs, und erst später verbundene MCP-Tools werden zwischen Turns bereitgestellt, ohne die Cache-Sicherheit zu beeinträchtigen; cron wird zu einem austauschbaren CronScheduler mit Chronos als Managed-cron-Anbieter; außerdem können Administratoren über einen neuen Managed scope (/etc/hermes) für Benutzer unveränderliche Konfigurationen festlegen. Hinzu kommt ein Gateway-Gateway-Relay für Topologien mit mehreren gateways.²¹
• Neue Befehle. /version, /billing (interaktive Abrechnung im Terminal), hermes photon login (iMessage-Authentifizierung) und hermes curator run --consolidate – die Konsolidierung muss jetzt ausdrücklich aktiviert werden, sodass die routinemäßige Hintergrundkuratierung keine Token verbraucht.²¹
• Sicherheit. v0.17.0 schließt eine Umgehungsmöglichkeit der Denylist für Shell-Escapes, bricht bei fehlenden Genehmigungsmodulen und Gateway-Adaptern mit eigenen Richtlinien sicher ab, bereinigt die Umgebung für Unterprozesse von cron-Auftragsskripten, schwärzt Geheimnisse in Debug-Dumps von Anfragen, prüft MCP-stdio-Konfigurationen auf Exfiltrationsmuster und aktualisiert urllib3 sowie PyJWT, um CVEs zu beheben.²¹

Wenn Sie von v0.16.x aktualisieren, gibt es hier keine inkompatiblen Änderungen an der CLI; hinzu kommen lediglich neue Kanäle, Modelle und Oberflächen rund um denselben Agenten. Die wichtigsten Gründe für ein Upgrade sind iMessage ohne Relay, die offiziellen WhatsApp-Adapter und der Managed scope für Administratoren.

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

Hermes Agent v0.16.0 (Tag v2026.6.5, 5. Juni 2026) ist nach den neuen Oberflächen benannt, die den auf die CLI ausgerichteten Agenten zugänglich machen. Die wichtigste Neuerung: Hermes ist nicht mehr auf das Terminal beschränkt.²⁰

• Native Desktop-App. Hermes Desktop ist eine neue Electron-App für macOS, Linux und Windows, die sich mit einem Klick installieren und direkt in der App aktualisieren lässt. Sie bietet Ihnen ein Chatfenster mit Streaming, Drag-and-drop-Dateien, das Einfügen von Bildern aus der Zwischenablage, eine Cmd+K-Palette, eine Sitzungsliste mit Archivierung und Suche sowie einen Modellselektor in der Statusleiste. Über einen sicheren WebSocket kann sie eine Verbindung zu einem entfernten Hermes gateway herstellen und sich per OAuth oder Benutzername und Passwort authentifizieren. Dabei unterstützt sie eigene Remote-Hosts pro profile sowie gleichzeitige Sitzungen mit mehreren profiles, die durch profile-übergreifende @session-Verweise miteinander verknüpft werden können. Die Desktop-Benutzeroberfläche enthält über eine typisierte i18n-Schicht (display.language; Englisch bleibt die Standardsprache) zudem eine vollständige Übersetzung ins vereinfachte Chinesisch (简体中文).²⁰
• Browserbasiertes Administrationspanel. Das lokale Web-Dashboard wurde von einer Statusansicht zu einem vollständigen Administrationspanel ausgebaut: mit einem MCP-Katalog samt Schaltern zum Aktivieren und Deaktivieren, Anmeldedatenverwaltung, Erstellung von Webhooks und Hooks, Speicherkonfiguration, Gateway-Steuerung sowie einer Systemseite mit Prüfung vor Aktualisierungen und Debug Share per Klick. Auf einer neuen Kanalseite lassen sich alle Messaging-Plattformen des gateways (Telegram, Discord, Slack und die übrigen) im Browser konfigurieren. Die Authentifizierung ist nun austauschbar und unterstützt die Anmeldung mit Benutzername und Passwort, einen generischen selbst gehosteten OIDC-Anbieter, hermes dashboard register für einen selbst gehosteten OAuth-Client sowie die Rotation von Sitzungen per Refresh-Token.²⁰
• Neue CLI- und Slash Commands. /undo [N] setzt die letzten N Benutzer-Turns mit Vorbelegung und Soft-Delete zurück und funktioniert in der CLI, der TUI sowie auf allen Messaging-Plattformen. Eine konfigurierbare Standardschnittstelle (cli oder tui) mit einer --cli-Überschreibung kommt hinzu; die TUI erhält einen einheitlichen /model-Befehl und ein Sitzungs-Overlay. hermes portal ist ein verständlicher Alias für den Onboarding-Ablauf im Nous Portal, der beim ersten Start nun Quick Setup und Full Setup anbietet. Ergänzt werden außerdem die beiden Diagnosebefehle hermes prompt-size und hermes sessions optimize.²⁰
• Neue Modelle und Anbieter. Der Selektor wurde um deepseek-v4-flash, MiniMax-M3 (1 Mio. Kontext, native MiniMax-Anbieter), qwen3.7-plus (Nous + OpenRouter) und gemini-3.5-flash (Gemini OAuth + API-Schlüssel) erweitert. Ein vollwertiger xAI-Grok-OAuth-Anbieter kommt zum Desktop-Launcher hinzu, der Modellselektor unterstützt nun auf allen Oberflächen die unscharfe Suche, Anbieter mit mehreren Endpunkten werden in einer Zeile gruppiert, und der Katalog wird nicht mehr täglich, sondern stündlich aktualisiert.²⁰ (Seit v0.21.1 gilt erneut ein anderer Rhythmus: Die Remote-Kataloge des Selektors werden alle 20 Minuten aktualisiert, model_catalog.ttl_minutes.⁴⁶)
• Schlankere skills und schrittweise Offenlegung. Redundante und nicht mehr funktionsfähige skills wurden aus dem Standardsatz entfernt (Spotify wurde in ein natives Plugin verschoben, Linear in hermes mcp install linear, und mehrere veraltete Einträge wurden gelöscht), weitere skills sind nun optional, und ein environments:-Relevanzfilter im Frontmatter (kanban/docker/s6) hält kontextspezifische skills aus dem Index heraus, bis sie angefordert werden. NVIDIA/skills ist jetzt neben OpenAI, Anthropic und HuggingFace standardmäßig eine vertrauenswürdige Skills-Hub-Quelle. MCP- und Plugin-Tools unterstützen nun die schrittweise, bereichsbezogene Offenlegung von Tools; außerdem wurde ein MCP-Fehler behoben, der fälschlicherweise eine erfolgreiche OAuth-Authentifizierung meldete, obwohl kein Token abgerufen worden war.²⁰
• Sicherheit. v0.16.0 schreibt eine gepatchte Starlette-Version (≥1.0.1) für CVE-2026-48710 (BadHost) fest, verlagert SSRF-URL-Prüfungen in asynchronen Pfaden aus der Ereignisschleife, entfernt das Bedrock-Inference-Bearer-Token aus der Umgebung von Unterprozessen, fügt bws_cache.json zur Dateisicherheits-Lesesperre und docker restart/stop/kill zur Liste gefährlicher Muster hinzu und bereinigt unsichtbare Unicode-Zeichen in geprüften skill-Inhalten. Mit diesem Release wurden 2 P0- und 62 P1-Probleme geschlossen, davon 16 mit Sicherheitskennzeichnung.²⁰

Wenn Sie von v0.15.x aktualisieren, handelt es sich bei keiner dieser Neuerungen um eine inkompatible Änderung an der CLI selbst; vielmehr kommen zusätzliche Oberflächen und Anbieter rund um denselben Agenten hinzu. Wenn Sie Hermes für Benutzer ohne Terminalzugang bereitstellen oder ein entferntes gateway über einen Browser verwalten möchten, sind die Desktop-App und das Administrationspanel die entscheidenden Gründe für ein Upgrade.

Was ist neu in v0.14.0 (The Foundation Release)

Bei v0.14.0 steht weniger eine einzelne herausragende Funktion im Vordergrund als vielmehr die Vereinfachung der Einrichtung und die Erweiterung der Einsatzmöglichkeiten von Hermes.¹⁹ Die wichtigsten betrieblichen Änderungen:

• Installation und Start sind schlanker. pip install hermes-agent funktioniert über PyPI, umfangreiche Adapter werden bei der ersten Verwendung nachinstalliert, und im Startpfad werden genügend Aufgaben verzögert, um den Kaltstart um etwa 19 Sekunden zu verkürzen. (Seit v0.19.0 gelten pip-Installationen als veraltet – siehe Installation.)
• Abonnements können zu lokalen API-Endpunkten werden. hermes proxy verwandelt durch OAuth gestützte Anbieter wie Claude Pro, ChatGPT Pro und SuperGrok in einen OpenAI-kompatiblen lokalen Endpunkt für Tools wie Codex, Aider, Cline und Continue.
• Die Reichweite des gateways wächst. LINE und SimpleX Chat kommen zum gateway hinzu (die Plattformvergleichstabelle der Dokumentation führt beim Tag v2026.8.31 28 Plattformen auf; der Abschnitt Messaging Gateway erläutert, was in dieser Zahl enthalten ist), Microsoft Teams ist durchgängig angebunden, das Nachladen des Discord-Verlaufs ist standardmäßig aktiviert, und clarify-Abfragen in Telegram und Discord verwenden nun native Schaltflächen.
• Die Überprüfung nach Schreibvorgängen wird verbessert. Nach Änderungen kann Hermes pro Turn Zusammenfassungen der Dateimutationen und semantische Diagnosen des Language Servers vor dem nächsten Turn anzeigen. Dadurch nähert es sich stärker einer evidenzbasierten Agentenarbeit an.
• Desktop- und Medien-Tools werden erweitert. computer_use funktioniert über cua-driver auch für Anbieter außerhalb von Anthropic, video_generate wird hinter austauschbaren Backends vereinheitlicht, und vision_analyze sendet rohe Pixeldaten an Modelle, die tatsächlich Bilder verarbeiten können.

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 gelten inzwischen als „nicht unterstützte Legacy-Installationen“. Hermes warnt auf allen Oberflächen davor, sobald eine solche Installation erkannt wird, blockiert sie jedoch nicht. Die Veröffentlichung über PyPI und Homebrew soll eingestellt werden. Wenn Sie Hermes über pip oder brew installiert haben, wechseln Sie zum oben genannten Installer.⁶⁰

Funktioniert unter Linux, macOS, WSL2 und Android/Termux (der Installer erkennt Termux automatisch und verwendet ein getestetes Android-Paket).⁷ Native Windows-Unterstützung ist inzwischen eine Tier-1-Plattform und nicht mehr die frühe Betaversion, die mit v0.14.0 ausgeliefert wurde. Installieren Sie Hermes dort mit iex (irm https://hermes-agent.nousresearch.com/install.ps1). Auf eine Einschränkung weist die Dokumentation ausdrücklich hin: Unter macOS wird nur Apple Silicon unterstützt; Intel-Macs werden nicht unterstützt.⁵⁹ Historisch betrachtet führte v0.14.0 die native Windows-Unterstützung als frühe Betaversion über einen PowerShell-Installer ein. Für den Produktiveinsatz bleibt WSL2 jedoch die sicherere Empfehlung, bis der Windows-Installationsweg ausgereifter ist.¹⁹

Nach Abschluss der Installation:

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

Die einzige Voraussetzung ist git. Der Installer richtet automatisch Python 3.11 über uv ein (kein sudo erforderlich), außerdem Node.js 26 (für die Browserautomatisierung und die WhatsApp-Bridge), ripgrep und ffmpeg. Seit v0.20.0 ist mindestens Node 26 erforderlich: Der Installer lehnt ältere Versionen ab und installiert stattdessen eine von Hermes verwaltete Node-Version.⁵⁹⁷

Installation überprüfen

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

hermes doctor zeigt Ihnen genau, was fehlt und wie Sie das Problem beheben können.⁷ Wenn Sie Hilfe benötigen, können Sie die Ausgabe von hermes dump in ein GitHub-Issue oder einen Discord-Thread einfügen. Der Diagnosebefehl erstellt eine Klartextübersicht Ihrer gesamten Einrichtung, in der geheime Daten unkenntlich gemacht sind.⁸

Manuelle Installation

Wenn Sie vollständige Kontrolle benötigen – etwa über eine benutzerdefinierte Python-Version, bestimmte Extras oder die Integration mit Nix/NixOS –, finden Sie den manuellen Ablauf Schritt für Schritt in der Installationsanleitung des Upstream-Projekts.⁷ Die wichtigsten optionalen Extras, die Sie mit uv pip install -e ".[<extras>]" kombinieren können:

Der Installationsbefehl für Termux ist anders – er verwendet pip mit einer Constraints-Datei statt uv pip:

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

Der Grund dafür ist, dass .[all] unter Android über das Extra voice das Paket faster-whisper einbindet. Dieses hängt von ctranslate2-Wheels ab, die nicht für Android veröffentlicht werden.⁷

Authentifizierung und Provider

Beim Tag v2026.9.7 enthält hermes_cli/models_catalog_static.py in Zeile 311 insgesamt 39 statische CANONICAL_PROVIDERS-Einträge (durch die Aufteilung im September 2026 wurde die Liste aus hermes_cli/models.py ausgelagert; die Einträge selbst blieben unverändert, einschließlich tencent-tokenplan aus v0.21.0) und erweitert diese Liste automatisch aus plugins/model-providers/ (39 mitgelieferte Verzeichnisse; neun davon – actual, alibaba-coding-plan, commandcode, deepinfra, meta-ai, nebius-token-factory, opencode-free, router, upstage – haben keinen statischen Eintrag und werden von der automatischen Erweiterung aufgenommen, da sie den standardmäßigen Authentifizierungstyp api_key verwenden). Auf der Provider-Seite der Dokumentation sind 45 Cloud- und Abonnement-Provider sowie eine Zeile für benutzerdefinierte Endpunkte aufgeführt; lokale und selbst gehostete Server werden separat behandelt (Ollama, vLLM, SGLang, llama.cpp, LM Studio, LiteLLM, ClawRouter und alle OpenAI-kompatiblen Endpunkte).²⁶ Beim Tag v2026.9.24 umfasst die statische Liste weiterhin 39 Einträge, plugins/model-providers/ jedoch nur noch 38 Verzeichnisse: Der schlüssellose Provider opencode-free wurde am 18. September entfernt, da der kostenlose Tarif von OpenCode anonymen Datenverkehr außerhalb des eigenen Clients inzwischen ablehnt.⁵³ Beim Tag v0.21.6 umfasst die statische Liste noch immer 39 Zeilen, während die Anzahl der Verzeichnisse auf 41 gestiegen ist: lmstudio und tencent-tokenhub, die bereits statische Zeilen hatten, erhalten Provider-Verzeichnisse, und solstice, für das keine solche Zeile existiert, wird über die automatische Erweiterung hinzugefügt.⁵⁵ Darüber liegen benutzerdefinierte Endpunkte und drei unterschiedliche Authentifizierungswege. Nachfolgend finden Sie die gesamte Authentifizierungsoberfläche, nach Wegen geordnet, damit Sie den für Ihre Voraussetzungen passenden schnell finden.

Die drei Authentifizierungswege

Jeder Provider in Hermes folgt einem von drei Authentifizierungsmustern:

Weg 1 – API-Schlüssel in .env. Hinterlegen Sie Ihren Schlüssel in ~/.hermes/.env; Hermes liest ihn beim Start ein. Dieser Weg wird von OpenRouter, AI Gateway, z.ai/GLM, Kimi/Moonshot, MiniMax (sowie MiniMax China), Alibaba Cloud/DashScope, Kilo Code, OpenCode Zen, OpenCode Go, DeepSeek, Hugging Face, Google/Gemini und den meisten Drittanbieter-Providern verwendet.² Seit v0.19.0 muss der Schlüssel nicht mehr in einer Klartextdatei liegen: Eine erweiterbare SecretSource-Schnittstelle kann Geheimnisse beim Laden aus Bitwarden oder 1Password (op://-Referenzen) abrufen. Dabei lassen sich mehrere Tresore gleichzeitig nutzen; außerdem gibt es eine deterministische Prioritätsreihenfolge, Konfliktwarnungen und Herkunftsinformationen für jede Variable – .env bleibt die Rückfalloption. (Dies unterscheidet sich vom Bootstrap-Token des Bitwarden Secrets Manager aus v0.15.0, mit dem Provider-Schlüssel hinter einem einzigen Token gebündelt wurden; SecretSource ersetzt die Klartextdatei selbst, und künftige Tresor-Provider lassen sich als Plugins ergänzen.)⁶⁰

Weg 2 – OAuth über hermes model oder hermes auth. Startet einen Gerätecode-Ablauf, öffnet einen Browser und speichert die Zugangsdaten in ~/.hermes/auth.json (vorhandene Zugangsdaten aus Tools wie Claude Code oder Codex CLI lassen sich ebenfalls importieren). Dieser Weg wird von Nous Portal, OpenAI Codex (ChatGPT-Konto), GitHub Copilot und Anthropic (Claude Pro/Max) verwendet.²

Weg 3 – Benutzerdefinierter Endpunkt in config.yaml. Für jede OpenAI-kompatible API – Ollama, vLLM, SGLang, llama.cpp, LM Studio, LiteLLM-Proxy, Together AI, Groq, Azure OpenAI oder Ihren eigenen selbst gehosteten Server. Die Konfiguration erfolgt einmalig über hermes model → Custom endpoint und wird anschließend dauerhaft in config.yaml gespeichert.²

Die vollständige Provider-Matrix

Diese Matrix umfasst die auf der Dokumentationsseite aufgeführten Provider einschließlich des genauen Einrichtungsablaufs für jeden einzelnen. Die Auswahl beim genannten Tag enthält mehr Provider als die Dokumentation (siehe Anzahl oben), und alles, was OpenAI-kompatibel ist, kann über die Zeile für benutzerdefinierte Endpunkte angebunden werden.²²⁶

Anthropic: Drei Authentifizierungsmethoden

Anthropic erhält einen eigenen Abschnitt, da Hermes drei verschiedene Zugangswege zu Claude unterstützt und die Wahl des richtigen entscheidend 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 über hermes model Anthropic OAuth auswählen, bevorzugt Hermes den eigenen Anmeldedatenspeicher von Claude Code, statt das Token nach ~/.hermes/.env zu kopieren. Dadurch bleiben aktualisierbare Claude-Anmeldedaten weiterhin aktualisierbar.² Falls Sie Claude Code bereits auf demselben Computer verwenden, ist dies der sauberste Weg.

So legen Sie Anthropic dauerhaft in config.yaml fest:

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

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

GitHub Copilot: Zwei Modi

Copilot wird in zwei Modi unterstützt: direkte 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. CLI-Fallback gh auth token 5. Anmeldung per OAuth-Gerätecode über hermes model

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

Chinesische AI-Provider (erstklassige Unterstützung)

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

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

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

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

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

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

Basis-URLs lassen sich mit den Umgebungsvariablen GLM_BASE_URL, KIMI_BASE_URL, MINIMAX_BASE_URL, MINIMAX_CN_BASE_URL oder DASHSCOPE_BASE_URL überschreiben.²

Z.AI erkennt den Endpunkt automatisch. Bei Verwendung des Providers z.ai/GLM 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, damit sie innerhalb einer Konversationssitzung an denselben Server geleitet wird und zwischengespeicherte System-Prompts sowie der bisherige Verlauf wiederverwendet werden.² Dies geschieht automatisch; eine Konfiguration ist nicht 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

Mit Anmeldedatenpools können Sie mehrere API-Schlüssel oder OAuth-Token für denselben Provider rotieren – praktisch, um Ratenbegrenzungen auf mehrere Schlüssel zu verteilen, ohne den Code zu ändern.⁶ Die veralteten Befehle hermes login / hermes logout wurden entfernt; verwenden Sie stattdessen hermes auth.⁶

Benutzerdefinierte und selbst gehostete 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 dauerhaft in config.yaml gespeichert, der zentralen Informationsquelle für Hauptmodell, Provider und Basis-URL.² Die veralteten Umgebungsvariablen OPENAI_BASE_URL und LLM_MODEL werden für die Konfiguration des Hauptmodells nicht mehr gelesen – verwenden Sie hermes model oder bearbeiten Sie config.yaml direkt.² (OPENAI_BASE_URL und OPENAI_API_KEY werden weiterhin als Fallback für den zusätzlichen Routing-Pfad 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 aus, wenn genau eines geladen ist – praktisch für lokale Server, auf denen ein einzelnes Modell ausgeführt wird.²

Lokale LLM-Server (Einrichtungsvorlagen)

Die Upstream-Dokumentation enthält vollständige Einrichtungsanleitungen für Ollama, vLLM, SGLang, llama.cpp und LM Studio. Hier finden Sie die wichtigsten Befehle, die Sie tatsächlich ausführen werden. Jeder davon ist darauf ausgelegt, einen funktionsfähigen Endpunkt bereitzustellen, den Hermes verwenden kann.²

Ollama – einfachster lokaler Weg, ohne Konfiguration:

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

Kritischer Stolperstein bei Ollama: Ollama verwendet standardmäßig sehr kurze Kontextlängen (4.096 Token bei weniger als 24 GB VRAM). Sie müssen sie über OLLAMA_CONTEXT_LENGTH oder ein Modelfile erhöhen – der OpenAI-kompatible API akzeptiert keine Kontextlänge vom Client, sodass Hermes sie nicht für Sie festlegen kann.² Legen Sie für die Agent-Nutzung mindestens 16k–32k fest.

vLLM – leistungsstarke Bereitstellung von GPU:

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

Für Tool-Aufrufe sind --enable-auto-tool-choice und --tool-call-parser <name> erforderlich. 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 einfacher Text zurückgegeben.²

SGLang – schnelle Bereitstellung mit RadixAttention zur Wiederverwendung des KV-Caches:

pip install "sglang[all]"
python -m sglang.launch_server \
  --model meta-llama/Llama-3.1-70B-Instruct \
  --port 30000 \
  --context-length 65536 \
  --tp 2 \
  --tool-call-parser qwen

Stolperstein bei SGLang: Der Standardwert für max_tokens beträgt 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 aufzurufen, indem es JSON in seinen Antworttext schreibt – Hermes kann dies jedoch nicht als tatsächliche Tool-Aufrufe parsen.²

LM Studio – Desktop-Anwendung mit GUI:

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

Kritischer Stolperstein bei LM Studio: LM Studio liest die Kontextlänge aus den Modellmetadaten, doch viele GGUF-Modelle geben als Standardwert 2048 oder 4096 an. Legen Sie die Kontextlänge in den LM-Studio-Modelleinstellungen stets ausdrücklich fest – klicken Sie neben der Modellauswahl auf das Zahnradsymbol, setzen Sie „Context Length“ auf mindestens 16384 (vorzugsweise 32768) und laden Sie das Modell neu.²

Benannte benutzerdefinierte Provider

Wenn Sie mit mehreren benutzerdefinierten Endpunkten arbeiten (beispielsweise einem lokalen Entwicklungsserver und einem entfernten GPU-Server), definieren Sie diese in config.yaml als benannte benutzerdefinierte Provider:²

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

Anschließend können Sie während einer Sitzung mit der dreiteiligen Syntax zwischen ihnen wechseln:

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

Sie können benannte benutzerdefinierte Provider auch über das interaktive Menü von hermes model auswählen.²

Erweiterbare Provider-Architektur (v0.13.0+)

v0.13.0 enthält eine ProviderProfile ABC sowie ein Verzeichnis plugins/model-providers/, sodass sich Inferenz-Provider von Drittanbietern ohne Änderungen am Kern integrieren lassen.¹⁸ Wenn ein Provider einen mit OpenAI, Anthropic oder Codex kompatiblen API-Modus unterstützt, können Sie eine Unterklasse von ProviderProfile implementieren, die Authentifizierungspfad, Basis-URL, Modellkatalog und Caching-Header deklariert; Hermes löst sie über denselben runtime_provider.py-Pfad auf, den auch die integrierten Provider verwenden. Diese architektonische Änderung bildet die Grundlage der Provider-Erweiterung in v0.13.0: Statt den Kerncode zu bearbeiten, um einen Provider hinzuzufügen, liefern Sie ein Plugin aus.

OpenAI-kompatibler lokaler Proxy (v0.14.0+)

hermes proxy stellt einen OpenAI-kompatiblen lokalen Endpunkt bereit, dessen Grundlage der OAuth-Provider ist, bei dem Hermes bereits angemeldet ist – Claude Pro, ChatGPT Pro, SuperGrok oder ein anderer kompatibler konfigurierter Provider.¹⁹ Dadurch können Tools, die einen OpenAI-artigen API erwarten, darunter Codex CLI, Aider, Cline, Continue oder benutzerdefinierte Skripte, Ihre abonnementbasierte Hermes-Authentifizierung ohne separaten API-Schlüssel wiederverwenden. Behandeln Sie den Proxy als lokale Entwicklungsinfrastruktur: Binden Sie ihn gezielt ein, machen Sie ihn nicht allgemein zugänglich und berücksichtigen Sie die providerspezifischen Bedingungen.

Erkennung der Kontextlänge

Laut Upstream-Dokumentation werden zwei Einstellungen immer wieder verwechselt:²

• context_length – das gesamte Kontextfenster (kombiniertes Token-Budget für Ein- und Ausgabe, z. B. 1.000.000 für Claude Opus 4.7 oder 200.000 für Sonnet 4.6). Anhand dieses Werts entscheidet Hermes, wann der Verlauf komprimiert wird.
• model.max_tokens – die Ausgabeobergrenze (maximale Anzahl an Token, die das Modell in einer einzelnen Antwort generieren darf). Sie steht nicht mit der Verlaufslänge in Zusammenhang.

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 zur Erkennung von Kontextfenstern eine mehrstufige Auflösungskette: Konfigurationsüberschreibung → benutzerdefinierter Provider pro Modell → persistenter Cache → Endpunkt /models → Anthropic /v1/models → OpenRouter API → Nous Portal → models.dev (von der Community gepflegtes Verzeichnis für mehr als 3.800 Modelle) → Standardrückfallwerte (128K).² Das System berücksichtigt den Provider, sodass dasselbe Modell je nach bereitstellendem Anbieter unterschiedliche Kontextgrenzen haben kann (z. B. bietet claude-opus-4.6 bei direkter Nutzung von Anthropic 1M, bei GitHub Copilot jedoch 128K).²

Intelligentes Modell-Routing: Provider-Rotation und Fallback

Hermes bindet Sie nicht an ein Modell bei einem einzigen Provider. Intelligentes Modell-Routing bezeichnet die Mechanismen, die entscheiden, welcher Provider und welches Modell eine bestimmte Anfrage tatsächlich verarbeitet: Pools mit Zugangsdaten verteilen die Last auf mehrere Schlüssel, ein konfigurierter Fallback übernimmt, wenn das primäre Modell ausfällt, und die nachfolgenden Zusatz-Slots leiten Nebenaufgaben unabhängig von Ihrem Hauptmodell an günstigere Modelle weiter.²⁶ Konfigurieren Sie diese drei gemeinsam – sie machen den Unterschied zwischen einem Agent, der aufgrund einer Ratenbegrenzung zum Stillstand kommt, und einem, der weiterarbeitet.

Pools mit Zugangsdaten. Wenn Sie mehrere API-Schlüssel für denselben Provider besitzen, konfigurieren Sie über hermes auth eine Rotationsstrategie. So verteilen Sie Ratenbegrenzungen auf mehrere Schlüssel.⁶

Fallback-Modell. Konfigurieren Sie ein provider:model-Ersatzmodell, zu dem Hermes automatisch wechselt, wenn Ihr primäres Modell ausfällt (Ratenbegrenzungen, 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 während der Sitzung Modell und Provider, ohne dass Ihre Unterhaltung verloren geht. Er wird höchstens einmal pro Sitzung ausgelöst.² Unterstützte Provider für den Fallback: openrouter, nous, openai-codex, copilot, copilot-acp, anthropic, huggingface, zai, kimi-coding, minimax, minimax-cn, deepseek, ai-gateway, opencode-zen, opencode-go, kilocode, alibaba, custom.²

Zusatzmodelle

Hermes verwendet „Hilfsmodelle“ für Nebenaufgaben: Bildanalyse (Vision), Klassifizierung zur Genehmigung gefährlicher Befehle, Kontextkomprimierung, Generierung von Sitzungstiteln, Einfügen von TTS-Audio-Tags, Zuordnung von skills, MCP-Tool-Dispatch, die Kanban-Spezifizierer-/Dekomponierer-Familie und seit v0.21.6 Sprachdialoge (auxiliary.voice_chat, wobei eine gesprochene Interaktion auf einem schnelleren Modell ausgeführt wird, standardmäßig mit reasoning_effort: none; das Hauptmodell bleibt jedoch erhalten, wenn die Anfrage den Komprimierungsschwellenwert des Sprachmodells überschreiten würde).⁴³⁴⁵⁵ Standardmäßig (auxiliary.*.provider: "auto") wird jede Hilfsaufgabe auf Ihrem Haupt-Chatmodell ausgeführt – also auf demselben Anbieter und Modell, das Sie in hermes model ausgewählt haben. Die Dokumentation weist ausdrücklich darauf hin, dass dies die frühere automatische Erkennung günstiger Anbieter ersetzt: „Frühere Builds wiesen Benutzern von Aggregatoren (OpenRouter, Nous Portal) anbieterseitig ein günstiges Standardmodell zu. Das führte zu unerwartetem Verhalten … auto verwendet nun für alle das Hauptmodell; aufgabenspezifische Überschreibungen in config.yaml haben weiterhin Vorrang.“³⁴ Für den Einstieg müssen Sie nichts konfigurieren; der Nachteil sind die Kosten: Bei teuren Reasoning-Modellen können Hilfsaufgaben spürbare Zusatzkosten verursachen. Weisen Sie einzelne Aufgaben deshalb günstigen, schnellen Modellen zu, wenn dies relevant ist.

Zwei ehemalige Hilfsaufgaben verwenden überhaupt kein LLM mehr: die Webextraktion („web_extract und Browser-Snapshots kürzen lange Inhalte deterministisch und speichern den vollständigen Text für die seitenweise Ausgabe mit read_file – ohne Beteiligung eines LLM“) und die Sitzungssuche (das Tool mit einheitlichem Ausgabeformat gibt Datenbankinhalte direkt zurück). Ihre früheren Blöcke auxiliary.web_extract.* und auxiliary.session_search.* sind nicht mehr in den Standardeinstellungen enthalten. Verbliebene Werte in einer bestehenden config.yaml seien „harmlose Überbleibsel und würden ignoriert“; auch der Slot flush_memories fehlt in den Standardeinstellungen dieses Tags.³⁴

Sie können festlegen, welches Modell und welcher Anbieter für die einzelnen Hilfsaufgaben verwendet werden. Für jeden Hilfs-Slot stehen dieselben Optionen zur Verfügung: provider, model, base_url (sowie api_key, timeout, extra_body und ein aufgabenspezifischer Wert für reasoning_effort).⁴³⁴

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

Weitere spezialisierte Slots folgen demselben Schema: goal_judge (bewertet, ob der /goal-Vertrag erfüllt wurde), curator (der Fork zur Überprüfung der skill-Nutzung), background_review (der Fork zur Selbstverbesserung nach einer Interaktion), review (der Reviewer-Subagent für /review), moa_reference und moa_aggregator (Mixture-of-Agents), memory_query_rewrite sowie monitor. Sie müssen YAML dafür nicht manuell bearbeiten: Führen Sie hermes model aus und wählen Sie „Hilfsmodelle konfigurieren“, um für jede Aufgabe interaktiv ein Modell auszuwählen.³⁴

Die Anbieteroption "main" bedeutet „denselben Anbieter wie mein Haupt-Agent verwenden“ und ist nur innerhalb von auxiliary:, compression: und primären Fallback-Einträgen (fallback_providers: oder dem veralteten fallback_model:) gültig. Für die Einstellung model.provider auf oberster Ebene ist sie nicht zulässig. Wenn Sie einen benutzerdefinierten OpenAI-kompatiblen Endpunkt als Hauptmodell verwenden, legen Sie im Abschnitt model: den Wert provider: custom fest.⁴

Warum das wichtig ist: Da auto bereits Ihr Hauptmodell verwendet, gibt es die frühere Stolperfalle „OpenRouter konfigurieren oder eine unbemerkte Verschlechterung der Hilfsaufgaben riskieren“ nicht mehr – dafür rücken nun die Kosten in den Vordergrund. Wenn Ihr Hauptmodell ein teures Reasoning-Modell ist, leiten Sie die häufig ausgeführten Nebenaufgaben an ein günstiges, schnelles Modell weiter:

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

Konfigurationssystem

Hermes verfügt über ein mehrstufiges Konfigurationssystem. Die Rangfolge zu verstehen, ist entscheidend, da höhere Ebenen niedrigere überschreiben und eine dieser Ebenen eine globale Provider-Registry ist, die in config.yaml nicht sichtbar ist.

Aufbau der Konfigurationsdateien

Laut der Upstream-Dokumentation besteht eine Hermes-Konfiguration aus den folgenden Dateien:⁴

~/.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 im Vergleich zu .env — sind Einstellungen in beiden Dateien festgelegt, hat config.yaml bei nicht geheimen Einstellungen Vorrang.⁴ Dabei gilt: - Geheimnisse (API-Schlüssel, Bot-Tokens, Passwörter) → .env - Alles andere (Modell, Terminal-Backend, Komprimierungseinstellungen, Speicherlimits, toolsets) → config.yaml

Geheimnisse lassen sich in config.yaml mithilfe einer Interpolation im Shell-Stil referenzieren:⁴

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 — damit werden neu hinzugefügte Konfigurationsoptionen erkannt, die in Ihrer Datei noch fehlen.⁶

Konfigurationsrangfolge

Hermes lädt die Konfiguration aus mehreren Quellen. Legen mehrere Quellen denselben Wert fest, setzt sich die Quelle mit der höheren Priorität durch:⁴

1. CLI-Argumente — hermes chat --model anthropic/claude-sonnet-4 (Überschreibung für einen einzelnen Aufruf)
2. Umgebungsvariablen — werden beim Prozessstart angewendet
3. config.yaml — die primäre Einstellungsdatei
4. .env — ausschließlich für Geheimnisse
5. Integrierte Standardwerte — werden verwendet, wenn der Wert nirgendwo anders festgelegt ist

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

Lokalisierung (ab v0.13.0)

Mit v0.13.0 wurden 7 Gebietsschemas für CLI- und gateway-Meldungen eingeführt: Chinesisch (vereinfacht), Japanisch, Deutsch, Spanisch, Französisch, Ukrainisch und Türkisch.¹⁸ v0.14.0 lokalisiert sämtliche gateway-Befehle sowie das Web-Dashboard, ergänzt 8 weitere Gebietsschemas und erhöht deren Gesamtzahl auf 16.¹⁹ Beim Tag v2026.8.31 enthält die Verzeichnisstruktur locales/ 17 Nachrichtenkataloge – Englisch sowie 16 Übersetzungen (af, ar, de, es, fr, ga, hu, it, ja, ko, pt, ru, tr, uk, zh-hant, zh).³³ Die Dokumentation ist derzeit nur auf zh-Hans lokalisiert. Das Gebietsschema wird anhand der Umgebungsvariablen LC_ALL / LANG oder eines expliziten locale:-Schlüssels in config.yaml bestimmt. Englisch bleibt die Standardsprache und die maßgebliche Quelle für jede Zeichenfolge, die von einer Übersetzung noch nicht abgedeckt wird. Mit v0.21.6 werden Sprachen erweiterbar: display.language akzeptiert jede ID, die von den 17 mitgelieferten Katalogen, dem Overlay-Verzeichnis des profile oder einem installierten Plugin-Sprachpaket bereitgestellt wird. hermes config set display.language <id> führt zudem zuerst die Plugin-Erkennung aus, sodass ein gerade installiertes Paket akzeptiert wird. Core- und TUI-Zeichenfolgen bilden separate Ebenen (locales/<lang>.yaml und locales/<lang>.tui.yaml; beim Tag sind 16 TUI-Pakete enthalten).⁵⁵

Profiles — mehrere isolierte Hermes-Instanzen

Profiles ermöglichen Ihnen mehrere isolierte Hermes-Instanzen, jeweils mit eigener Konfiguration, eigenen Sitzungen, skills, eigenem Speicher und eigener gateway-PID. So können Sie eine „geschäftliche Hermes-Instanz“ und eine „private Hermes-Instanz“ parallel betreiben, ohne dass eine auf den Zustand der anderen zugreifen 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 profile erhält ein eigenes HERMES_HOME (standardmäßig ~/.hermes-<name>/), sodass mehrere profiles das gateway gleichzeitig ausführen können, ohne sich gegenseitig zu beeinträchtigen.⁶³

Seit v0.21.2 wird die Isolationsgrenze strenger durchgesetzt: Eine Reihe von Korrekturen schloss tatsächliche profile-übergreifende Datenlecks in Setups mit gebündelten gateways. Dort konnten sekundäre profiles zuvor die Zulassungslisten des Standard-profile übernehmen, Zugangsdaten an dessen Host senden, dessen Vault-Geheimnisse an stdio-MCP-Server weitergeben oder die Dateien .env/auth.json/state.db eines anderen profile an eine MEDIA:-Übermittlung anhängen (#107609-#107630). Wenn Sie mehrere profiles bündeln, ist v0.21.2 der Tag, ab dem die zugesicherte Isolation tatsächlich gewährleistet ist – siehe Neuerungen in v0.21.2.⁴⁸

CLI-Befehle

Dieser Abschnitt dient als Referenz für Praktiker zu den CLI-Befehlen der obersten Ebene. Die maßgebliche, aus dem Code abgeleitete Referenz finden Sie in der upstream bereitgestellten Referenz zu CLI-Befehlen.⁶

Globale Optionen

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

Befehle der obersten Ebene

hermes chat — Der zentrale Einstiegspunkt

Wenn Sie hermes ohne Argumente ausführen, gelangen Sie in den interaktiven Chat. hermes chat ist die explizite Form mit Optionen:⁶

hermes chat -q "Summarize the latest PRs" --oneshot # Answer and exit (without --oneshot, a TTY seeds an interactive session)
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills          # Enable specific toolsets
hermes chat --quiet -q "Return only JSON"           # Programmatic mode
hermes chat --worktree -q "Review repo and open a PR"

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, da gleichzeitig nach Stufe, Sitzungs-ID und Zeitraum gefiltert werden kann.⁶

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-Ausführung, Sitzungslebenszyklus, INFO+) - errors.log — ausschließlich Warnungen und Fehler (eine gefilterte Teilmenge von agent.log) - gateway.log — Aktivitäten des Messaging-gateway (Plattformverbindungen, Ausführung, 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 bei Problemen ausführen sollten. Er prüft die Gültigkeit der Konfiguration, das Vorhandensein von Abhängigkeiten, die Verfügbarkeit von API-Schlüsseln und den Dienststatus. Mit --fix kann er automatische Reparaturen versuchen.⁶

Um Diagnosedaten mit anderen zu teilen, verwenden Sie hermes dump. Der Befehl erzeugt eine kompakte Klartextübersicht mit geschwärzten API-Schlüsseln, die Sie direkt in ein GitHub-Issue oder einen Discord-Thread einfügen können.⁶

Slash Commands

Slash Commands werden innerhalb einer aktiven Chatsitzung (CLI oder Messaging-Plattform) ausgeführt. Sie werden über eine gemeinsame COMMAND_REGISTRY in hermes_cli/commands.py verteilt, weshalb die meisten Befehle auf allen Oberflächen identisch funktionieren.⁹

Sitzungssteuerung

Konfiguration und Modell

Der Befehl /model ist das zentrale Werkzeug, um während einer Sitzung zwischen Anbietern 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 ergänzt /model --once – eine Modellüberschreibung für einen einzigen Durchlauf, nach dessen Antwort automatisch wieder Ihr vorheriges Modell verwendet wird.⁶⁰ Seit dem v0.20.5-Zeitraum unterstützt die /model-Auswahl außerdem eine unscharfe Suche: Sie filtert die Ergebnisse während Ihrer Eingabe.²³³⁵

Tools, Skills und Informationen

Dynamische skill-Slash-Commands

Jedes installierte skill wird automatisch als Slash Command bereitgestellt:⁹

/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor
/excalidraw       # Just the skill name loads it and lets the agent ask what you need

Seit v0.19.0 lassen sich Aufrufe von Slash-skills verketten: /skill-a /skill-b do XYZ lädt beide skills der Reihe nach in einem einzigen Durchlauf, einschließlich Autovervollständigung und Ghost Text für die verketteten Namen.⁶⁰

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

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

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

Präfixabgleich

Befehle unterstützen den Präfixabgleich: Die Eingabe /h wird als /help, /mod als /model aufgelöst. Ist ein Präfix mehrdeutig, gewinnt die erste Registrierung gemäß der Reihenfolge in der Registry. 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, E-Mail, Home Assistant):⁹

• /status — Sitzungsinformationen anzeigen (nicht mehr ausschließlich für Messaging; siehe Sitzungssteuerung)
• /sethome (Alias /set-home) — den aktuellen Chat als Plattform-Home festlegen
• /approve [session|always] — einen ausstehenden gefährlichen Befehl genehmigen
• /deny [reason] — einen ausstehenden gefährlichen Befehl ablehnen. Seit v0.19.0 übermittelt /deny <reason> dem Agenten Ihren Ablehnungsgrund, damit er seinen Kurs korrigiert, statt den Versuch blind zu wiederholen⁶⁰
• /update — Hermes Agent auf die neueste Version aktualisieren
• /commands [page] — alle Befehle und skills seitenweise durchsuchen

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

Tools & Toolsets

Hermes verfügt über ein umfangreiches integriertes Tool-Register, das Websuche, Browserautomatisierung, Terminalausführung, Dateibearbeitung, Speicher, Delegation, RL-Training, Nachrichtenübermittlung, Home-Assistant-Integration und mehr abdeckt.¹⁰ Tools sind in logischen toolsets organisiert, die für jede Plattform aktiviert oder deaktiviert werden können.

Übergeordnete Kategorien

Zu den gängigen Namen von toolsets 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. Dabei wird die Sitzung zurückgesetzt, damit die neue Toolauswahl wirksam wird.⁹

Terminal-Backends

Das Terminal-Tool umfasst sieben integrierte Ausführungs-Backends – und seit v0.20.6 lässt sich diese Auswahl wie die Anbieterauswahl durch Plugins erweitern (siehe unten):¹⁰²⁴

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

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

Plugin-Backends (ab v0.20.6). Drittanbieter von Sandboxes müssen nicht mehr in das zentrale Repository aufgenommen werden: Ein Plugin registriert beim Laden über PluginContext.register_terminal_environment_provider einen TerminalEnvironmentProvider, woraufhin der registrierte Name über terminal.backend genau wie ein integriertes Backend auswählbar wird. Integrierte Namen sind reserviert – das Register weist Anbieter zurück, deren Name mit einem im Repository enthaltenen Backend kollidiert. Ein registriertes Backend wird automatisch in alle zentralen Oberflächen eingebunden (Backendauswahl in hermes setup, Prüfstatus im Dashboard, Überprüfungen durch hermes doctor, Handhabung von Containerpfaden und Arbeitsverzeichnissen sowie Entfernung von Geheimnissen), da der Kern an jeder Klassifizierungsstelle das Register statt einer fest codierten Namensliste abfragt.³²

SSH-Backend (aus Sicherheitsgründen empfohlen – der Agent kann seinen eigenen Code nicht verä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 und 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 Sicherheitshärtung 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-Isolierung und ein persistenter Arbeitsbereich über Volumes.¹⁰

Hintergrundprozesse

Das Terminal-Tool unterstützt die Ausführung im Hintergrund 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, das für die Dauer der Sitzung zwischengespeichert wird. Alternativ können Sie SUDO_PASSWORD in ~/.hermes/.env festlegen.¹⁰

Multi-Agent-Kanban (ab v0.13.0)

v0.13.0 macht die Zusammenarbeit mehrerer Agenten zu einem grundlegenden Konzept: einem dauerhaften Kanban-Board, das Aufgaben, Status und Mitarbeiteridentitäten agenten- und neustartübergreifend verfolgt.¹⁸ Durch das Board kann ein Schwarm von Hermes-Mitarbeitern Aufgaben tatsächlich abschließen, statt an fehlgeschlagenen Übergaben zum Stillstand zu kommen.

Das Kanban-Board lässt sich für die Zielvorgabe nahtlos mit /goal (Ralph-Schleife mit festgeschriebenem Ziel) und für die Erzeugungssemantik mit dem vorhandenen Tool delegate_task kombinieren. Daraus entsteht ein Schwarmmuster, bei dem alle Agenten dieselbe verlässliche Informationsquelle dafür verwenden, was als Nächstes zu tun ist, wer daran arbeitet und wo es Probleme gibt.

Was ist ein Hermes-Schwarm?

Ein Schwarm besteht aus mehreren Hermes-Mitarbeitern, die parallel an einem gemeinsamen Kanban-Board arbeiten. Er ist kein separates Subsystem, das Sie aktivieren müssen – vielmehr wird er durch das Board ermöglicht. Das Board liefert genau das, was parallele Agenten nicht selbst bereitstellen können: eine einzige verbindliche Antwort auf die Frage: Was soll ich als Nächstes übernehmen, und arbeitet bereits jemand daran?

Mit v0.15.0 wurde dieses Muster zu einer unterstützten Topologie ausgebaut. Hinzu kamen eine Schwarmtopologie zur Koordination paralleler Mitarbeiter, die automatische Zerlegung eines übergeordneten Ziels in Teilaufgaben, Modellüberschreibungen pro Aufgabe, geplante Aufgaben und eine Worktree-Verwaltung, damit parallele Mitarbeiter nicht im selben Checkout miteinander in Konflikt geraten.⁶³

Der praktische Ablauf: Geben Sie dem Schwarm ein Ziel, lassen Sie es durch die automatische Zerlegung in Board-Aufgaben aufteilen und die Mitarbeiter diese Aufgaben übernehmen, ausführen und die Ergebnisse zurückgeben. Das Wiederholungslimit gilt pro Aufgabe (max_retries), sodass eine einzelne fehleranfällige Teilaufgabe nicht die Fehlertoleranz des gesamten Durchlaufs aufbraucht. Da das Board dauerhaft ist, übersteht ein Schwarm Neustarts – die Mitarbeiter verbinden sich erneut und setzen ihre Arbeit mit demselben Zustand fort.

Ein Schwarm ist nur so gut wie seine Zerlegung. Das Board koordiniert Mitarbeiter; es verwandelt ein schlecht unterteiltes Ziel nicht in ein gutes. Aufgaben mit gemeinsamem verborgenem Zustand geraten weiterhin miteinander in Konflikt – mit oder ohne Worktrees.

Skills System

Skills sind bei Bedarf abrufbare Wissensdokumente, die der Agent laden kann, wenn er sie benötigt. Sie folgen dem Prinzip der schrittweisen Offenlegung, um den Token-Verbrauch zu minimieren, und sind mit dem offenen Standard agentskills.io kompatibel.¹¹

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

Schrittweise 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 Inhalt eines Skills erst dann, wenn er ihn tatsächlich benötigt.¹¹

SKILL.md-Format

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

# Skill Title

## When to Use
Trigger conditions for this skill.

## Procedure
1. Step one
2. Step two

## Pitfalls
- Known failure modes and fixes

## Verification
How to confirm it worked.

Bedingte Aktivierung

Skills können sich abhängig von den verfügbaren Tools ein- oder ausblenden. Dies ist besonders für Fallback-Skills nützlich – kostenlose oder lokale Alternativen, die nur angezeigt werden sollen, wenn ein kostenpflichtiges Tool nicht verfügbar ist:¹¹

Beispiel: Der integrierte Skill duckduckgo-search verwendet fallback_for_toolsets: [web]. Wenn FIRECRAWL_API_KEY gesetzt ist, steht das Web-toolset zur Verfügung und der Agent verwendet web_search – der DuckDuckGo-Skill bleibt ausgeblendet. Ohne den API-Schlüssel erscheint der DuckDuckGo-Skill automatisch als Fallback.¹¹

Vom Agenten verwaltete Skills

Der Agent kann seine eigenen Skills über das Tool skill_manage erstellen, aktualisieren und löschen. Dies ist das prozedurale Gedächtnis des Agenten: Wenn er einen nicht trivialen Arbeitsablauf ermittelt, speichert er die Vorgehensweise als Skill zur späteren Wiederverwendung.¹¹

Wann der Agent Skills erstellt:¹¹ - Nachdem er eine komplexe Aufgabe (mindestens 5 Tool-Aufrufe) erfolgreich abgeschlossen hat - Wenn Fehler oder Sackgassen aufgetreten sind und er den funktionierenden Weg gefunden hat - Wenn der Benutzer seine Vorgehensweise korrigiert hat - Wenn er einen nicht trivialen Arbeitsablauf entdeckt hat

Aktionen:¹¹

Skill Hub

Durchsuchen, suchen, installieren und verwalten Sie Skills aus Online-Registern:⁶¹¹

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

Standardmäßige GitHub-taps (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 eine Sicherheitsprüfung auf Datenexfiltration, Prompt-Injection, destruktive Befehle, Hinweise auf Lieferkettenangriffe und andere Bedrohungen.¹¹

Vertrauensstufen:¹¹

Mit --force lassen sich nicht gefährliche Richtlinienblockierungen für Community-Skills übergehen. Eine als dangerous eingestufte Sicherheitsprüfung lässt sich damit nicht übergehen.¹¹

Externe Skill-Verzeichnisse

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

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

Pfade unterstützen die Erweiterung von ~ und die Ersetzung von Umgebungsvariablen im Format ${VAR}. Externe Verzeichnisse sind schreibgeschützt – wenn der Agent einen Skill erstellt oder bearbeitet, schreibt er stets nach ~/.hermes/skills/. Existiert ein Skill-Name an beiden Orten, hat die lokale Version Vorrang.¹¹

Angeheftete Skills: skills.auto_load (v0.21.4-Zeitraum)

Skill-Namen, die in config.yaml unter skills.auto_load aufgeführt sind, werden in jeder neuen Sitzung vollständig geladen – für CLI, TUI, gateway, cron und API gleichermaßen:⁵¹

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

Die Liste wird einmalig aufgelöst, wenn der Prompt des Agenten erstmals erstellt wird. Bei einem fehlenden oder deaktivierten Namen wird eine Warnung ausgegeben und der Eintrag übersprungen, statt die Sitzung fehlschlagen zu lassen. HERMES_IGNORE_RULES – der Mechanismus hinter --ignore-rules – unterdrückt die Liste ebenso wie den übrigen automatisch eingefügten Kontext. Dies ergänzt -s/--skills um dauerhafte Vorgaben, während diese Optionen Skills nur für eine einzelne Sitzung vorab laden.⁵¹

Persistenter Speicher

Hermes verfügt über einen begrenzten, kuratierten Speicher, der über Sitzungen hinweg erhalten bleibt. Zwei Dateien bilden den Speicher des Agenten; beide befinden sich unter ~/.hermes/memories/:¹²

Beide werden beim Sitzungsstart als unveränderlicher Snapshot in den System-Prompt eingefügt. Der Agent verwaltet seinen eigenen Speicher über das memory-Tool – mit add, replace oder remove.¹²

Muster des unveränderlichen Snapshots: Die Einfügung in den System-Prompt wird einmal beim Sitzungsstart erfasst und während der Sitzung nicht mehr geändert. Das ist beabsichtigt, da so der Präfix-Cache des LLM für eine bessere Leistung erhalten bleibt. Während einer Sitzung vorgenommene Änderungen werden sofort auf dem Datenträger gespeichert, erscheinen jedoch erst in der nächsten Sitzung im System-Prompt.¹²

Was gespeichert werden sollte

Speichern Sie Folgendes (der Agent erledigt dies proaktiv):¹² - Benutzerpräferenzen: „Ich bevorzuge TypeScript gegenüber JavaScript“ → user - Informationen zur Umgebung: „Auf diesem Server läuft Debian 12 mit PostgreSQL 16“ → memory - Korrekturen: „Verwenden Sie für Docker-Befehle kein sudo, der Benutzer gehört der docker-Gruppe an“ → memory - Konventionen: „Das Projekt verwendet Tabulatoren, eine Zeilenbreite von 120 Zeichen und Docstrings im Google-Stil“ → memory - Abgeschlossene Arbeiten: „Datenbank am 2026-01-15 von MySQL zu PostgreSQL migriert“ → memory

Speichern Sie Folgendes nicht:¹² - Triviale oder offensichtliche Informationen - Leicht erneut ermittelbare Fakten - Unverarbeitete Datenmengen (zu groß für den Speicher) - Sitzungsspezifische, kurzlebige Informationen - Informationen, die bereits in Kontextdateien enthalten sind

Sitzungssuche

Neben MEMORY.md und USER.md kann der Agent mit dem session_search-Tool frühere Unterhaltungen durchsuchen. Alle CLI- und Messaging-Sitzungen werden mit einer FTS5-Volltextsuche in SQLite (~/.hermes/state.db) gespeichert. Seit der Neugestaltung in v0.15.0 kommt das Tool vollständig ohne LLM aus – es gibt gespeicherte Gesprächsinhalte direkt zurück (in der Formulierung der Quelle: Das „single-shape tool returns DB content directly“). Dadurch wurde es 4.500-mal schneller und verursacht keine API-Kosten mehr.¹²⁶³³⁴

Im Veröffentlichungszeitraum von v0.21.4 kamen zwei Ergänzungen hinzu, die beide mit dem Tag v2026.9.21 verifiziert wurden. Erstens Zeitgrenzen: Die Discovery-Struktur akzeptiert after (eine inklusive Untergrenze für die Startzeit der Sitzung) und before (eine exklusive Obergrenze). Beide Werte können als ISO-Datum bzw. ISO-Datum mit Uhrzeit angegeben werden – ein reiner Datumswert bedeutet Mitternacht UTC an diesem Tag – oder als relative Dauer (7d, 24h, 2w). Sie sind nur für Abfragen vorgesehen, die tatsächlich einen Zeitraum nennen; sort bleibt eine Gewichtung der Rangfolge und keine Grenze. Zweitens gibt es einen erneuten Abrufversuch bei null Ergebnissen: Da FTS5 zwischen Begriffen implizit AND verwendet, kann eine umformulierte Abfrage mit mehreren Wörtern einen gespeicherten Satz verfehlen, sobald auch nur eines dieser Wörter darin fehlt. Liefern daher sowohl die exakte Abfrage als auch sämtliche Teilzeichenketten-Fallbacks keine Ergebnisse, wird der Index erneut mit einer Übereinstimmung für einen BELIEBIGEN Begriff durchsucht. Dabei stehen Zeilen, die mehr Begriffe abdecken, in der Rangfolge weiter oben. Treffer behalten die Semantik exakter Übereinstimmungen bei, da der erneute Versuch nur nach einer Suche ohne Ergebnisse erfolgt; Abfragen mit explizitem OR/NOT, Einzelbegriff-Abfragen und über CJK geleitete Abfragen bleiben unverändert.⁵¹

Externe Speicheranbieter

Für einen umfassenderen persistenten Speicher über MEMORY.md und USER.md hinaus enthält Hermes in v0.21.7 zwei Plugins für externe Speicheranbieter: RetainDB und ByteRover. Sechs weitere lassen sich aus dem Plugin-Katalog installieren: Holographic, das in v0.21.7 aus dem Kernrepository entfernt wurde, Honcho, OpenViking, Mem0 und Supermemory, die in v0.21.6 entfernt wurden, sowie Hindsight, das in v0.21.5 entfernt wurde. Alle sechs sind Community-Einträge, die von ihren jeweiligen Anbietern gepflegt werden.¹²⁵⁵⁵⁷

Hindsight war bis einschließlich v0.21.4 Teil des Kernrepositorys und wurde in v0.21.5 in den Katalog verschoben, wo es von Vectorize gepflegt wird. Honcho, Mem0, OpenViking und Supermemory folgten in v0.21.6, Holographic in v0.21.7. Bestehende Installationen werden selbstständig migriert: Wenn memory.provider einen dieser Anbieter benennt, installiert hermes update das Katalog-Plugin in jedem profile-Stammverzeichnis, in dem dieser Anbieter angegeben ist. Fehlt es anschließend noch, wird es beim ersten Start des Agenten installiert. Bei security.allow_lazy_installs: false protokolliert der Startvorgang des Agenten lediglich eine Meldung; führen Sie daher selbst hermes plugins install <name> aus. Das Plugin wird unter ~/.hermes/plugins/<name>/ abgelegt und zu plugins.enabled hinzugefügt; memory.provider, memory.hindsight.*, HINDSIGHT_API_KEY und Ihre Speicherdaten bleiben unverändert. Überprüfen Sie den Status mit hermes memory status und hermes plugins list. Das pip-Extra hermes-agent[hindsight] wurde entfernt.⁵³

Externe Anbieter werden parallel zum integrierten Speicher ausgeführt und ersetzen ihn niemals. Sie 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 jeweils nur ein externer Anbieter aktiv sein. Der integrierte Speicher ist immer aktiv.⁶

Automatische Sitzungsfortsetzung (v0.13.0+)

Mit v0.13.0 lassen sich Unterbrechungen während der Agentenausführung ohne Sitzungsverlust überstehen. Nach einem Neustart setzt das gateway unterbrochene Sitzungen automatisch fort; Neustarts über /update bewahren den Sitzungsstatus während des Upgrades; beim Neuladen von Quelldateien während der Entwicklung bleibt die aktive Sitzung erhalten, statt eine neue zu erzwingen.¹⁸ In der Praxis bedeutet das: Lang laufende gateway-Aufgaben und cron-gesteuerte Jobs setzen ihr Kontextfenster nicht mehr zurück, wenn der Prozess neu startet.

Checkpoints v2 (v0.13.0+)

Die Statuspersistenz wurde in v0.13.0 als Single-Store-Konzept mit echter Bereinigung, Schutzmechanismen für den Datenträger und ohne verwaiste Schattenrepositorys neu implementiert.¹⁸ Das vorherige checkpoint-System sammelte bei lang laufenden profiles immer mehr Statusdaten auf dem Datenträger an. Der v2-Speicher begrenzt die lokale checkpoint-Speicherung strikt und beseitigt die doppelte Buchführung, die dieses Wachstum verursacht hatte. Eine Änderung der benutzerseitigen Konfiguration ist nicht erforderlich; der nächste checkpoint-Schreibvorgang verwendet den v2-Pfad.

Persönlichkeit und SOUL.md

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

Hermes legt automatisch eine standardmäßige SOUL.md unter ~/.hermes/SOUL.md an (bei benutzerdefinierten profiles unter $HERMES_HOME/SOUL.md). Vorhandene Benutzerdateien werden niemals überschrieben. Hermes lädt SOUL.md ausschließlich aus HERMES_HOME und sucht nicht im aktuellen Arbeitsverzeichnis danach. Dadurch bleibt die Persönlichkeit projektübergreifend vorhersehbar.¹³

Was in SOUL.md gehört

Verwenden Sie die Datei für dauerhafte Vorgaben zu Ausdruck und Persönlichkeit:¹³ - Tonalität - Kommunikationsstil - Grad der Direktheit - standardmäßiger Interaktionsstil - stilistisch zu vermeidende Elemente - Umgang von Hermes mit Unsicherheit, Meinungsverschiedenheiten und Mehrdeutigkeit

Verwenden Sie sie weniger für:¹³ - einmalige Projektanweisungen - Dateipfade - Repository-Konventionen - vorübergehende Workflow-Details

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

SOUL.md im Vergleich zu AGENTS.md

Dies ist der wichtigste Unterschied bei der Identitätsverwaltung in Hermes:¹³

SOUL.md – Identität, Tonalität, Stil, Kommunikationsstandards und Verhalten auf Persönlichkeitsebene.

AGENTS.md – Projektarchitektur, Programmierkonventionen, Tool-Präferenzen, Repository-spezifische Workflows, Befehle, Ports, Pfade und Bereitstellungshinweise.

Eine nützliche Regel: Soll etwas Sie überallhin begleiten, 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, zwischen denen Sie mit /personality wechseln können:¹³³³

Benutzerdefinierte Persönlichkeiten in config.yaml:¹³

agent:
  personalities:
    codereviewer: >
      You are a meticulous code reviewer. Identify bugs, security issues,
      performance concerns, and unclear design choices. Be precise and constructive.

Wechseln Sie anschließend mit /personality codereviewer.

SOUL.md im Vergleich zu /personality

SOUL.md bildet die grundlegende Ausdrucksweise. /personality ist eine sitzungsspezifische Überlagerung.¹³ Verwenden Sie eine pragmatische Standardkonfiguration für SOUL.md und nutzen Sie anschließend /personality teacher für ein Lerngespräch 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 von Tools — ohne zusätzliche API-Schlüssel verwalten zu müssen.⁶⁵ Die Hermes CLI selbst bleibt MIT-lizenziert und vollständig quelloffen. Neu ist, dass Ihre Portal-Authentifizierung jetzt mehr als nur Modellinferenz freischaltet.

Der schnellste Einstieg ist hermes setup --portal, das im README als „Ein Befehl nach einer Neuinstallation“ vorgestellt wird: Der Befehl meldet Sie über OAuth an, legt Nous als Ihren Provider fest und aktiviert das Tool Gateway. Anschließend verwalten Sie die Verbindung mit hermes portal. hermes portal login (der Standard, wenn kein Unterbefehl angegeben wird) führt dasselbe einmalige Onboarding aus; hermes portal info gibt die „Zusammenfassung der Portal-Authentifizierung und des Tool-Gateway-Routings“ aus; hermes portal open öffnet die Abonnementseite in Ihrem Standardbrowser; hermes portal tools listet die gateway tools auf und zeigt, welche über Nous geroutet werden. hermes portal status bleibt als verborgener Alias für die Abwärtskompatibilität von info erhalten, und in der CLI-Referenz der Dokumentation zum Tag heißt der Unterbefehl weiterhin status, sodass beide funktionieren.²⁸

Was das gateway enthält

Funktionsweise

Das gateway wird für jedes Tool separat aktiviert. Dazu dient das neue Konfigurationsfeld use_gateway. Wenn Sie Portal-Zugangsdaten in hermes auth hinterlegt und das gateway für ein Tool aktiviert haben, werden die Aufrufe dieses Tools über Portal geroutet. Andernfalls wird Ihr direkter API-Schlüssel verwendet, sofern vorhanden.

# config.yaml — per-tool gateway opt-in
tools:
  web_search:
    provider: firecrawl
    use_gateway: true          # route via Nous Portal subscription
  image_generation:
    provider: fal
    use_gateway: true

Laufzeitpriorität: Wenn das gateway verfügbar ist und für ein Tool use_gateway: true festgelegt 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 Portal-Abonnement und nicht dem Guthaben Ihres direkten API-Schlüssels belastet.

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 bereits in hermes auth hinterlegt sind — eine separate Anmeldung ist nicht erforderlich. Seit v0.19.0 können Sie außerdem das Abonnement selbst innerhalb einer Sitzung verwalten: /subscription zeigt Ihren Tarif und das verbleibende Kontingent an, gibt genau an, was ein Upgrade kostet oder wann ein Downgrade wirksam wird, und führt die Änderung mit Hinweisen auf geplante Änderungen und einer Rückgängig-Option durch; mit /topup fügen Sie Guthaben hinzu. Die Desktop-App bietet einen entsprechenden Tab für Abrechnungseinstellungen.⁶⁰

Preise und Zugang

Preise und Tarifbezeichnungen werden auf der Preisseite von Nous Portal (https://portal.nousresearch.com/pricing) veröffentlicht. Dieser Leitfaden führt die Tarife nicht einzeln auf, da sie zum Portal-Produkt und nicht zur Hermes CLI gehören und sich unabhängig von Hermes-Versionen ändern. Registrieren Sie sich unter https://portal.nousresearch.com/ und informieren Sie sich auf der Preisseite über die aktuellen Tarife.

Kostenloser Nous-Tarif und geführter Erststart (v0.21.2+)

Seit v0.21.2 benötigen Sie nach einer Neuinstallation weder einen kostenpflichtigen Tarif noch einen API-Schlüssel, um einen funktionsfähigen Agenten zu erhalten: Kostenlose Inferenz und connectors sind sofort verfügbar, die Anmeldung erfolgt mit einem einzigen Befehl und /login startet die Anmeldung direkt aus einem Chat. Connector-Tools (Gmail, Linear, Notion und weitere) lassen sich wie jedes andere Tool über tool_search durchsuchen. Die Desktop-App bietet hinter HERMES_GUEST_ONBOARDING=1 einen geführten Erststart; nur der exakte Wert 1 aktiviert ihn. Ein eigener Desktop-Test stellt sicher, dass 'true', '0' und ein leerer Wert ihn deaktiviert lassen. Die Startentscheidung wird zudem in die Umgebung des gestarteten Backends geschrieben, sodass ein geerbter Wert niemals unbeabsichtigt übernommen wird.⁴⁸

Seit dem Veröffentlichungszeitraum von v0.21.4 werden diese connectors durch einen einzigen, vom Backend gesteuerten Vorgang verbunden, statt die Logik auf einzelne Frontends zu verteilen: Ein manage_connections-Tool-Aufruf steuert im Backend eine reine Daten-Zustandsmaschine für Verbindungen (mit einem festen Zeitlimit von 300 Sekunden für den Vorgang — bewusst kein Konfigurationsschlüssel), die von Desktop, TUI und CLI einheitlich als dieselbe Einrichtungskarte dargestellt wird. Die Karte zeigt für jede fehlende Zugangsinformation ein Feld an (Name, Eingabeaufforderung, Pflichtangabe) und deaktiviert ihre Aktionsschaltfläche, bis alle Pflichtfelder Text enthalten. Das Backend erzwingt bei jedem Frontend dieselbe Trennung, bei der ausschließlich Geheimnisse übermittelt werden.⁵¹

Hinweis zur Einstellung

• Die Umgebungsvariable HERMES_ENABLE_NOUS_MANAGED_TOOLS wurde in v0.10.0 entfernt. Verwaltete Tools werden jetzt über das toolspezifische Konfigurationsfeld use_gateway aktiviert und anhand des Status Ihres Portal-Abonnements freigegeben.⁶⁵

Einordnung: Was dieses Release nicht ist

Die Hermes Agent CLI ist nicht an ein Abonnement gebunden. Das Projekt bleibt MIT-lizenziert, und alle Kernfunktionen (CLI, skills, memory, messaging gateway, cron, MCP, lokales Dashboard sowie BYOK für jeden Provider) funktionieren vollständig, ohne dass Sie dafür bezahlen müssen. v0.10.0 ergänzt lediglich einen komfortablen Zugangsweg für Benutzer, die bereits für Nous Portal bezahlen — aus dem kostenlosen Nutzungsweg wird nichts entfernt.

Messaging Gateway

Hermes kann als dauerhaft laufender gateway-Prozess betrieben werden, der über einen einzigen gateway-Prozess Verbindungen zu 28 Messaging-Plattformen herstellt: Telegram, Discord, Slack, WhatsApp, Signal, SMS, E-Mail, Home Assistant, Mattermost, Matrix, DingTalk, Feishu/Lark, WeCom, Weixin (WeChat), BlueBubbles (iMessage), QQBot, Microsoft Teams, Tencent Yuanbao, Google Chat, LINE, SimpleX Chat, Photon (iMessage), WhatsApp Cloud API, WeCom Callback, Raft, IRC, ntfy, Buzz und einen generischen Webhook-Adapter.^364171819 Diese Zahl 28 stammt aus der Plattformvergleichstabelle der Dokumentation beim Tag v2026.8.31; darunter definiert gateway/config.py 24 integrierte Platform-Enum-Mitglieder (einschließlich Nicht-Chat-Einträgen wie local, api_server, webhook, msgraph_webhook und relay) und ordnet jeden anderen Namen bei Bedarf einem der 22 gebündelten Adapterverzeichnisse unter plugins/platforms/ zu. Deshalb stimmt eine bloße Zählung der Enum-Mitglieder oder Verzeichnisse nicht mit der Zahl aus der Dokumentation überein.²⁵ v0.9.0 ergänzte iMessage über BlueBubbles (automatische Webhook-Registrierung, Einrichtungsassistent und Ausfallsicherheit) sowie native WeChat-Unterstützung über iLink Bot API mit dem WeCom-Callback-Modus für Unternehmensanwendungen.¹⁶ v0.11.0 ergänzte QQBot.⁶⁴ v0.12.0 ergänzte Microsoft Teams und Tencent Yuanbao.¹⁷ v0.13.0 ergänzte Google Chat als 20. Plattform und nutzt dabei dieselbe erweiterbare Adapterarchitektur; auch IRC und Microsoft Teams wurden auf das neue Adaptermuster mit generischen Plugin-Hooks für env_enablement_fn / cron_deliver_env_var migriert.¹⁸ v0.14.0 ergänzt LINE und SimpleX Chat und vervollständigt den Microsoft-Teams-Stack durchgängig mit Graph-Authentifizierung, Webhook-Listener, Pipeline-Laufzeit und ausgehender Zustellung.¹⁹ v0.17.0 (19. Juni 2026) ergänzt relay-freies iMessage über Photon Spectrum (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.²¹ Zwei weitere erscheinen ohne besondere Erwähnung in den Versionshinweisen in der Dokumentationstabelle: ntfy ist ein schlanker HTTP-Pub/Sub-Push-Kanal (abonnieren Sie ein Thema in der mobilen ntfy-App, senden Sie eine Nachricht an das Thema, um mit dem Agenten zu kommunizieren, und empfangen Sie die Antwort auf Ihrem Telefon; funktioniert mit dem öffentlichen ntfy.sh-Server oder einer selbst gehosteten Instanz, ohne SDK oder Daemon), und Buzz verbindet Hermes mit einer Buzz-Community, der quelloffenen Plattform von Block für die Zusammenarbeit zwischen Menschen und Agenten auf Basis des Nostr-Protokolls. Für ausgehende Nachrichten ruft der Adapter die buzz CLI auf, während er für eingehende Nachrichten ein natives Nostr-WebSocket-Abonnement verwendet. Beide werden über hermes gateway setup eingerichtet.²⁵

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 und Zulassungslisten.⁶ Seit v0.21.6 überprüft der Discord-Schritt das Bot-Token, gibt einen Einladungslink mit den vom Adapter benötigten Berechtigungsbits aus und weist auf einen weiterhin deaktivierten Message Content Intent hin, durch den Discord die Verbindung des Bots ablehnt.⁵⁴⁵⁵

Nachrichtenfluss

Aus der vorgelagerten 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 die CLI. Deshalb funktionieren Slash-Befehle an beiden Stellen identisch, und deshalb kann ein in Telegram geplanter cron-Job seine Ausgabe an Discord zustellen – der Unterschied zwischen den Plattformen besteht lediglich an den Systemgrenzen.³

v0.19.0 ergänzt profilbasierte Nachrichtenweiterleitung und dauerhafte Zustellung. Ein einzelner multiplexter gateway, der ein Bot-Token gemeinsam nutzt, kann bestimmte Guilds, Kanäle oder Threads an unterschiedliche profile weiterleiten – jeweils mit vollständig isolierter Konfiguration, eigenen skills, eigenem Speicher und eigenen Geheimnissen. Dafür steht die Überschreibung GATEWAY_MULTIPLEX_PROFILES zur Verfügung. Dank umfassender Härtungsmaßnahmen kann ein falsch konfiguriertes profile nicht mehr den gesamten gateway zum Absturz bringen. Intern wurde der Weiterleitungsindex nach state.db verschoben (sessions.json ist jetzt eine optionale Legacy-Spiegelung), und endgültige Antworten werden rund um den Plattformversand in einem dauerhaften Verzeichnis offener Zustellungsverpflichtungen erfasst. Tritt nach Fertigstellung einer Antwort ein gateway-Absturz auf, wird sie beim nächsten Start erneut zugestellt, statt unbemerkt verloren zu gehen.⁶⁰ Die Isolation zwischen weitergeleiteten profiles wurde mit v0.21.2 gehärtet. Dadurch wurde speziell in dieser Multiplex-Konfiguration eine Reihe profilübergreifender Datenlecks geschlossen: vererbte Zulassungslisten, an den Host des Standard-profile gesendete Zugangsdaten, Geheimnisse aus dem Vault des Standard-profile, die stdio-MCP-Server erreichten, profilübergreifende MEDIA:-Anhänge sowie ein Nous-Bearer-Token eines anderen profile, das in prozessbezogenen Zwischenspeichern erhalten blieb (#107609-#107630).⁴⁸

v0.21.1 macht Konversationsgrenzen ausschließlich explizit. Die Dokumentation zum Sitzungslebenszyklus beim Tag v2026.9.7 formuliert den Vertrag in vier Sätzen: „Weder Inaktivität noch die verstrichene Zeit führen jemals zu einem Wechsel der Konversation. /new und /reset erzeugen eine explizite Grenze; die Kontextkomprimierung verwaltet weiterhin lange Verläufe. Veraltete Timer-Konfigurationen werden ignoriert. Der vorhandene Datentyp SessionResetPolicy besteht als inaktive Kompatibilitätsstruktur fort und dient nicht als Laufzeitrichtlinie.“ Eine explizite Unterbrechung erzeugt weiterhin beim nächsten eingehenden Beitrag eine Grenze, die Wiederherstellung berücksichtigt abgeschlossene Grenzen, statt sie erneut zu öffnen, und eine ausschließlich ressourcenbedingte Verdrängung lässt Konversationen fortsetzbar. Wenn eine Sitzung auf Ihrem gateway scheinbar „nie abläuft“, ist das inzwischen beabsichtigt; beginnen Sie mit /new selbst eine neue.⁴³

Seit dem Zeitfenster von v0.21.4 stellt ein zweiter Aufruf von hermes gateway run eine Verbindung her oder verweigert den Start, statt dieselbe Adresse doppelt zu binden. Pro Host und Betriebssystembenutzer gilt: ein hermes serve und ein hermes gateway run, die jeweils alle profiles multiplexen. Wenn Sie einen gateway für ein profile starten, das der laufende Multiplexer bereits bedient, verbindet sich der Befehl lediglich und wird mit Status 0 beendet. Bedient er dieses profile noch nicht, fordert Hermes ihn auf, profiles/ erneut einzulesen, und stellt die Verbindung her, sobald dies geschehen ist. Kann der Multiplexer das profile nicht bedienen, verweigert der Befehl den Start, statt unbemerkt einen zweiten gateway zu starten. --replace richtet sich nun gegen diesen Hostprozess, unabhängig davon, welches profile ihn gestartet hat, und --force überspringt die Rückfrage vollständig, wenn der Eigentümerprozess feststeckt. Eigenständige gateways können weiterhin parallel betrieben werden: Handelt es sich beim laufenden gateway um den eigenständigen, nicht multiplexenden gateway eines anderen profile, startet Ihr profile wie bisher einen eigenen daneben, bis diese Migration erzwungen wird (#109417). Werden zwei gateways gleichzeitig gestartet, wird derjenige, der die Hostsperre nicht erhält, mit Status 75 beendet; jeder von Hermes erzeugte Supervisor versucht den Start daraufhin erneut. Zu diesem Zeitpunkt ist der Datensatz des Gewinners bereits vorhanden, sodass der erneute Versuch gemäß den obigen Regeln eine Verbindung herstellt oder den Start verweigert. Die Sperren und der Rendezvous-Datensatz befinden sich unter $HERMES_GATEWAY_LOCK_DIR, andernfalls unter $XDG_STATE_HOME/hermes/gateway-locks (standardmäßig ~/.local/state/hermes/gateway-locks), und gelten jeweils für den Betriebssystembenutzer. Ein Datensatz, dessen PID nicht mehr läuft oder von einem anderen Prozess wiederverwendet wurde, gilt als veraltet und wird ignoriert, sodass ein abgestürzter gateway den nächsten Start nicht blockiert. Die Desktop-App folgt derselben Regel und verbindet sich mit dem laufenden Host-Backend, statt ein zweites zu starten.⁵¹

Seit v0.21.5 ist Multiplexing nicht mehr optional. gateway.multiplex_profiles hat genau einen gültigen Wert: true. Ein fehlender Schlüssel wird als aktiviert behandelt und in die config.yaml des Standard-profile geschrieben; ein explizites false wird direkt in der Datei zu true umgeschrieben. Dabei erscheint einmalig ein eingerahmter Hinweis beim Start dieses gateway und erneut in der Zusammenfassung des nächsten hermes update. Zwei Steuerungsmöglichkeiten ersetzen die frühere Abwahloption. Um ein einzelnes profile offline zu nehmen, ohne die Bots aller anderen zu stoppen, führen Sie hermes -p <name> gateway stop aus: Der Host parkt es (über eine Markierungsdatei profiles/<name>/gateway.parked), und hermes -p <name> gateway start hebt das Parken auf. Die Schaltflächen „Stop“ und „Start“ im Dashboard und in der Desktop-App bewirken dasselbe. Ein benanntes profile, das weiterhin einen eigenen gateway benötigt, setzt gateway.standalone: true in seiner eigenen config.yaml; der Host bedient es nie, und seine Befehle stop/start wirken auf seinen eigenen Prozess. Die Dokumentation bezeichnet diesen Schlüssel als „vorübergehende Kompatibilitätslösung“ und nicht als unterstützte Topologie; beim Standard-profile wird er unter Ausgabe einer Warnung ignoriert. Eine Aufteilung auf verschiedene Betriebssystembenutzer oder ein HERMES_HOME außerhalb von profiles/ im Standard-Ausgangsverzeichnis erfordert weiterhin --force.⁵³

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 kommunizieren. Ein Benutzer sendet über seine Messaging-Plattform einen Pairing-Code; Sie genehmigen ihn mit hermes pairing approve. Danach ist der Benutzer autorisiert.⁶

unauthorized_dm_behavior legt fest, was eine fremde Person vor dem Pairing als Antwort auf eine Direktnachricht erhält: pair sendet per Direktnachricht einen Pairing-Code, ignore verwirft die Nachricht ohne Rückmeldung und decline, der im Zeitfenster von v0.21.4 ergänzte Wert, sendet eine einmalige höfliche Ablehnung und bleibt diesem Absender gegenüber anschließend 24 Stunden lang stumm (#88028). Die Ablehnung wird pro Plattform und Absender auch über Aliasse hinweg dedupliziert, und ihr Text stammt aus unauthorized_dm_decline_message (einem globalen Schlüssel; ein leerer Wert verwendet die integrierte Antwort: „Hallo! Ich bin ein persönlicher Assistent und kann nur mit meinem Besitzer chatten, daher kann ich Ihnen leider nicht direkt helfen.“). Legen Sie das Verhalten global oder für jede Plattform einzeln dort fest, wo es der Einrichtungsassistent einträgt:

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

Wenn nichts festgelegt ist, hängt der tatsächlich verwendete Standardwert von Ihren Zulassungslisten ab. Sind keine konfiguriert, lautet er pair. Sobald irgendeine Zulassungsliste festgelegt wurde (GATEWAY_ALLOWED_USERS oder die Variable einer Plattform für zugelassene Benutzer, zugelassene Gruppenbenutzer oder zugelassene Gruppenchats), ändert er sich zu ignore, da die Zulassungsliste einen bewusst eingeschränkten gateway signalisiert und das Senden von Codes an unbekannte Kontakte störend wirkt und möglicherweise Informationen preisgibt (#9337). Ein globales ignore oder decline setzt diese Regel außer Kraft, ein globales pair hingegen nicht, weil es nicht vom Standardwert zu unterscheiden ist. Wenn Sie Pairing zusammen mit einer Zulassungsliste beibehalten möchten, legen Sie pair für jede Plattform einzeln fest. (Die eigene dm_policy eines Plattformadapters wird, sofern festgelegt, vor der Zulassungslistenregel berücksichtigt.) E-Mail ist wie ein Posteingang aufgebaut und verwendet standardmäßig ignore, sofern nicht der eigene plattformspezifische Schlüssel eine andere Einstellung aktiviert; ein globaler Wert gilt dafür nicht. Wenn Sie eine Plattform ohne Zulassungsliste konfigurieren, bietet hermes gateway setup „Ablehnen“ als eine der Antwortmöglichkeiten an.⁵¹

Geplante Aufgaben (Cron)

Hermes verfügt über ein erstklassiges cron-System, in dem Jobs Agentenaufgaben und keine Shell-Befehle sind. Jeder geplante Job wird mit einem neuen AIAgent, dem konfigurierten Prompt und optional angehängten skills ausgeführt und übermittelt die Ergebnisse an eine beliebige Plattform:³⁶

hermes cron list
hermes cron create --prompt "Check HN for AI news and summarize" --schedule "0 9 * * *" --deliver telegram
hermes cron edit <id>
hermes cron pause <id>
hermes cron resume <id>
hermes cron run <id>         # Trigger now on the next tick
hermes cron remove <id>
hermes cron status           # Check if scheduler is running
hermes cron tick             # Run due jobs once and exit

Alternativ können Sie einen Job direkt in einem Messaging-Chat im Dialog erstellen:

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 dauerhaft in JSON gespeichert und bleiben auch nach Neustarts erhalten.³

Mit v0.21.0 erhielten geplante Jobs Gedächtnis und Urteilsvermögen. Vier Mechanismen, die alle mit dem Tag v2026.8.31 verifiziert wurden:³⁵³⁷

• Kontinuität. continuity=true fügt bei jeder Ausführung die letzte eigene Ausgabe eines Jobs ein, sodass ein Scout oder Monitor „aufwacht, sieht, was er beim letzten Mal gemeldet hat, Duplikate vermeiden und dort weitermachen kann, wo er aufgehört hat“. Die eingefügte Anweisung lautet „avoid repeating what was already reported“, die erste Ausführung bleibt unverändert, und intern wird das Flag als reservierter Eintrag self in context_from gespeichert. Sie können es mit hermes cron create ... --continuity sowie hermes cron edit <job_id> --continuity / --no-continuity umschalten.³⁷
• Dauerhafte Notizblöcke. Jeder Job erhält einen kleinen KV-Zwischenspeicher für Cursor, Wasserzeichen und Beobachtungslisten (16 KB pro Wert, 64 KB pro Job – er wird bei jeder Ausführung in den Prompt eingefügt, weshalb die Begrenzungen bewusst gewählt sind). Geschrieben wird er mit hermes cron notepad <job_id> set <key> <value>, das der laufende Agent über sein Terminal-Tool aufruft.³⁷
• Monitor-Modus. Ein Job kann eine kostengünstige Quelle vom Typ monitor_script/monitor_url einbinden, die bei jedem Durchlauf zuerst ausgeführt wird: Eine unveränderte Ausgabe (als exakte Bytefolge verglichen) unterdrückt die Agentenausführung vollständig – kein LLM-Aufruf, keine Zustellung, sondern eine stille no_change-Ausführung. Bei einer Änderung wird hingegen ein Diff-Block eingefügt und der Agent normal ausgeführt. Sorgen Sie bei Monitor-Skripten für eine stabile Ausgabe, da sonst jeder Durchlauf wie eine Änderung wirkt.³⁷
• Reasoning-Aufwand pro Job und Zustellung an Bot Chat. Mit --reasoning-effort wird die Denktiefe eines Jobs (none bis ultra) festgelegt, wobei die globalen und modellspezifischen Einstellungen für die Ausführungen dieses Jobs überschrieben werden. deliver=bot-chat stellt die Ausgabe außerdem als echte eingehende Nachricht in der kanonischen Bot-Chat-Sitzung eines profile zu. Dort „kümmert sich der Bot um alles, was eine Aktion erfordert, und antwortet in seinem Chat“, statt dass ein Mensch lediglich einen Kanal mitliest.³⁷

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 dessen Tool-Angebot 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
hermes mcp login <name>       # Force re-auth for an OAuth server (--flow browser|device)
hermes mcp reauth [--all]     # Re-authenticate one OAuth server, or every one

Oder nehmen Sie die Konfiguration manuell in config.yaml vor:¹⁴

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 nach dem Namensschema mcp__server__tool bereitgestellt. Jeder Tool-Name enthält somit den Namen seines Servers, sodass es nicht mehr zu Konflikten kommt, wenn zwei Server dasselbe Tool anbieten. Außerdem erscheinen Protokollbenachrichtigungen von MCP-Servern in agent.log.⁶⁰

v0.21.1 ergänzt einen Gerätecode-Ablauf für MCP-OAuth: hermes mcp login <name> akzeptiert --flow {browser,device}. browser bezeichnet den bestehenden PKCE-Ablauf, device eine Gerätecode-Anmeldung gemäß RFC 8628 für Headless- oder Remote-Rechner; das Flag überschreibt die Konfiguration oauth.flow des Servers. Im selben Release-Zeitraum wird die profile-Zugehörigkeit während sämtlicher OAuth-Sitzungen durchgesetzt, fehlerhafte Metadaten-Caches für OAuth werden ignoriert, statt einen Server zu blockieren, und Desktop-MCP-OAuth wird über clientlokale Callbacks weitergeleitet. -t/--toolsets filtert nun außerdem, welche konfigurierten MCP-Server gestartet werden, sodass bei einem eingegrenzten Aufruf nicht benötigte Server keinen Kaltstart durchlaufen.⁴⁴

v0.21.0 macht die MCP-Oberfläche der Desktop-Anwendung zu einer Kommandozentrale: Server und Katalog werden auf einer Seite zusammengeführt, ein Drag-and-drop-Import nach dem Prinzip „paste anything“ wird unterstützt, Hintergrundprüfungen des Systemzustands weisen auf ablaufende Authentifizierungen hin, bevor ein Tool-Aufruf fehlschlägt, eine Kosten- und Nutzungsübersicht für die gesamte Serverflotte zeigt geschätzte Schema-Tokenmengen sowie die Nutzung der vergangenen 30 Tage pro Server an, und über hermes://-Deep-Links können Sie einen MCP-Server nach ausdrücklicher Bestätigung installieren.³⁵

Das Release-Fenster von v0.21.4 ergänzt mcp.discovery_concurrency (Standardwert 4; 0 = unbegrenzt, #117373): eine Obergrenze dafür, zu wie vielen konfigurierten MCP-Servern die Erkennung gleichzeitig eine Verbindung aufbaut. Die Verbindung zu jedem Server wird weiterhin hergestellt – die Begrenzung verhindert lediglich, dass dies bei allen gleichzeitig geschieht. Bei einem negativen Wert oder einer Zahl, die keine Ganzzahl ist, wird eine Warnung protokolliert und auf den Standardwert zurückgegriffen.⁵¹

Als Server — stellen Sie Hermes-Unterhaltungen anderen Agenten zur Verfügung:

hermes mcp serve
hermes mcp serve -v    # Verbose

Kontextkomprimierung

Hermes komprimiert lange Unterhaltungen automatisch, damit sie in das Kontextfenster Ihres Modells passen. Das Zusammenfassungsmodell für die Komprimierung wird über einen separaten LLM-Aufruf angesprochen – dafür können Sie einen beliebigen Anbieter oder Endpunkt verwenden.⁴ Seit v0.20.6 verwendet die Richtlinie für das beibehaltene Ende standardmäßig lean (compression.tail_mode: lean). Beim Tag befinden sich die Einstellungen für Modell, Anbieter und Endpunkt des Zusammenfassungsmodells unter auxiliary.compression.* statt unter den älteren Schlüsseln compression.summary_*. Veraltete Schlüssel werden beim ersten Laden automatisch migriert (Konfigurationsversion 17).³⁰³¹

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

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

Was tail_mode festlegt. legacy behält ein wörtliches Ende in der durch target_ratio bestimmten Größe bei – bei großen Kontextfenstern oder erhöhten Schwellenwerten werden dadurch pro Komprimierung 100–240K Token gehortet. lean behält stattdessen ein begrenztes wörtliches Ende von 2,5 % des Kontextfensters bei (mindestens 10K, höchstens 25K) und wahrt die Kontinuität über die Zusammenfassung: ein detailliertes Sitzungsprotokoll des komprimierten Bereichs, in dem Bezeichner erhalten bleiben (ein zusätzlicher Aufruf des Zusammenfassungsmodells pro Versuch), einen mechanisch extrahierten Ankerindex (PR-Nummern, SHAs, Pfade, Fehlerzeichenfolgen – per Regex, niemals paraphrasiert), jedes echte Benutzerstatement als wörtliches Zitat sowie einen session_search-Wiederherstellungsverweis, über den der Agent erneut auf wegkomprimierte Inhalte zugreifen kann. Das in der Dokumentation angegebene Messergebnis für reale Sitzungen mit 500K Token: etwa 49K statt etwa 162K beibehaltene Token. Alte Tool-Ergebnisse innerhalb des lean-Endes werden auf einzeilige Platzhalter mit einem Wiederherstellungsverweis reduziert; unbekannte tail_mode-Werte greifen auf lean zurück.³¹

Anbieteroptionen:⁴³¹

Das Zusammenfassungsmodell muss ein Kontextfenster unterstützen, das mindestens so groß wie das Ihres Hauptmodells ist, da es den vollständigen mittleren Abschnitt der Unterhaltung in einem einzigen Aufruf erhält. Ist sein Kontextfenster kleiner, schlägt der Aufruf fehl und die mittleren Gesprächsrunden werden ohne Zusammenfassung verworfen.⁴³¹

Warnungen bei knappem Budget

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

Stream-Zeitüberschreitungen

Für die LLM-Streaming-Verbindung gelten zwei Zeitüberschreitungsebenen, die sich für lokale Anbieter (localhost, LAN-IPs) automatisch anpassen:⁴

Die Socket-Lesezeitüberschreitung wird für lokale Endpunkte auf 30 Minuten erhöht, da lokale LLMs beim Prefill großer Kontexte mehrere Minuten benötigen können, bevor sie das erste Token ausgeben.⁴

Lokales Web-Dashboard (v0.9.0+)

Ein browserbasiertes Dashboard, mit dem Sie Ihren Hermes Agent lokal verwalten können. Konfigurieren Sie Einstellungen, überwachen Sie Sitzungen, durchsuchen Sie skills und verwalten Sie Ihr gateway, ohne Konfigurationsdateien oder das Terminal anzufassen.¹⁶ Starten Sie es mit hermes dashboard. Für neue Benutzer, die eine GUI bevorzugen, ist dies der einfachste Einstieg.

Überwachung von Hintergrundprozessen (v0.9.0+)

Mit watch_patterns können Sie Muster festlegen, die in der Ausgabe von Hintergrundprozessen überwacht werden, und sich bei Übereinstimmungen in Echtzeit benachrichtigen lassen.¹⁶ Ü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 beim Abschluss einer Hintergrundaufgabe benachrichtigt) verfügt Hermes nun über eine vollständige Beobachtungsebene für Hintergrundprozesse.¹⁵

Pluggable Context Engine (v0.9.0+)

Die Kontextverwaltung ist jetzt über hermes plugins als austauschbarer Baustein verfügbar. Sie können benutzerdefinierte context engines einsetzen, die steuern, was der Agent bei jedem Durchlauf sieht – durch Filterung, Zusammenfassung oder domänenspezifische Kontextinjektion.¹⁶ Dadurch wird die Kontextstrategie von der zentralen Agentenschleife entkoppelt, sodass sich der Kontext projekt- oder domänenspezifisch anpassen lässt.

Sicherung und Wiederherstellung (v0.9.0+)

hermes backup erstellt ein vollständiges Archiv Ihrer Konfiguration, Sitzungen, skills und Ihres Speichers. hermes import stellt die Daten aus einem Sicherungsarchiv wieder her.¹⁶ Nutzen Sie dies, um zwischen Rechnern zu migrieren, vor größeren Änderungen Momentaufnahmen anzulegen oder eine bewährte Konfiguration mit Teammitgliedern zu teilen.

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

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

Sicherheitshärtung (v0.13.0+)

v0.13.0 behob 8 P0-Sicherheitsprobleme und änderte eine Standardeinstellung zugunsten des Benutzers.¹⁸ Mit v0.14.0 folgen weitere 12 behobene P0- und 50 behobene P1-Probleme, darunter Härtungsmaßnahmen gegen sudo-Brute-Force-Angriffe und für sudo-stdin, Korrekturen für die Umgehung von Schutzmaßnahmen gegen gefährliche Befehle, die Bereinigung von Toolfehlern vor der erneuten Einspeisung in das Modell, die Authentifizierung von Dashboard-Plugin-API, SSRF-Abdeckung für den skills-hub sowie die Prüfung auf Sicherheitshinweise zur Lieferkette während der Installation.¹⁹

Wenn Sie eine Hermes-Bereitstellung betreuen, sollten Sie v0.13.0 und v0.14.0 als sicherheitsrelevante Upgrades behandeln, nicht lediglich als Funktionsupdates. v0.13.0 schließt die Guild-übergreifende Discord-Umgehung und zwei TOCTOU-Zeitfenster; v0.14.0 ergänzt eine weitere Härtungsrunde für die sudo-Verarbeitung, die erneute Einspeisung von Toolfehlern, Plugin-API, SSRF im skills-hub und Sicherheitshinweise zu Abhängigkeiten.

v0.21.0 bringt eine vierte Welle. Schreibzugriffe auf geschützte Dateien mit Agentenanweisungen – AGENTS.md, CLAUDE.md, SOUL.md, .cursorrules, skills und Speicher – erfordern nun immer eine Genehmigung. Dadurch kann ein durch Prompt-Injection manipulierter Agent seine eigenen dauerhaften Anweisungen nicht unbemerkt umschreiben. Die Sperre ist standardmäßig aktiviert (security.protected_instruction_files: true, mit einer über fnmatch ausgewerteten Liste zusätzlicher Basisnamen in protected_instruction_extra_patterns). Der Quelltext benennt den dadurch geschlossenen Angriffsvektor ausdrücklich: „eine eingeschleuste Anweisung, die AGENTS.md / CLAUDE.md / SOUL.md bearbeitet“. Zudem wird darauf hingewiesen, dass Anweisungsdateien aus Verzeichnisbäumen des aktuellen Arbeitsverzeichnisses geladen werden und daher „jede AGENTS.md an einem Ort, von dem aus der Agent später ausgeführt werden könnte, ein aktives Ziel ist“.³⁵³⁹ Dieselbe Version schließt Lücken, durch die Geheimnisse über Terminalfehler, Lesezugriffe auf .env-Dateien, checkpoints und ACP-Protokolle offengelegt werden konnten; erweitert das Genehmigungssystem um destruktive Windows-Befehle und -Pfade; sorgt mithilfe einer stabilen TCC-Signaturidentität dafür, dass macOS-Berechtigungen Updates überstehen (einmalige Einrichtung: hermes desktop --setup-tcc-identity, nur unter macOS, erfordert openssl/security/codesign); entfernt nach einer Kompromittierung des vorgelagerten Projekts den Blender-MCP-Katalogeintrag und den zugehörigen skill; und ergänzt Plugin-Installationen um Tier-1-Sicherheitsprüfungen.³⁵³⁹

v0.21.6 bringt eine fünfte Welle. Dazu gehören vier von Tenable Research gemeldete Korrekturen an der Dashboard-Authentifizierung (Spoofing von X-Forwarded-For zur Umgehung der Anmelderatenbegrenzung, unbegrenzte Schreibvorgänge in das Authentifizierungs-Audit durch nicht authentifizierte Anfragen, eine fehlende Begrenzung der Anfragekörpergröße auf den öffentlichen /auth/-Routen sowie Anmeldecodes, die an eine nicht auf Loopback beschränkte Weiterleitungsadresse gesendet wurden und damit eine Sitzungsübernahme ermöglichten), automatische git-Aufrufe, die vor dem ersten Prompt nicht mehr die eigenen, nicht vertrauenswürdigen clean-, smudge- oder process-Filterprogramme eines Repositorys ausführen, sowie ein mit parseaddr ausgewerteter From-Header für E-Mails, sodass ein in Anführungszeichen gesetzter Anzeigename die Zulassungsliste nicht passieren kann. Einzelheiten finden Sie unter Neuerungen in v0.21.6.⁵⁴⁵⁵

Architektur für Praktiker

Dieser Abschnitt richtet sich an alle, die verstehen möchten, was unter der Haube geschieht, um Fehler zu beheben, Hermes zu erweitern oder die Performance einschätzen zu können. Er fasst die vorgelagerte 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    │  │              │             │
│  └──────────────┘ └──────────────┘  └──────────────┘             │
└──────────────────────────────────────────────────────────────────┘

Das Diagramm wurde aus der vorgelagerten Architekturdokumentation übernommen.³

„47 Tools / 20 Toolsets“ gegenüber „28 Tools“ in Ihrem Banner. Die Angabe „47 Tools“ entspricht der Gesamtzahl im Tool-Register des vorgelagerten Repositorys – also allen Tools, für die Hermes über sämtliche Toolsets hinweg Quellcode mitliefert. Ihre tatsächlich ausgeführte CLI zeigt im Startbanner eine niedrigere 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 – etwa Adapter für Messaging-Plattformen, Browserautomatisierung und aufwendigere Scraping-Tools. Die Gesamtzahl im Register steht für „verfügbar“, die Zahl im Banner für „in Ihrem aktuellen profile aktiviert“. Mit hermes tools --list prüfen Sie, welche Toolsets aktiv sind. Einzelne Toolsets können Sie über den Block toolsets: in ~/.hermes/config.yaml aktivieren oder deaktivieren (oder innerhalb einer laufenden Sitzung mit /tools list / /tools enable <name> / /tools disable <name> – das Entfernen eines Tools setzt die Sitzung zurück, damit der Agent sein Tool-Manifest neu erstellt).

Die drei API-Modi

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

Der Resolver runtime_provider.py ordnet (provider, model)-Tupel für mehr als 18 Anbieter (api_mode, api_key, base_url) zu und verarbeitet dabei OAuth-Abläufe, Anmeldedaten-Pools und die Auflösung von Aliasen.³

Datenfluss durch eine CLI-Sitzung

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

Aus der vorgelagerten Architekturseite.³

Reihenfolge der Prompt-Zusammenstellung

Der Prompt-Stack umfasst:¹³

1. SOUL.md (Agent-Identität – oder die integrierte Ersatzversion, falls nicht verfügbar)
2. Tool-spezifische Verhaltenshinweise
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 das Fundament – alles Weitere baut darauf auf.¹³

Sitzungsspeicherung

SQLite-basierte Sitzungsspeicherung mit FTS5-Volltextsuche. Sitzungen verfügen über eine Abstammungsverfolgung (Eltern-/Kindbeziehungen über Komprimierungen hinweg), plattformspezifische Isolation und atomare Schreibvorgänge mit Konfliktbehandlung.³

Wenn der Speicher bei einer v0.21.x-Installation Probleme bereitet, verwenden Sie v0.21.2 oder neuer: Diese Version behob die für v0.21.0 typische Anfälligkeit von state.db (zweite Schreibprozesse lösten gegenseitig ihre Sperren auf, intakte Datenbanken wurden als beschädigt gemeldet, und eine einzige fehlerhafte Zeile brachte sessions list zum Scheitern). Außerdem wurde die Koordination gehosteter Räume aus dem Stammspeicher in eine eigene shared-state.db verlagert, sodass profile-gateways den zentralen Sitzungsspeicher nie mit Schreibzugriff öffnen. hermes doctor unterscheidet nun zwischen strukturellen Schäden und Schäden am FTS-Index. Bei FTS-Schäden wird die Suche eingeschränkt, statt die Anfrage scheitern zu lassen. hermes sessions recover --inspect-only (offline, nicht destruktiv und an ein profile gebunden) meldet die Lesbarkeit kanonischer Tabellen, ohne eine Ausgabedatenbank anzulegen – der Unterbefehl existierte bereits vor diesem Versionsfenster, war hier jedoch noch nicht dokumentiert. Siehe Neuerungen in v0.21.2.⁴⁸ Für einen Speicher, der im falschen SQLite-Journalmodus feststeckt, führte das v0.21.4-Versionsfenster den Offline-Konverter hermes sessions set-journal-mode delete|wal ein (siehe die Zeile zu hermes sessions unter Befehle der obersten Ebene).⁵¹

Plugin-System

Es gibt drei Quellen für die Erkennung: ~/.hermes/plugins/ (Benutzer), .hermes/plugins/ (Projekt) und pip-Einstiegspunkte. Plugins registrieren Tools, Hooks und CLI-Befehle über eine Kontext-API. Speicheranbieter sind ein spezialisierter Plugin-Typ unter plugins/memory/.³ Seit v0.21.6 hält plugins.isolation: host (Standardwert: in_process) den Code von Python-Plugins Dritter aus dem Hermes-Prozess heraus: Allgemeine Plugins werden pro profile in einem eigenen plugin-host-Prozess geladen und kommunizieren ausschließlich über ctx mit Hermes. Alle anderen Pfade, die Benutzercode innerhalb des Prozesses importieren würden (Kategorieanbieter, Profile von Modellanbietern und APIs von Dashboard-Plugins), verweigern dies unter Angabe eines Grundes; mitgelieferte Plugins verbleiben im Prozess. Wenn sich ein Plugin aufhängt oder abstürzt, fällt dadurch sein host aus, nicht das gateway.⁵⁵ Seit v0.21.2 gibt es außerdem einen kuratierten, per SHA fixierten Plugin-Katalog, den Sie durchsuchen und aus dem Sie Plugins anhand ihres Namens installieren können, sowie hermes plugins pack für „deklarative, gemeinsam nutzbare Plugin-Sets“: Eine einzige hermes-pack.yaml fixiert mehrere Plugins auf exakte Commit-SHAs. Pack-Installationen werden in gewöhnliche fixierte Installationen aufgefächert, während die Zustimmung zu Berechtigungen weiterhin für jedes Plugin einzeln erfolgt.⁴⁸

Im v0.21.4-Versionsfenster wurde dieser Katalog von einer CLI-Oberfläche zu einem mitgelieferten Artefakt ausgebaut. Das Verzeichnis plugin-catalog/ des Repositorys wuchs von 9 Einträgen bei v2026.9.14 auf 228 bei v2026.9.21 – ein geprüfter YAML pro Plugin (Name, Repository, Maintainer, Stufe, Kategorie und Berechtigungen), fixiert auf einen exakten 40-stelligen Commit-SHA, wobei die Aufnahme in das Verzeichnis zugleich die Zulassung darstellt. Die Daten werden als plugin-catalog.json für die CLI veröffentlicht (live abgerufen und unter ~/.hermes/cache/ zwischengespeichert). Die Dokumentationswebsite erzeugt nun aus denselben Daten jeweils eine Seite pro Plugin (/docs/plugins/<name>) und Autor (/docs/plugins/by/<slug>). Jede Seite stellt die README des Plugins dar, die vom fixierten Commit und niemals von der Spitze eines Branches abgerufen wird. Dabei entfernt eine zur Build-Zeit angewendete Positivliste rohe HTML; die Sortierung nach Hinzufügungs- oder Aktualisierungsdatum basiert auf den Committer-Daten. Die zehn Community-Plugins, die in der v0.21.4-Veröffentlichung genannt werden, sind beim Tag allesamt unter ihren tatsächlichen Katalog-Slugs enthalten: hermes-tailscale, hermes-ssh, shodan, hermes-terminal, hermes-rss (zusätzlich gibt es ein separates rss-reader), hermes-resetwatch, done-bell, kiwi, cognee und web-octen. In der Desktop-Version kann ein Plugin nun über den Plugins-Hub hinter einem Bestätigungsdialog deinstalliert werden – Katalog-Plugins über plugins.manage remove, eigenständige Desktop-Plugins über den Electron-Loader.⁵¹

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

Kompatibilitätsfenster (v0.21.1), inzwischen abgelaufen: Externe Plugins mussten bis zum 14. September 2026 von den Importpfaden vor der Zerlegung migriert werden. Durch die Zerlegung im September 2026 (PR #102117) wurden interne Komponenten verschoben, die Plugins häufig importierten. Eine temporäre COMPAT_MANIFEST.md-Ebene exportierte 1.148 verschobene öffentliche Namen erneut aus ihren alten Modulen und warnte einmal pro Name und Prozess (HermesPluginCompatWarning). Die Entfernung trat planmäßig am 14. September 2026 in Kraft, und zwar über eine Datumssperre im ausgelieferten Code (COMPAT_REMOVAL_DATE in hermes_cli/plugin_compat.py; eine Rücknahme des Codes war nicht erforderlich): Seit diesem Datum wird ein betroffenes Plugin deaktiviert – es wird nicht geladen, und ein roter Hinweis erscheint im CLI-Banner, in hermes doctor und hermes update; zudem werden einmalig ein Desktop-Dialog und der Grund in hermes plugins list angezeigt. Für Autoren: hermes plugins compat <path> gibt weiterhin jede Fundstelle im Format file:line samt altem Pfad -> neuem Pfad aus und beendet sich mit Status 1, solange noch Einträge vorhanden sind (mit --json erhalten Sie eine maschinenlesbare Ausgabe). Benutzer, die auf ein nicht mehr gepflegtes Plugin angewiesen sind, können in config.yaml weiterhin plugins.allow_deprecated_imports: true festlegen – der Wert muss ein literaler YAML-Boolescher Wert sein, keine Zeichenfolge in Anführungszeichen. Dies funktioniert weiterhin, weil die Rücknahme, welche die alten Pfade löscht, noch nicht eingespielt wurde: Manifest und Shims sind in v2026.9.14, v2026.9.21, v2026.9.24 sowie mit Stand vom 24. September in main vorhanden (im v0.21.4-Versionsfenster wurde das Kompatibilitätsmodul lediglich angepasst, um Plugin-Scans zwischenzuspeichern und Windows-Pfade zu normalisieren; im v0.21.5-Versionsfenster blieb hermes_cli/plugin_compat.py unverändert, und entfernt wurden nur die Manifest-Einträge für das gelöschte Hindsight-Modul). Sobald diese Rücknahme eingespielt wird, funktioniert der Ausweg nicht mehr, weil die alten Pfade selbst verschwinden. Abgedeckt waren ausschließlich öffentliche Namen der obersten Ebene; private Namen und Monkeypatch-Schnittstellen für Tests gehörten nie zur Oberfläche und werden nicht wiederhergestellt.⁴²⁵³ Mit v0.21.6 ist dieser Ausweg geschlossen: Das Manifest, die Shims, der Scanner hermes plugins compat und plugins.allow_deprecated_imports wurden entfernt. hermes_cli/plugin_compat.py bleibt als funktionsloser Stub für Updater erhalten, die noch aus älteren Checkouts ausgeführt werden; ein Plugin, das weiterhin einen Importpfad aus der Zeit vor der Zerlegung verwendet, kann nicht importiert werden.⁵⁵

Designprinzipien

Aus der vorgelagerten Architekturseite:³

Migration von OpenClaw

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

hermes claw migrate --dry-run                    # Preview what would be migrated
hermes claw migrate --preset full                # Full migration including API keys
hermes claw migrate --preset user-data --overwrite   # User data only, no secrets
hermes claw migrate --source /custom/path        # Non-default OpenClaw location

hermes claw migrate liest standardmäßig aus ~/.openclaw (und erkennt außerdem automatisch die veralteten Verzeichnisse ~/.clawdbot und ~/.moldbot) und schreibt die Daten 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 Zulassungslisten 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 (jetzt wirkungslos: Seit v0.21.1 wechseln Timer eine Unterhaltung nicht mehr⁴³), Genehmigungsregeln, TTS-Konfiguration, Browsereinstellungen, Tool-Einstellungen, Ausführungs-Timeout, Befehlszulassungsliste, gateway-Konfiguration und API-Schlüssel aus 3 Quellen.⁶

Zur manuellen Prüfung archiviert: cron-Jobs, Plugins, Hooks/Webhooks, Speicher-Backend (QMD), Konfiguration der skills-Registry, Benutzeroberfläche/Identität, Protokollierung, Multi-Agent-Konfiguration, Kanalbindungen, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md.⁶

Bei der Auflösung des API-Schlüssels werden 3 Quellen in dieser Prioritätsreihenfolge geprüft: Konfigurationswerte → ~/.openclaw/.env → auth-profiles.json.⁶

Fehlerbehebung

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

Dieser Fehler tritt bei jeder Neuinstallation zuerst auf: Hermes hat noch keinen Provider ermittelt. Die Meldung bedeutet genau das, was sie besagt – keiner der 3 Authentifizierungswege hat einen verwendbaren Provider ergeben. Führen Sie Folgendes aus:

hermes model

Die interaktive Auswahl führt Sie durch alle unterstützten Provider, einschließlich der OAuth-Gerätecodeabläufe (Nous Portal, GitHub Copilot, Anthropic, OpenAI Codex) und benutzerdefinierter Endpunkte für selbst gehostete Server. Falls Sie erwartet haben, dass bereits ein Provider konfiguriert ist, zeigt hermes doctor, welche Zugangsdaten Hermes tatsächlich erkennt. Häufige Ursachen sind ein am falschen Ort hinterlegter API-Schlüssel (er gehört in .env oder muss über hermes config set festgelegt werden, nicht im Shell-Profil), abgelaufene OAuth-Zugangsdaten in ~/.hermes/auth.json oder ein benutzerdefinierter Endpunkt in config.yaml, bei dem base_url verloren gegangen ist. Die Authentifizierungswege werden unter Authentifizierung und Provider ausführlich erläutert.²⁷

„API key not set“

Führen Sie hermes model aus, um Ihren Provider interaktiv zu konfigurieren, oder verwenden Sie 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 Endpunkt /v1/models Ihres Servers, doch viele lokale Server melden niedrige Standardwerte. Legen Sie die Länge daher ausdrücklich in config.yaml fest:²

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

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

Auf Ihrem Server sind Tool-Aufrufe nicht aktiviert oder das Modell unterstützt sie über die Serverimplementierung nicht.²

Antworten brechen mitten im Satz ab

Dafür kommen 2 Ursachen infrage:²

1. Niedrige Ausgabelimitierung (max_tokens) auf dem Server – SGLang verwendet standardmäßig 128 Tokens pro Antwort. Legen Sie auf dem Server --default-max-tokens fest oder konfigurieren Sie model.max_tokens in config.yaml.
2. Erschöpfter Kontext – Das Modell hat sein Kontextfenster vollständig 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 einem eigenen Subnetz. localhost innerhalb von WSL2 verweist daher auf die Linux-VM und nicht auf den Windows-Host. Es gibt 2 Möglichkeiten:²

Gespiegeltes Netzwerk (Windows 11 22H2 oder höher): Bearbeiten Sie %USERPROFILE%\.wslconfig:

[wsl2]
networkingMode=mirrored

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

Host-IP als Ausweichlösung (ältere Windows-Versionen): Ermitteln Sie innerhalb von WSL2 die IP-Adresse des Windows-Hosts und verwenden Sie diese anstelle von localhost:

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

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

Das Iterationsbudget ignoriert agent.max_turns

Wenn in der Aktivitätszeile N/90 (oder ein anderer veralteter Höchstwert) angezeigt wird, obwohl in config.yaml der Wert agent.max_turns: 500 festgelegt ist, liegt dies wahrscheinlich an einer veralteten HERMES_MAX_ITERATIONS-Zeile in ~/.hermes/.env: Der Einrichtungsassistent schrieb das Budget früher in beide Speicherorte. Bricht die Startüberleitung aufgrund eines vorherigen Fehlers beim Parsen der Konfiguration ab, setzt sich der verwaiste Wert aus .env unbemerkt durch. Seit v0.21.1 erkennt hermes doctor dieses überschattende Wertepaar, und hermes doctor --fix löscht die Zeile aus .env, sodass config.yaml maßgeblich bleibt.⁴¹

Wo befindet sich alles?

hermes status und hermes dump helfen Ihnen dabei weiter. hermes logs list zeigt alle Protokolldateien samt ihrer Größe an. hermes config path gibt den Speicherort der Konfigurationsdatei aus. hermes config env-path gibt den Speicherort der .env-Datei aus.⁶

FAQ

Was ist der Unterschied zwischen Hermes Agent und Claude Code?

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

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

Ja. Dafür gibt es 3 Möglichkeiten:²

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

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

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

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

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

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

In aktuellen Builds kann dieses Problem in seiner früheren Form weitgehend nicht mehr auftreten. Standardmäßig (auxiliary.*.provider: "auto") wird jede Hilfsaufgabe — Bildverarbeitung, Genehmigungsklassifizierung, Komprimierung und Sitzungstitel — mit Ihrem primären Chatmodell ausgeführt. Eine reine Anthropic-Konfiguration erledigt diese Aufgaben somit mit dem bereits vorhandenen OAuth. Der frühere Standard (Gemini Flash über OpenRouter → Nous → automatische Codex-Erkennung, mit stillschweigender Einschränkung, falls nichts davon konfiguriert war) wurde entfernt: „auto verwendet jetzt für alle das Hauptmodell, wobei aufgabenspezifische Überschreibungen in config.yaml weiterhin Vorrang haben.“³⁴

Falls eine Hilfsaufgabe weiterhin fehlschlägt, suchen Sie nach einer expliziten aufgabenspezifischen Überschreibung, die auf einen nie konfigurierten Anbieter verweist (auxiliary.<task>.provider / .model in config.yaml), oder nach veralteten Legacy-Schlüsseln: Seit Tag v2026.8.31 wird die Komprimierungszusammenfassung wie jeder andere Hilfsplatz konfiguriert — über auxiliary.compression.provider — und ältere compression.summary_*-Schlüssel werden automatisch dorthin migriert (Konfigurationsversion 17).³¹ Die Webextraktion ist überhaupt keine LLM-Aufgabe mehr („kein LLM beteiligt“). Daher ist ein Fehler bei der Webzusammenfassung in aktuellen Builds kein Problem des Hilfsmodells.³⁴ So binden Sie eine Aufgabe wieder ausdrücklich an Ihren primären Anbieter:

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

Worin besteht der Unterschied zwischen SOUL.md und AGENTS.md?

SOUL.md definiert die Identität Ihres Agents — Tonfall, Stil und Kommunikationsstandards. Die Datei befindet sich unter ~/.hermes/SOUL.md und gilt überall. AGENTS.md ist projektspezifisch — Architektur, Konventionen, Befehle und Pfade — und befindet sich in Ihrem Projektverzeichnis.¹³ Soll etwas überall gelten, gehört es in SOUL.md. Gehört es zu einem Projekt, gehört es in AGENTS.md.

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

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

hermes profile create work --clone
hermes profile use work                 # Sticky default
hermes -p work chat -q "..."            # One-off without switching
hermes profile alias work --name h-work # Wrapper script

Unterstützt Hermes lokale LLMs?

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

Warum zeigt mein Startbanner weniger tools an, als Hermes laut diesem Leitfaden besitzt?

Der Leitfaden nennt 47 tools / 20 toolsets aus der Upstream-Architekturregistrierung — das ist die Gesamtzahl der tools, für die Hermes über sämtliche toolsets hinweg Quellcode bereitstellt. Ihre laufende Installation zeigt im Banner eine kleinere Zahl an (die für diesen Leitfaden verwendete Referenzinstallation meldet 28 tools), da Hermes beim Start nur die standardmäßig vorgesehenen toolsets aktiviert. Viele toolsets müssen ausdrücklich aktiviert werden: Messaging-gateway-Adapter, Browserautomatisierung, umfangreichere Scraping-Stacks und mehrere spezialisierte Integrationen müssen explizit unter toolsets: in ~/.hermes/config.yaml aufgeführt sein, bevor sie geladen werden. Gesamtzahl der Registrierung = „was verfügbar ist, wenn Sie es aktivieren“. Gesamtzahl im Banner = „was Ihr aktuelles profile tatsächlich geladen hat“. Mit hermes tools --list sehen Sie, welche toolsets aktiv und welche verfügbar, aber deaktiviert sind. Einzelne toolsets können Sie zur Laufzeit mit /tools enable <name> und /tools disable <name> umschalten (das Deaktivieren löst einen Sitzungsneustart aus, damit der Agent sein tool-Manifest mit der neuen Struktur neu erstellt).

Wie handhabt Hermes den Modell-Fallback, wenn mein primärer Anbieter ausfällt?

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

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

Wenn der primäre Anbieter ausfällt (Ratenbegrenzung, Serverfehler oder Authentifizierungsfehler), wechselt Hermes während der laufenden Sitzung auf den Fallback, ohne den Unterhaltungsverlauf zu verlieren. Dies geschieht höchstens einmal pro Sitzung.