Hermes Agent: Das Praxishandbuch (2026)

Kurzfassung: Hermes Agent ist ein selbstoptimierender Open-Source-KI-Agent von Nous Research. Er läuft sowohl als CLI als auch als plattformübergreifender Messaging-gateway, speichert eine dauerhafte Identität und einen persistenten Speicher auf der Festplatte, bündelt skills, die sich mit zunehmender 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.5 (Tag v2026.9.24, 24. September 2026), ein kumulativer Patch für die v0.21-Reihe; Neuerungen in v0.21.5 erläutert die Änderungen, anschließend sind die Versionen von der neuesten bis zur ältesten aufgeführt.⁵² Die größte Hürde für die meisten neuen Benutzer ist die Anbieterauthentifizierung: Beim Tag v2026.9.24 umfasst die statische Auswahlliste von Hermes 39 Anbieter und wird automatisch um Einträge aus 38 mitgelieferten Anbieter-Plugins sowie benutzerdefinierte Endpunkte ergänzt. Dazu kommen drei verschiedene 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 ist eine vollständige Agent-Laufzeitumgebung, kein bloßer 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 seinen Erfahrungen eigene skills.¹ Die CLI ist eine Terminaloberfläche, die auf einer Konversationsschleife in run_agent.py aufbaut; der 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 Einschränkungen
4. Skillsystem: prozeduraler Speicher, den der Agent selbst erstellt und weiterentwickelt
5. Gateway + cron + profiles: Hermes dort ausführen, wo Sie leben, statt nur dort, wo Sie sich gerade befinden

Das Wichtigste in Kürze

• 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 am vertrautesten erscheint.
• Zum Wechseln des Anbieters genügt ein einziger Befehl. hermes model führt Sie interaktiv durch alle unterstützten Anbieter, einschließlich OAuth-Anmeldungen, und mit /model provider:model können Sie während einer Sitzung wechseln, ohne den Verlauf zu verlieren.²
• Zwei Dateien bilden die vom Benutzer bearbeitbare Konfigurationsoberfläche. ~/.hermes/config.yaml enthält die Einstellungen, ~/.hermes/.env die Geheimnisse. auth.json, SOUL.md, MEMORY.md und skills/ werden direkt von Hermes verwaltet — Sie können SOUL.md von Hand 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 gespeicherter Zustände.⁵
• Hilfsaufgaben verwenden standardmäßig Ihr Hauptmodell. Bilderkennung, Genehmigungsklassifizierung, Komprimierung und Sitzungstitel werden als separate „Hilfsaufrufe“ an LLM ausgeführt. Beim genannten Tag leitet auto jeden davon an Ihr primäres Chatmodell weiter – Sie müssen nichts konfigurieren, bei kostspieligen Reasoning-Modellen verursachen diese Nebenaufgaben jedoch erhebliche Zusatzkosten. Weisen Sie einzelne auxiliary.<task>-Slots günstigen, schnellen Modellen zu, wenn dies relevant ist.⁴³⁴

Jeder der folgenden Abschnitte basiert auf der offiziellen Dokumentation unter hermes-agent.nousresearch.com/docs und dem Quellcode unter github.com/NousResearch/hermes-agent. Jede Tatsachenbehauptung ist mit einer Fußnote versehen, die auf die jeweilige Upstream-Seite verweist.

Wählen Sie Ihren Weg

Funktionsweise von Hermes: Das Denkmodell

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

1. Erstellt über agent/prompt_builder.py den System-Prompt aus SOUL.md, MEMORY.md, USER.md, skills, Kontextdateien und Tool-Hinweisen (bei der Neustrukturierung im September 2026 wurde die Logik in das neue agent/-Paket verschoben)³
2. Ermittelt ü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 entscheidend, da 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 obigen Schleife.“

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

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

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

Jede der oben aufgeführten Dateien hat eine klar definierte Aufgabe; keine davon überschneidet sich mit einer anderen. Wenn Sie wissen möchten, wo Hermes etwas Bestimmtes speichert, finden Sie es an einer dieser Stellen.

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

Hermes Agent v0.21.5 (Tag v2026.9.24, 24. September 2026) ist die aktuelle Version und das dritte schlanke Rollup der v0.21.x-Reihe: „Dieses Tag bündelt die rund 460 seit v0.21.4 zusammengeführten PRs zu einer stabilen, mit einem Tag versehenen Version für nachgelagerte Nutzer.“ Kuratierte Versionshinweise werden erneut auf v0.22.0 verschoben. Die für Betreiber relevanten Änderungen wurden anhand des Quellcodes dieses Tags geprüft:⁵²⁵³

• Hindsight memory verlässt den Kerncode. Der gebündelte Hindsight-Provider und das pip-Extra hermes-agent[hindsight] wurden entfernt; Hindsight wird nun aus dem von Vectorize gepflegten Plugin-Katalog installiert. In den Versionshinweisen wird dies nicht erwähnt. Wenn Ihre Konfiguration memory.provider: hindsight festlegt, installiert hermes update das Katalog-Plugin in jedem profile-Verzeichnis, das diesen Provider verwendet. Fehlt es weiterhin, wird es beim ersten Start des Agenten installiert, sofern security.allow_lazy_installs nicht auf false gesetzt ist (führen Sie andernfalls hermes plugins install hindsight aus). Einstellungen, .env-Schlüssel und Speicherdaten bleiben unverändert. Siehe Externe Speicher-Provider.
• gateway.multiplex_profiles: false wird nicht mehr unterstützt. Das gateway ändert den Wert direkt in true und zeigt einmalig einen eingerahmten Hinweis an. Ein benanntes profile, das ein eigenes gateway behalten muss, legt in seiner eigenen config.yaml den Wert gateway.standalone: true fest. Um ein bereitgestelltes profile offline zu nehmen, parkt hermes -p <name> gateway stop es 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 auch als -pro-Variante) sowie Claude Opus 5.5.
• Die Plugin-Kompatibilität bleibt unverändert: plugins.allow_deprecated_imports: true funktioniert weiterhin.

Aktualisierung: hermes update oder der einzeilige Installer-Befehl; Docker- und Hermes Cloud-Images 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 der zweite bewusst schlank gehaltene Rollup der v0.21.x-Reihe. Die eigene Einordnung lautet: „Patch-Release. Dieser Tag bündelt die seit v0.21.3 zusammengeführten rund 1.800 PRs in einem stabilen Release-Tag für nachgelagerte Nutzer (Docker-Images, Hermes Cloud, gehostete Bereitstellungen).“ Das Zeitfenster seit v0.21.3 umfasst „5.071 Nicht-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 das zweitgrößte Zeitfenster zwischen zwei Tags in der Geschichte des Projekts, nur übertroffen von den 5.139 Commits in v0.21.1; gemessen an den zusammengeführten PRs ist es das größte. Die kuratierte Darstellung wird erneut aufgeschoben, wörtlich: „Vollständige kuratierte Versionshinweise für dieses Zeitfenster erscheinen mit v0.22.0, das alles ab v0.21.0 dokumentieren wird“ und „Nichts in diesem Zeitfenster wird ausgelassen.“ Die Notiz führt allerdings auf, was sie undokumentiert lässt. 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, wobei Desktop eine Verbindung herstellt, statt einen neuen Prozess zu starten. Pro Host und Betriebssystembenutzer gilt jeweils genau ein hermes serve und ein hermes gateway run, die sämtliche profile multiplexen. Durchgesetzt wird dies mit einer neuen hostweiten Singleton-Schicht: einer Host-Sperre, die für die gesamte Lebensdauer des erfolgreichen Prozesses gehalten wird, sowie einem Rendezvous-Datensatz mit (pid, createTime). So kann ein zweiter Aufruf nachweisen, dass der Besitzer derselbe aktive Prozess ist, und sich mit ihm verbinden, statt einen zweiten Port zu binden. Ein veralteter Zustand wird nachgewiesen, niemals lediglich angenommen. Die Desktop-App folgt demselben Prinzip 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 pro fehlendem Zugangsdatenwert, wobei die Aktion der Karte erst freigegeben wird, wenn jedes Pflichtfeld Text enthält. Siehe den Unterabschnitt zum kostenlosen Nous-Tarif.⁵¹
• --format stream-json: maschinenlesbare Einmalausführungen. hermes chat -q ... --format stream-json gibt für CI-Runner und Orchestratoren pro stdout-Zeile ein JSON-Objekt 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, das Flag impliziert --quiet, erfordert -q oder --query-file (ohne eine dieser Optionen erfolgt ein Abbruch mit Exit-Code 2) und kann nicht mit --tui kombiniert werden. Das Flag ist in der Optionstabelle für hermes chat aufgeführt.⁵¹
• skills.auto_load verankert skills in jeder Sitzung. 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 verankerten 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 bleibt diesem Absender gegenüber anschließend 24 Stunden lang stumm. Siehe Benutzerautorisierung und Kopplung.⁵¹
• mcp.discovery_concurrency begrenzt gleichzeitige Verbindungen bei der MCP-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 Abrufversuch. Das Suchschema akzeptiert after-/before-Grenzen (ISO-Angaben oder relative Zeiträume wie 7d). Liefert eine aus mehreren Wörtern bestehende Abfrage keine Ergebnisse, wird sie erneut ausgeführt und sucht dabei nach einem beliebigen Begriff, statt alle Begriffe wie beim impliziten AND von FTS5 zu verlangen. Siehe Sitzungssuche.⁵¹
• hermes sessions set-journal-mode delete|wal: der Offline-Konverter für den Journalmodus. Dies ist der eigenständig nutzbare Lösungsweg für eine state.db, die im falschen SQLite-Journalmodus feststeckt – zuvor musste dafür PRAGMA journal_mode=DELETE manuell ausgeführt werden. Beenden Sie zunächst gateway, dashboard und sämtliche CLI-Instanzen: Der Befehl verweigert die Ausführung, solange ein fremder Prozess die Datenbank geöffnet hält, wechselt den Modus, ohne auf geöffnete Zugriffe 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 Befehl ist in der Zeile zu hermes sessions unter Befehle der obersten Ebene aufgeführt.⁵¹
• Desktop: eine Schrifteinstellung, Engine-Aktualisierungen mit einem Klick und die Deinstallation von Plugins. Die Einstellungen erhalten ein pro profile unter desktop.font_family gespeichertes Feld für die Schriftfamilie. Es überschreibt die serifenlose Schrift des Themes im Chat und in der Benutzeroberfläche. Die Vorschlagsliste beginnt mit barrierearmen Schriften (OpenDyslexic, Atkinson Hyperlegible, Lexend); ein leeres Feld überlässt die Auswahl dem Theme. Für die verwaltete Laufzeitumgebung lokaler Modelle wird bei einer verfügbaren Aktualisierung die Schaltfläche „Engine aktualisieren“ angezeigt. Nach einer fehlgeschlagenen Aktualisierung 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-Video-Plugin ergänzt ltx-2.5 (das Open-Source-Audio-Video-Modell von Lightricks: natives Audio, Bild-zu-Video mit bis zu 20 s/4K, Voreinstellungen für Kamerabewegungen, günstiger Tarif – fal lehnt Clips mit mehr als 10 s bei 1440p/2160p ab) und kling-o3 (Kuaishous Spitzenmodellfamilie im Premium-Tarif: natives Storytelling mit mehreren Einstellungen, optionales Audio, 3–15 s).⁵¹
• Der Plugin-Katalog wird zu einem mitgelieferten Verzeichnis und einer Website. Das Verzeichnis plugin-catalog/ des Repositorys ist von 9 Einträgen bei v2026.9.14 auf 228 bei diesem Tag angewachsen – ein geprüftes YAML pro Plugin, jeweils an eine exakte Commit-SHA gebunden. Die Dokumentationswebsite erstellt nun für jedes Plugin und jeden Autor eine eigene Seite, auf der die README-Datei des Plugins aus dem festgeschriebenen Commit dargestellt wird. Die zehn im Release genannten Community-Plugins sind beim Tag allesamt im Katalog enthalten. Einzelheiten finden Sie im Plugin-System.⁵¹
• Hinzu kommt eine umfangreiche Reihe von Fehlerbehebungen in den Bereichen profile-/Multiplex-Isolation, cron, Kanban, Desktop und state.db, die das Release lediglich als Kategorie nennt. Die kuratierte Dokumentation dieser Korrekturen bleibt v0.22.0 vorbehalten.⁵⁰

Die Rücknahme der Plugin-Kompatibilität ist auch in diesem Zeitfenster 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 Zeitfenster sind ein prozessweiter Scan-Cache (ein Multiplex-gateway erkennt Plugins einmal pro bereitgestelltem profile; das erneute Parsen des Quellcodes sämtlicher Plugins kostete im Startpfad rund 0,4 s pro profile) sowie POSIX-formatierte Trefferpfade unter Windows (#112576). Die Datumssperre und die Ausweichmöglichkeit über einen booleschen Literalwert sind unverändert, sodass plugins.allow_deprecated_imports: true betroffene Plugins weiterhin laden lässt. Der Kompatibilitätskasten im Plugin-System enthält den aktuellen Stand.⁴²

Das Aktualisierungsverfahren 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 von main und erscheint mit einer aus zwei Punkten bestehenden Notiz. Der Anlass: Cloud-Agenten aktualisieren sich automatisch auf den neuesten Release-Tag, und die Korrekturen für die Anmeldung am entfernten gateway mussten sie erreichen. (1) Sitzungen des entfernten dashboards werden nicht mehr durch Häufungen von Aktualisierungsanfragen widerrufen: Beide Aktualisierungspfade im gateway (die Cookie-Schranke und die native Bearer-Route von Desktop) führen nun gleichzeitig eintreffende Anfragen mit demselben rotierenden Aktualisierungs-Token zu einem einzigen Vorgang zusammen. Dadurch kann eine Anfragenhäufung beim Aufwachen von Desktop nicht mehr ein bereits rotiertes Token erneut an die Wiederverwendungserkennung des Nous Portal senden und so die gesamte Sitzung widerrufen. Zudem läuft die Aktualisierung außerhalb der Ereignisschleife, sodass ein langsamer Identitätsanbieter /api/status nicht mehr einfriert. (2) Langlebige Prozesse erstellen keine doppelten Writer-Handles für state.db mehr: gateway, dashboard/Desktop-Backend, ACP und CLI-Reader greifen schreibgeschützt zu, während Writer innerhalb desselben Prozesses das Handle aus der Registry gemeinsam verwenden. Statistiken des Zeitfensters: „1.036 Nicht-Merge-Commits“ in „2.642 geänderten Dateien“ und „338 zusammengeführte PRs“. Alles Weitere wird bewusst aufgeschoben: Das Release benennt, was es nicht dokumentiert (Auswahlfelder für den Reasoning-Aufwand in jeder Modellauswahl, OpenRouter OAuth PKCE, HEIF-/HEIC-/AVIF-Dekodierung, eine Welle neuer FAL-Katalogeinträge, in Slack eingefügte Tabellen und API für Agent Sessions, die Verweigerung des WAL-Modus von state.db auf VM-übergreifenden Dateisystemen und mehr), und verpflichtet sich wörtlich zu einer kuratierten Dokumentation: „Vollständige kuratierte Versionshinweise für dieses Zeitfenster erscheinen mit v0.22.0, das alles ab v0.21.0 dokumentieren wird“ und „Nichts in diesem Zeitfenster 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 Datumssperre umgesetzt, nicht als Rücknahme im Code: Beim Tag v2026.9.14 enthält hermes_cli/plugin_compat.py den Wert COMPAT_REMOVAL_DATE = 2026-09-14, und removal_in_effect() gibt ab diesem Datum „true“ zurück (oder bereits dann, wenn die Manifestdatei fehlt). Ein betroffenes externes Plugin wird daher nun beim Laden deaktiviert und mit einem roten Hinweis versehen. Was noch NICHT geschehen ist: die Rücknahme, durch die 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 auf main. Deshalb funktioniert plugins.allow_deprecated_imports: true weiterhin als Ausweichmöglichkeit: Sobald der Loader fortfahren darf, lassen sich die alten Pfade noch auflösen. Dabei gibt es zwei Fallstricke: Der Schlüssel muss ein boolescher YAML-Literalwert sein (der Code akzeptiert ausschließlich den booleschen Wert True; eine Zeichenfolge in Anführungszeichen wie "true" oder "false" gilt gemäß dem Quellcodekommentar „Literal boolean only“ als nicht gesetzt), und diese Ausweichmöglichkeit entfällt, sobald die Rücknahme erfolgt, da die Pfade selbst dann verschwinden. Der Kompatibilitätskasten im Plugin-System enthält den aktuellen Stand.⁴²⁴⁹

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

Hermes Agent v0.21.2 (Tag v2026.9.11, 11. September 2026) dient in erster Linie dazu, die durch v0.21.0 verursachten Probleme zu beheben. Das Release bringt es auf den Punkt: „v0.21.0 enthielt eine umfassende Überarbeitung der Verbindungsverwaltung des Sitzungsspeichers, die state.db bei einigen Installationen instabil machte: Sekundäre 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 gesamte Fehlerklasse und bündelt alles Weitere, was in den vier Tagen seit v0.21.1 auf main gelandet ist.“ Anders als die bewusst knappe Release-Notiz zu v0.21.1 dokumentiert diese Version ihre eigenen Highlights. Die Statistik für diesen Zeitraum umfasst „947 Non-Merge-Commits“ in „1.869 geänderten Dateien“ sowie „312 zusammengeführte PRs“ von „140 Mitwirkenden“; die kuratierte Gesamtdokumentation der gesamten v0.21.x-Reihe bleibt v0.22.0 vorbehalten.⁴⁸

• Die state.db-Zuverlässigkeitsoffensive: sechs PRs, 44 geschlossene Issues. Die Hinweise für Betreiber stehen im Release an erster Stelle – und auch Sie sollten sie beherzigen: Wenn 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 ein Neuaufbau nicht aus, verweist er auf hermes sessions recover --inspect-only (offline, nicht destruktiv und an das jeweilige profile gebunden; prüft die Lesbarkeit der kanonischen Tabelle, ohne eine Ausgabedatenbank anzulegen). Die Behebung der Grundursache entfernt sämtliche sekundären Schreibprozesse aus dem Speicher: profile-gateways schrieben bislang alle 5 Sekunden den Status gehosteter Räume in die root-state.db. Diese Koordination erfolgt nun über eine eigene shared-state.db, sodass profile-gateways den zentralen Sitzungsspeicher nie mit Schreibzugriff öffnen. Das Dashboard öffnet ihn zunächst schreibgeschützt. Die Lebenszyklussicherung von cron nutzt nun die registrierte Verbindungsverwaltung statt eines direkten open() auf einer aktiven Datenbank, das die POSIX-Sperren des gateway aufhebt – das klassische Rezept für eine beschädigte SQLite-Datenbank. Außerdem verweigert doctor --fix einen checkpoint, dessen Sicherheit nicht nachweisbar ist. Weitere Verbesserungen betreffen nicht nur die Schreibprozesse: Schäden am FTS-Index beeinträchtigen jetzt lediglich die Suche, während der Index später neu aufgebaut wird, statt den gesamten Vorgang abzubrechen. Eine beschädigte Zeile bringt sessions list, den Export oder Insights nicht mehr zum Absturz; fehlerhafte Zeilen erscheinen als ?, begleitet von einer Warnung mit dem Namen der Sitzung. Sitzungen werden niemals an die Datenbank eines anderen profile gebunden und lesen auch nicht daraus. Zudem belegt ein schreibgeschützter Zugriff keine Schreibsperre mehr, wodurch ein einmaliger hermes-Aufruf hinter einem ausgelasteten gateway statt nach 4–20 Sekunden Wartezeit fehlzuschlagen nun nach 0,01 Sekunden abgeschlossen ist.⁴⁸
• Härtung der Isolation 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“ bereitstellt. In v0.21.2 bestanden bei diesem Versprechen noch Lücken, die nun geschlossen sind: Bots sekundärer profile übernahmen die Zulassungslisten des Standard-profile, Adapter konnten Zugangsdaten an den Host des Standard-profile senden, stdio-MCP-Server erhielten die Vault-Geheimnisse des Standard-profile, über MEDIA: konnten .env/auth.json/state.db eines anderen profile angehängt werden, Webhook- und Feishu-Callbacks konnten vom gerouteten profile abweichen und sekundäre profile konnten aus prozessbezogenen Zwischenspeichern den Nous-Bearer eines benachbarten profile übernehmen (#107609-#107630). Wenn Sie mehrere profile über ein einziges gebündeltes gateway betreiben, ist dies das Release, ab dem das Isolationsversprechen tatsächlich eingehalten wird.⁴⁸
• Der passwortblinde Zugangsdaten-Vault. Der Agent kann sich nun im Browser anmelden, Zahlungen ausführen und Adressen eintragen, 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 Agent dieselbe Struktur bereit – Anmeldemetadaten sowie einen undurchsichtigen, namensraumgebundenen Handle (vault_ lokal, op:, bw:), wobei das Passwort erst beim Ausfüllen aufgelöst wird. 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 dauerhaft gespeichert“. Dies baut auf der in v0.19.0 eingeführten SecretSource-Arbeit auf, durch die API-Schlüssel der Anbieter aus .env-Dateien im Klartext entfernt wurden. Der Vault erreicht nun dasselbe für die Browserzugangsdaten des Agent.⁴⁸
• Ein kuratierter, per SHA fixierter Plugin-Katalog. hermes plugins browse listet „jeden Eintrag des kuratierten 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-Sets“: Eine einzige hermes-pack.yaml fixiert eine Gruppe von Plugins auf exakte Commit-SHAs, pack install verteilt sie auf gewöhnliche fixierte Installationen, wobei die Zustimmung zu Funktionen weiterhin für jedes Plugin einzeln erfolgt, pack export erzeugt ein pack der aktuellen Installation und pack show dient als Probelauf. Der Befehlsblock unter Plugin-System enthält die neuen Unterbefehle.⁴⁸
• Kostenloser Nous-Tarif und geführter Erststart. Neuinstallationen bieten sofort kostenlose Inferenz und Konnektoren, wobei für die Anmeldung nur ein Befehl erforderlich ist. /login funktioniert innerhalb eines Chats und Konnektor-tools für Gmail, Linear, Notion und weitere Dienste lassen sich über tool_search finden. Der geführte Erststart der Desktop-Anwendung wird mit HERMES_GUEST_ONBOARDING=1 aktiviert, wobei ausschließlich der exakte Wert 1 gilt: Der eigene Test der Desktop-Anwendung bestätigt, dass 'true', '0' und ein leerer Wert die Funktion deaktiviert lassen. Außerdem wird die Startentscheidung in die Umgebung des erzeugten Backend-Prozesses geschrieben, sodass ein geerbter Wert niemals übernommen wird. Weitere Informationen finden Sie unter Nous Tool Gateway.⁴⁸
• Backend-Spawn-Stürme in der Desktop-Anwendung gehören der Vergangenheit an. Bot Mode erzeugte oder kontaktierte bislang beim Start und bei jeder Aktualisierung der Liste für jedes profile ein eigenes Backend. Beim Bewegen des Mauszeigers über die Bots-Liste wurde für jede Zeile ein Backend gestartet, und ein profile-Wechsel konnte ein zweites primäres Backend erzeugen. Sämtliche dieser Probleme wurden in diesem Release-Zeitraum behoben.⁴⁸

Der Aktualisierungsvorgang bleibt unverändert: Verwenden Sie bei einer bestehenden Installation hermes update und bei einer Neuinstallation das Shell-Installationsprogramm.⁴⁸

Neu in v0.21.1 (The Rollup Patch)

Hermes Agent v0.21.1 (Tag v2026.9.7, 7. September 2026) ist bewusst schlank gehalten: ein „Patch-Release“, das „den aktuellen Stand von main seit v0.21.0 für getaggte Deployments und nachgelagerte Anwender bündelt“. Der Text nennt die Zahlen für diesen Zeitraum – „5.139 Nicht-Merge-Commits in 4.364 geänderten Dateien (+601.014 / -768.419)“ und „632 zusammengeführte PRs“ – und vertagt anschließend die eigentliche Darstellung: „Vollständige kuratierte Release Notes für diesen Zeitraum erscheinen mit v0.22.0.“ Damit ist dies das größte Tag-zu-Tag-Fenster in der Geschichte des Projekts (kein früheres Fenster zwischen benachbarten Tags überschreitet die 2.790 Nicht-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 sich beim Betrieb von Hermes mit diesem Tag ändert; alle Angaben wurden im Quellcode verifiziert.⁴¹

• Die Codebasis wurde aufgeteilt, und am 14. September lief eine Frist für die Plugin-Kompatibilität ab. Bei der Aufteilung im September 2026 (PR #102117) wurden die großen Module des Repositorys in spezialisierte Dateien zerlegt: 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 ist unverändert: 39 statische Einträge, die weiterhin automatisch anhand der 39 mitgelieferten Provider-Plugin-Ordner erweitert werden), und delegate_task wurde auf etwa ein Dutzend Module unter tools/delegate_tool_* verteilt. Interne Importpfade sind keine stabile API. Deshalb exportiert eine neue Datei COMPAT_MANIFEST.md im Stammverzeichnis des Repositorys 1.148 „moved-lazy“-öffentliche Namen erneut über ihre alten Modulpfade. Bei deren Auflösung wird für jeden Namen einmal pro Prozess eine HermesPluginCompatWarning ausgegeben. Die Kompatibilitätsschicht war nur vorübergehend vorgesehen und wurde planmäßig am 14.09.2026 wirksam entfernt, sechs Tage nach dem Tag – nicht durch eine Rücknahme im Code, sondern über eine bereits im ausgelieferten Code enthaltene Datumsschranke. Seit diesem Datum wird ein betroffenes Drittanbieter-Plugin nicht geladen: Das CLI-Banner, hermes doctor und hermes update zeigen einen roten Hinweis mit dem Namen des deaktivierten Plugins, die Desktop-Anwendung zeigt einmalig ein modales Fenster, und hermes plugins list nennt den Grund. Wenn Sie externe Plugins verwenden, prüfen Sie diese: hermes plugins compat <path> gibt für jeden veralteten Pfad 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 Argument durchsucht der Befehl die gesamte installierte Plugin-Sammlung). Als Ausweichlösung für ein Plugin, dessen Autor die Umstellung noch nicht vollzogen hat, dient plugins.allow_deprecated_imports: true in config.yaml; diese Option funktioniert weiterhin: Die Änderung, welche die alten Importpfade tatsächlich löscht, war mit Stand vom 22. September noch nicht übernommen worden (verifiziert bis einschließlich 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 Neu in v0.21.2; der Abschnitt Plugin-System enthält den Kasten zum aktuellen Stand.⁴²
• Gateway-Konversationen werden überhaupt nicht mehr zeitgesteuert gewechselt. Die Dokumentation zum Sitzungslebenszyklus formuliert die Regel nun ausdrücklich: „Weder Inaktivität noch verstrichene Zeit führen jemals zum Wechsel einer Konversation. /new und /reset setzen eine explizite Grenze; lange Verläufe werden weiterhin durch Kontextkomprimierung verwaltet. Veraltete Timer-Konfigurationen werden ignoriert. Der vorhandene Datentyp SessionResetPolicy besteht als inaktive Kompatibilitätsinformation fort und ist keine Laufzeitrichtlinie.“ Grenzen werden ausdrücklich durch Benutzer gesetzt. Falls Sie über hermes claw migrate noch Sitzungs-Reset-Timer aus der OpenClaw-Ära übernommen haben, sind diese nun inaktive Daten. Siehe Messaging-Gateway.⁴³
• Die Autorisierung für MCP erhält einen Gerätecode-Ablauf. hermes mcp login <name> bekommt die Option --flow {browser,device}: browser bezeichnet den bestehenden PKCE-Ablauf, device eine Gerätecode-Anmeldung nach RFC 8628 für Rechner, auf denen ein Browser-Callback unpraktisch ist. Die Option überschreibt die Konfiguration oauth.flow des Servers. In diesem Zeitraum wurde auch die übrige Authentifizierungsoberfläche von MCP robuster gemacht: Die Eigentümerschaft von Profilen wird in allen OAuth-Sitzungen durchgesetzt, fehlerhafte OAuth-Metadaten-Caches werden ignoriert, statt einen Server zu blockieren, und die Desktop-Anwendung leitet MCP-OAuth über clientlokale Callbacks weiter. Ebenfalls relevant: -t/--toolsets filtert nun auch, welche konfigurierten MCP-Server überhaupt gestartet werden. Dadurch überspringt ein einmaliger Aufruf von hermes -z -t <toolsets> den Kaltstart nicht benötigter Server. Der Befehlsblock unter MCP-Integration enthält nun login und reauth [--all]. Beide Befehle gab es bereits vor diesem Zeitraum, sie waren hier jedoch noch nicht dokumentiert.⁴⁴
• Delegation bildet Hintergrundarbeit nun ehrlich ab. Sechs Zuverlässigkeitsverbesserungen an delegate_task, alle dem Quellcode des Delegate-Tools im betreffenden Tag entnommen. (1) Ein Hintergrund-Batch wird standardmäßig als EIN Abschluss zurückgegeben. Durch Aktivieren von delegation.independent_completions wird der Aufruf in Abschlusseinheiten aufgeteilt: Aufgaben mit demselben group-Wert werden zusammengefasst und gemeinsam gemeldet, während jede Aufgabe ohne Gruppe nach ihrer Fertigstellung einzeln gemeldet wird. Diese Standardeinstellung ist bewusst gewählt – laut Quellcode führte eine Flut einzelner Aufgabenabschlüsse zu „fragmentierten Orchestratoren, die darauf nicht vorbereitet waren“. (2) Die Hintergrundprozesse eines Childs werden bei dessen Abbau beendet, sofern das Child sie nicht mit process_manage(action="handoff") an das Parent übergibt. Nicht übergebene Überreste werden im Ergebnis als orphaned_processes aufgeführt; Child-Prozesse, die beendet wurden, ohne dass ihre Ausgabe jemals gelesen wurde, erscheinen als unread_completions einschließlich des Ausgabeendes. Die Haltung hinter diesem Design lautet gemäß dem Docstring im Quellcode: Das Parent „muss dies von der Laufzeit erfahren“, statt sich auf die Behauptung eines Childs zu verlassen, ein „Watcher laufe“. (3) delegation.fallback_providers wird zu einer echten Konfigurationsoberfläche: null übernimmt für nicht fest zugewiesene Childs die Kette des Parents, [] deaktiviert den Fallback, und ein über Provider, Endpunkt oder Modell festgelegtes Child erhält keinen Fallback, sofern diese Einstellung nicht ausdrücklich einen angibt. (4) Die Child-Fallback-Kette wird über den kanonischen Normalisierer aufgelöst, sodass fehlerhafte Einträge verworfen werden, statt das Starten zu verhindern. (5) Bei einem Absturz während einer Einheit gehen abgeschlossene Childs nicht mehr verloren: Jedes abgeschlossene Child einer Einheit mit mehreren Childs wird dauerhaft in der eigenen Zeile der Einheit gespeichert und bleibt im wiederhergestellten Ergebnis als Teilergebnis erhalten. (6) Subagents übernehmen niemals die einstündige Prompt-Cache-Stufe: Ein delegiertes Child wird auf die 5-Minuten-Stufe herabgesetzt, da die 1-Stunden-Stufe für eine Person ausgelegt und bepreist ist, die ihre Arbeit unterbricht, nicht für einen Schub paralleler Childs.⁴⁵
• 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-OAuth-Route ist Astra an das Konto gebunden (nur die Live-Erkennung für das jeweilige Konto darf es anbieten) und erhält eine optionale -900k-Auswahlvariante, welche das angegebene Kontextfenster von 272K auf live verifizierte rund 900K erhöht; das Suffix wird nie ü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 zur Bilderzeugung namens muse-image. Tavily kommt als Backend für Websuche und Extraktion hinzu (TAVILY_API_KEY; ohne Schlüssel funktioniert es, wenn Tavily über hermes tools ausgewählt wird). Eine verwaltete llama.cpp-Laufzeit macht lokale Modelle zu einem gleichwertigen Zugriffsweg (offizielle Binärdateien, ein überwachter llama-server, Einrichtung mit einem Klick in der Desktop-Anwendung), und externe, nicht im Repository enthaltene Prozess-Provider erhalten einen eigenen Auflösungszweig. Für den Betrieb gilt: Die Remote-Kataloge der Modellauswahl werden nun alle 20 Minuten aktualisiert (model_catalog.ttl_minutes, Standardwert 20); der alte Schlüssel ttl_hours wird nur berücksichtigt, wenn ein Benutzer ihn ausdrücklich gesetzt hatte.⁴⁶
• Desktop: Seite annotieren, Sitzung steuern. Der integrierte Browser erhält einen Kommentarmodus: Klicken Sie auf „Annotate“, anschließend auf ein beliebiges Element der Live-Seite (oder ziehen Sie einen Rahmen auf) und geben Sie eine Notiz ein. Gespeicherte Kommentare bleiben als nummerierte Markierungen sichtbar und senden selbstständig niemals einen Turn. Wenn Sie fertig sind, überträgt „Add N comments“ den gesamten Batch an den Composer, einschließlich eines zugeschnittenen Screenshots für jede Markierung. Jeder Elementkommentar enthält außerdem seinen CSS-Selektor, sein Markup und die für das Layout relevanten berechneten Stile. So findet der Agent das Element in Ihrem Quellcode, statt anhand eines Bildes raten zu müssen (Passwort- und ausgeblendete Werte sowie schlüsselartig benannte Attribute werden geschwärzt, bevor das Markup die Seite verlässt). Größere Batches werden nach Seitenbereich gruppiert. So werden aus etwas mehr als zwanzig Kommentaren einige wenige Arbeitspakete, die meist unterschiedliche Dateien betreffen – und genau deshalb können sie sicher auf parallele Worker verteilt werden. Ergänzend kommen strukturierte Sitzungssteuerungen sowie Steuerelemente für die Sitzungsautomatisierung, das Erstellen von Sitzungen per Ziehen, eine Sitzungsimportansicht für Transkripte fremder Coding-Agents, display.resume_last_session (standardmäßig true: Bei einem Kaltstart wird der letzte Chat oder die letzte Seite erneut geöffnet), eine beim ersten Öffnen angezeigte Einwilligungsabfrage, die browser.use_real_profile anbietet, wenn ein Browser-Fensterbereich bei deaktivierter Option geöffnet wird, ein integrierter Katalog optionaler Skills unter Capabilities -> Skills mit Installation per Klick und Russisch als neue Sprache für die Desktop-Benutzeroberfläche hinzu (die 17 Gebietsschema-Kataloge von CLI bleiben unverändert).⁴⁷

Das Aktualisierungsverfahren bleibt unverändert: hermes update für eine bestehende Installation oder das Shell-Installationsprogramm für eine Neuinstallation. Die kuratierte Dokumentation dieses Zeitraums ist 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 der gesamte v0.20.x-Rollup-Zyklus verwiesen hatte: „Dieses Release bündelt alles aus den Infrastruktur-Patch-Tags v0.20.1–v0.20.6 – diese Zeitfenster sind hier vollständig dokumentiert.“ Inhaltlich knüpft es an den 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 · mehr als 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-Zeitfensters 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 Eingabebereich beliebige Bots mit @ und versehen Räume mit Namen und Bildern. Zum Funktionsumfang gehören außerdem eindeutig zugeordnete Nachrichtenkarten für die Kommunikation zwischen Agenten, Zustellhinweise auf Absenderseite, Paint-first-Hydration für sofortiges Aufwachen, ein Routines-Bereich und eine Neuentwicklung auf Basis des App-Designsystems. Das Release selbst formuliert es so: „Früher bedeutete ‚Multi-Agent‘ vor allem technische Infrastruktur; heute sieht es aus wie eine Chat-App voller Kollegen.“³⁵
• hermes peer: Direktnachrichten zwischen Ihren Bots. Jeder Hermes-Agent kann jeden anderen anhand seines Handles kontaktieren – über profiles und gateways hinweg, aus der CLI oder innerhalb einer Unterhaltung. Bitten Sie etwa Ihren Recherche-Bot, Ergebnisse an Ihren Programmier-Bot weiterzugeben, und lesen Sie dessen Antwort dort, wo Sie sich gerade befinden. „Antworten gehen im kanonischen Bot Chat jedes Agenten ein. Unterhaltungen zwischen Agenten bleiben somit dauerhaft erhalten und nachvollziehbar, statt nach einmaligem Versand zu verschwinden.“ Der Befehl hermes peer (Peers hinzufügen, auflisten und entfernen sowie dm) ist in der Tabelle Befehle der obersten Ebene aufgeführt.³⁵
• Cron-Jobs mit Erinnerungsvermögen. Geplante Jobs leiden nicht länger unter Gedächtnisschwund: Cron-Agenten laden und aktualisieren wie jeder andere Agent einen dauerhaften Speicher. Mit continuity=true wird die Ausgabe jedes Durchlaufs in den nächsten übernommen, sodass ein Monitor bereits gemeldete Informationen erkennen und Duplikate vermeiden kann. Jeder Job erhält zudem einen dauerhaften Notizblock, Jobs im Monitor-Modus überspringen die 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 landen, wo dieser tatsächlich darauf reagiert. Im Abschnitt Geplante Aufgaben (Cron) wird nun die genaue Funktionsweise dieser Elemente zum Zeitpunkt des Tags erläutert.³⁵³⁷
• Live-Orchestrierung von Subagenten. delegate_task erhält Steuerungsaktionen: Sie können laufende untergeordnete Agenten auflisten, einem davon während der Ausführung eine Kurskorrektur übermitteln oder ihn vorzeitig stoppen und das Teilergebnis behalten. Ausgaben untergeordneter Agenten lassen sich anhand eines JSON-Schemas validieren, die Kosten jeder Delegierung werden in den Ergebnissen ausgewiesen und die Standardwerte steigen auf 250 Iterationen pro Subagent sowie 10 gleichzeitig aktive untergeordnete Agenten – die einheitlichen Obergrenzen, die in v0.19.0 max_async_children ersetzt haben.³⁵³⁸
• Die MCP-Kommandozentrale. MCP-Server und Katalog werden auf einer einzigen Desktop-Seite zusammengeführt. Diese bietet einen „Beliebige Inhalte einfügen“-Import per Drag-and-drop, Hintergrundzustandsprüfungen, die Sie zur erneuten Authentifizierung auffordern, bevor ein Tool-Aufruf fehlschlägt, eine Kosten- und Nutzungsübersicht für die gesamte Flotte (Schätzungen der Schema-Token und 30-Tage-Nutzung pro Server) sowie hermes://-Deep-Links, über die sich ein MCP-Server nach ausdrücklicher Bestätigung installieren lässt. Siehe MCP-Integration.³⁵
• Eine neue Leistungswelle für die CLI. Mit Strg+P öffnen Sie eine unscharfe Befehlspalette, die auch über /palette erreichbar ist. Die /model-Auswahl filtert während der Eingabe, /status zeigt Reasoning-Modus, ausstehende Genehmigungen und Kontextnutzung an und die Statusleiste kann die aktuelle Cache-Trefferquote in Prozent, Latenz und Token pro Sekunde darstellen, wobei jedes Feld einzeln ein- oder ausgeblendet werden kann. Hinzu kommen ein globaler Not-Aus, das Anheften und Lösen von Sitzungen, wechselnde Platzhalter im Eingabebereich und Terminal-Haustiere. Ein Hinweis zur Benennung: Das Release bezeichnet eine Genehmigungsprüfung im Probelauf als hermes approval-check; beim Tag lautet diese Oberfläche 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 und liest Inhalte direkt. Seiten lassen sich außerdem mit vollständigen Link-Kontextmenüs in Ihrem Systembrowser öffnen.³⁵
• Sechs neue Anbieter 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 Rollup-Zeitfenstern eingeführt und waren schon in der Anbietermatrix enthalten. Nun ergänzt die Matrix Tencent TokenPlan, Nebius Token Factory und Ramp Router sowie die neue Alibaba Token Plan-SKU aus der Dokumentation. In die Kataloge kommen GLM-5.3-Flash, qwen3.8-max/flash, Gemini 3.7 Flash, MiniMax M3 free, Nemotron 3.5 Lightning und Muse Spark 1.2 hinzu. Damit gehen zwei strukturelle Änderungen einher: Mit model_overrides in config.yaml können Sie das Kontextfenster oder die Preisangaben eines beliebigen Modells anpassen, ohne auf ein Release warten zu müssen. Außerdem lassen sich Anbieter nun als über pip installierte Pakete bereitstellen, die über Einstiegspunkte erkannt werden. Eine einheitliche Auswahlprüfungsregistrierung warnt zudem in jeder Auswahloberfläche, wenn ein Modell mit Ihren Daten trainiert.³⁵³⁶
• Umfassende Sicherheitshärtung. Schreibzugriffe auf geschützte Agentenanweisungsdateien (AGENTS.md, skills und Speicherablagen) 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 destruktive Windows-Befehle, macOS-Berechtigungen bleiben dank einer stabilen TCC-Signieridentität (hermes desktop --setup-tcc-identity) auch nach Aktualisierungen erhalten und der Blender-MCP-Katalogeintrag samt skill wurde nach einer Kompromittierung des vorgelagerten Projekts entfernt. Einzelheiten zum Stand dieses Tags finden Sie unter Sicherheitshärtung.³⁵³⁹
• Weiterentwicklung des gateway. Slack erhält native Live-Karten mit tatsächlich gestreamten Antworten sowie optionalen Plan- und Aufgabenkarten und kann Vorschauen ausgehender Links unterdrücken. Telegram bekommt eine Inline-Auswahl, über die jeder Befehl und jeder skill mittels @botname durchsuchbar ist, womit die Begrenzung des Telegram-Befehlsmenüs umgangen wird. Der Relay-Kanal wird ausgebaut: native Plugin-Initialisierung, Live-Kartenoperationen mit Entwurfsstreaming, Segmentierung von Sitzungsspannen und wiederhergestellte Sprachnotiztranskription. Über einen gateway-Steuerungssocket können Flottenanwendungen das gateway abfragen, während Updater es geordnet pausieren können, anstatt den gesamten Prozessbaum zu beenden. Zudem erfasst der Turn-Reaper die Stacks blockierter Worker, wenn 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, social-media-content-calendar), aus HAR-Daten abgeleitete API-Clients („Beobachten Sie eine Website einmal und rufen Sie anschließend ihre verborgene API ohne Browser direkt auf“), publish-site, session-librarian, blocked-page-recovery, merge-reconciler, plan-interrogation sowie ein beratender SKILL.md-Linter beim Erstellen.³⁵

In diesem Zeitfenster zurückgenommen (nicht enthalten): Sowohl der Model Council-Modus (/council) als auch die DCP-context engine wurden zunächst integriert und anschließend zurückgenommen. Der ausschließlich auf WS basierende gateway-Server (#94245) wurde zusammengeführt und später ebenfalls zurückgenommen (#96118), sodass FastAPI weiterhin Teil des Desktop-Startpfads bleibt – die mit Sequenznummern versehene Ereigniswiedergabe (#94219) und die verlustfreie erneute Desktop-Verbindung über WebSocket WURDEN jedoch ausgeliefert. Electron wurde auf 40.10.2 zurückgesetzt. Sollten Berichte aus der Community zu den v0.20.x-Zeitfenstern eine dieser Funktionen erwähnt haben, sind sie in diesem Release nicht enthalten.³⁵

Das Aktualisierungsverfahren bleibt unverändert: hermes update bei einer bestehenden Installation oder das Shell-Installationsprogramm für Neuinstallationen. Der Rollup-Unterabschnitt unter dem nachfolgenden Herald-Release dokumentiert weiterhin für jeden einzelnen Tag, welche Änderungen in welchem Zeitfenster eingeführt wurden.³⁵

Neu 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 bündelte; v0.20.1 (13. August) und v0.20.2 (16. August) sind darauf aufbauende Stabilisierungstags, und 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) setzen die Rollup-Reihe mit eigenen Funktionsfenstern fort — siehe den Unterabschnitt weiter unten. 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 Voraussetzung durch. Beachten Sie, dass die Installationsseite der Dokumentationswebsite noch Node v22 nennt — das Installationsskript und die Versionshinweise sind die neueren, maßgeblichen Quellen.⁵⁵
• pip und Homebrew wurden eingestellt, nicht bloß als veraltet markiert. Im Wortlaut: „brew + pip/PyPI wheel channels retired (shell installer / Docker / Nix are the supported channels).“ Wenn Sie Hermes noch über pip oder brew installiert haben, erhält dieser Installationsweg keine 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 alle weiter unten genannten Schwellenwerte für knappe Budgets werden anhand des neuen Limits berechnet. read_file verwendet nun außerdem standardmäßig 2.000 statt 500 Zeilen.⁵⁵

Die weiteren Neuerungen des Releases:

• Konversationsstimme. 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 Agents, 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.⁵⁵
• Quellengebundene Zitate. Ein neuer skill mit einem Modus zur Faktenprüfung.⁵⁵
• Eine Welle neuer Funktionen für CLI-Power-User. Mit !command führen Sie sofort einen Shell-Befehl aus, ohne einen Modell-Turn zu verbrauchen; /init durchsucht das Projekt und erstellt oder aktualisiert eine AGENTS.md; /diff zeigt über jede Oberfläche bereitgestellte, sämtliche oder sitzungsbezogene Änderungen an; /context schlüsselt auf, womit das Kontextfenster belegt ist; /focus bietet eine Ansicht mit reduzierter Ausgabe und der Möglichkeit, ausgeblendete Zeilen wiederherzustellen; Ctrl+S legt einen halbfertigen Prompt zurück. hermes import-agent migriert eine Claude Code- oder Codex-CLI-Einrichtung mit einem einzigen Befehl.⁵⁵
• Erweiterungen für die Verwaltung von Geheimnissen. Eine befehlsbasierte Hilfsquelle für Geheimnisse, die sich mit jedem Tresor kombinieren lässt, Token-Rotation mit einem einzigen Befehl und aussagekräftigen Startfehlern, ein optionaler verschlüsselter Notfall-Cache für Bitwarden, pro profile-Home abgegrenzte und vom Tresor eingespeiste Schlüssel sowie ${env:VAR}-SecretRef-Parität zwischen config.yaml und der MCP-Konfiguration. Das weiter unten 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-Remote-Backend-Modus und native Anmeldung nach 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 getaggte Rollups, die weit mehr als bloße Stabilisierung brachten. Alle vier verschoben kuratierte Versionshinweise mit derselben Formulierung — jeweils hieß es, „full curated release notes for this window will ship with v0.21.0“ — und mit v0.21.0 liegen diese nun vor: Neu in v0.21.0 weiter oben ist die kuratierte Dokumentation dieses gesamten Zeitraums (das Release bestätigt, dass die Zeitfenster „are fully documented here“). Die folgenden 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 sie zusammenfassen.^54233035

v0.20.3 (~250 Commits, ~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 Generation von MCP SDK und unterstützt die zustandslose Revision des Protokolls.⁵⁴
• Bot Mode wird als gebündeltes Plugin ausgeliefert (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 gehärtete Besitzverwaltung der Python-Laufzeit für Unterprozesse (PYTHONHOME/PYTHONPATH-Isolierung).⁵⁴
• Zuverlässigkeit: Selbstheilung des cron-Schedulers (EMFILE-Wiederherstellung, Abgleich veralteter Beanspruchungen, erneute Aktivierung festgefahrener Jobs), Korrekturen gegen Datenverlust bei Sitzungsübergaben, selbstheilende Verbindungen zum Remote-gateway der Desktop-Anwendung und eine Reihe von Portierungen aus dem Ökosystem (Sicherheitsscans bei der Plugin-Installation, /worktree, Erhaltung manueller Änderungen durch /rollback, Lesen von UTF-16-Dateien).⁵⁴

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

• Die Glasoberfläche der Desktop-Anwendung: Arbeiten an mattem Glas und Transparenzeffekten mit einem Frost-Auswahlwerkzeug und Vorauswahl für macOS.⁵⁴
• Eine Seitenleiste mit den Tabs SESSIONS|BOTS und der Möglichkeit, einzelne Bots ein- oder auszublenden, außerdem Korrekturen für Gruppenchats im Bot Mode (lang laufende Turns von Mitgliedern, Markdown-Darstellung, maschinenübergreifendes Routing).⁵⁴
• Beratende NVIDIA SkillEvaluator-Tier-1-Prüfungen bei der Installation von skills — Lizenz- und Sicherheitsprüfungen werden ausgeführt, wenn Sie einen skill installieren.⁵⁴
• Härtung des Medienversands durch cron (konfigurierbares Zeitlimit, Anhänge bei manueller Ausführung, Anzeige verpasster Ausführungen), Korrekturen für den Event-Loop-Thread und Ressourcenkonflikte in SessionDB, ehrliche Angaben von hermes update zu geparkten Branches sowie native Betriebssystembenachrichtigungen für Kanban.⁵⁴

v0.20.5 (~746 Commits, ~323 PRs seit v0.20.4):

• Die schlüssellose Webebene: Die Websuche funktioniert bei Neuinstallationen ohne jegliche API-Schlüssel — mit einer kostenlosen Rotation über 5 Anbieter und Ring-Failover.²³
• Eine CLI-Überarbeitungswelle: eine unscharfe /model-Auswahl, eine Befehlspalette über Ctrl+P und ein informativeres /status.²³
• Bot Mode wird erwachsen: Threads in Gruppenräumen, einklappbare Gesprächszusammenfassungen, Blob-Face-Avatare sowie PDF-/Dateianhänge per Drag-and-drop.²³
• Werkzeuge für Flotten und Worktrees: Belege von hermes update, hermes update --plan (die Versionshinweise bezeichnen dies als „fleet --plan verification“; 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 einen individuellen Reasoning-Aufwand pro Job, außerdem von den Composio-Evaluierungsergebnissen abgeleitete Regeln für die Ausführungsdisziplin und Schutzmechanismen gegen Laufzeitstillstände, Klärung durch mehrere Fragen, den opencode-freien Provider ohne Authentifizierung sowie Leistungsverbesserungen für die Desktop-Anwendung (darstellungspriorisierte Initialisierung des Bot Mode, React Compiler in beiden Renderern).²³

v0.20.6 (Tag v2026.8.27, 27. August — ~1.313 Commits, ~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 dieses Zeitfenster etwa 1.313 Commits in rund 1.557 Dateien (+177.113/−21.682) und etwa 525 zusammengeführte PRs.³⁰ Die wichtigsten Punkte aus dieser Beschreibung:

• Zustimmungsabhängiges Browsen mit dem echten profile — lokales Browsen kann Ihr standardmäßiges Chromium-profile verwenden; unter Windows steht dafür ein Ablauf zum Schließen nach erfolgter Genehmigung zur Verfügung.³⁰
• Der Browser der Desktop-Anwendung erhält ein eigenes Betriebssystemfenster, außerdem eine verwaltete SSH-Engine für Remote-Aktualisierungen und eine profile-Leiste für Flotten.³⁰
• Erweiterung des Remote-MCP-Katalogs: mehr als 50 live verifizierte, 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-Ergebnis-Caching für web_search/web_extract und tool_search für mehrere Abfragen mit Wortstammerkennung.³⁰
• Lean-Tail-Komprimierung ist jetzt der Standard — der Abschnitt Kontextkomprimierung weiter unten dokumentiert die Konfiguration zum Zeitpunkt des Tags.³⁰³¹
• Terminal-Backends sind jetzt austauschbar — siehe Terminal-Backends.³⁰³²
• Ehrlichkeit bei Updater und Flotte: Updater pausieren gateways über den Kontroll-Socket, statt ihre Prozessbäume zu beenden, und über Images oder Pakete verwaltete Installationen verweigern unsichere direkte Aktualisierungen.³⁰
• Dauerhafte Bestätigungen von cron-Vorfällen mit verständlicheren Fehlern bei abweichenden Codeversionen, Steuerungsmöglichkeiten für die Link-Vorschau in Slack und gemeinsam verwendete Docker-Containeridentitäten.³⁰

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

Neuerungen in v0.19.0 (The Quicksilver Release)

Hermes Agent v0.19.0 (Tag v2026.7.20, 20. Juli 2026) ist nach der Geschwindigkeit des Botengottes selbst benannt: Im Zentrum des Releases steht kompromisslose Reaktionsschnelligkeit, wobei die Zeit bis zum ersten Token beim ersten Durchlauf auf allen Plattformen um etwa 80 % verkürzt wurde. Hinzu kommen Abrechnungsfunktionen im Terminal, Passwortmanager als Quellen für Geheimnisse, standardmäßig intelligente Genehmigungen, beobachtbare Subagents und eine ausfallsichere Antwortzustellung. Seit v0.18.0 gab es so viele Änderungen wie nie zuvor im Projekt: etwa 2.245 Commits, rund 1.065 zusammengeführte PRs, circa 3.300 geschlossene Issues und mehr als 450 Mitwirkende aus der Community.⁵⁶

• Überall etwa 80 % schneller bis zum ersten Token. Die Zeit vom Kaltstart über das Absenden bis zur Verarbeitung sank 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 entfernt. Auch die wahrgenommene Latenz wurde optimiert: Reasoning-Modelle streamen ihre Gedankengänge nun standardmäßig live (display.show_reasoning ist aktiviert), und das Antwortfeld wird pro Token statt pro Zeile aktualisiert.⁵⁶
• Rendering-Optimierungen für Desktop und TUI. Die Desktop-App erhielt mit rund 20 PRs eine umfassende Geschwindigkeitsoptimierung: 14-mal weniger CPU-Auslastung im Streaming-Markdown-Splitter durch inkrementelle Blockanalyse, virtualisierte Diffs im Prüfbereich, schnelle Sitzungswechsel auch bei großen Transkripten sowie keine erneuten Renderings der Seitenleiste und Werkzeugzeilen mehr bei jedem Token. Die TUI rendert gestreamtes Markdown nun inkrementell blockweise.⁵⁶
• Installationen über pip und Homebrew sind veraltet. Beide Wege wurden als „nicht unterstützte Legacy-Installationen“ gekennzeichnet, deren Entfernung geplant war. Diese Entfernung ist inzwischen mit v0.20.0 erfolgt — die Kanäle brew und pip/PyPI-Wheel wurden eingestellt; unterstützt werden nur noch der Shell-Installer, Docker und Nix.⁵⁶⁵⁵
• Geheimnisse können aus Ihrem Passwortmanager stammen. Eine neue austauschbare SecretSource-Schnittstelle ruft Geheimnisse beim Laden aus Bitwarden und 1Password (op://-Referenzen) ab. Mehrere Vaults lassen sich gleichzeitig verwenden, wobei eine deterministische Prioritätsreihenfolge, Konfliktwarnungen und Herkunftsinformationen für jede Variable unterstützt werden — API-Schlüssel müssen nicht mehr in einer unverschlüsselten .env-Datei liegen. Künftige Vault-Anbieter lassen sich als Plugins ergänzen.⁵⁶
• Intelligente Genehmigungen sind jetzt Standard. Wenn Hermes einen als kritisch eingestuften Befehl ausführen möchte, bewertet ihn ein unabhängiger LLM-Prüfer, statt Sie bei jedem einzelnen Befehl um Erlaubnis zu bitten — jede Entscheidung gilt ausschließlich für genau diesen Befehl. Benutzerdefinierte Ablehnungsregeln blockieren passende Befehle selbst im YOLO-Modus, /deny <reason> übermittelt den Grund Ihrer Ablehnung, damit der Agent seinen Kurs korrigieren kann, und die erneut eingeführte Genehmigungsaktion pre_tool_call des Plugins mit Regelschlüsseln übergibt einen Werkzeugaufruf zur menschlichen Freigabe.⁵⁶
• Abrechnung im Terminal: /subscription und /topup. Verwalten Sie Ihren Nous Portal-Tarif, ohne das Terminal zu verlassen — prüfen Sie Ihren Tarif und das verbleibende Kontingent, sehen Sie vorab genau, was ein Upgrade kostet oder wann ein Downgrade wirksam wird, und wenden Sie die Änderung mit Rückgängig-Option an. Die Desktop-App erhält eine entsprechende Registerkarte für Abrechnungseinstellungen.⁵⁶
• Verfolgen Sie die Arbeit von Subagents und verlieren Sie nie wieder eine fertige Antwort. delegate_task-Aufträge liefern Live-Transkriptdateien zurück, die Sie direkt nach dem Start der Subagents mit tail -f verfolgen können — jeder Werkzeugaufruf, jedes Ergebnis und jede gestreamte Antwort erscheint in einem menschenlesbaren Protokoll pro untergeordnetem Agenten. Abschlüsse von Delegierungen im Hintergrund 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 das gateway während des Sendens ausfällt. Die Konfigurationsoption max_async_children ist zugunsten einheitlicher Parallelitätsgrenzen für Delegierungen veraltet.⁵⁶
• Ein gateway, viele profiles. Ein einziges gemultiplextes gateway kann über ein gemeinsames Bot-Token bestimmte Guilds, Kanäle oder Threads an verschiedene profiles weiterleiten — jeweils mit vollständig isolierter Konfiguration, eigenen skills, eigenem Speicher und eigenen Geheimnissen — einschließlich einer Überschreibung durch GATEWAY_MULTIPLEX_PROFILES. Der Routingindex wurde nach state.db verschoben; sessions.json ist jetzt nur noch eine optionale Legacy-Spiegeldatei.⁵⁶
• Neue Anbieter und Modelle. Fireworks AI erhält erstklassige 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, durchgängig integriert), grok-4.5 (GA), kimi-k3 (kimi-k2.x wurde eingestellt) und das vollständig integrierte Claude Sonnet 5 ergänzt. Mit dem anbieterspezifischen Flag enabled: false und der Konfiguration excluded_providers lassen sich ungenutzte Anbieter aus den /model-Auswahllisten und der Auflösung entfernen.⁵⁶
• Der Reasoning-Aufwand wird regelbar. Die neuen Aufwandsstufen max und ultra stehen auf allen Oberflächen zur Verfügung, ergänzt durch modellspezifische Überschreibungen in der Konfiguration, einen eigenen Aufwand pro Slot in MoA-Voreinstellungen — Berater denken gründlich nach, während der Synthesizer schnell bleibt —, einen aufgabenspezifischen Aufwand für Hilfsmodelle und ein sitzungsbezogenes /reasoning im CLI.⁵⁶
• Neue Funktionen für CLI und MCP. hermes sessions export exportiert in die Formate Markdown, Quarto, HTML, „nur Prompt“ und Hugging Face Trace, optional mit einer Bereinigung durch --redact; /model --once überschreibt das Modell für einen Durchlauf; Aufrufe von Slash-skills lassen sich kombinieren (/skill-a /skill-b do XYZ); --safe-mode erleichtert die Fehlerbehebung; 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: Eine Installation über pip oder Homebrew wird nun als nicht unterstützte Legacy-Installation gemeldet — wechseln Sie zum Einzeilen-Installer —, und max_async_children ist zugunsten einheitlicher Parallelitätsgrenzen für Delegierungen veraltet. Alle anderen Änderungen sind additiv — die wichtigsten Gründe für ein Upgrade sind die um etwa 80 % verringerte Latenz beim ersten Durchlauf, intelligente Genehmigungen und das Zustellungsregister, das fertige Antworten ausfallsicher macht.

Neuerungen in v0.18.0 (The Judgment Release)

Hermes Agent v0.18.0 (Tag v2026.7.1, 1. Juli 2026) steht im Zeichen des Urteilsvermögens: Der Agent überprüft seine eigene Arbeit, statt Erfolg lediglich zu behaupten, und ermöglicht Ensemble-Reasoning, das Sie tatsächlich nachvollziehen können. 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 lässt sich nun in allen Oberflächen wie jedes andere Modell auswählen, und das Ensemble-Reasoning ist sichtbar: Die vollständige Ausgabe jedes Referenzmodells wird in einem eigenen beschrifteten Block dargestellt, während die Antworten live gestreamt werden — so können Sie dem Ensemble beim Denken zusehen, statt nur 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 den Erfolg lediglich zu behaupten — Urteilsvermögen, auf sich selbst angewandt.²²
• /learn — beschreiben Sie einen beliebigen Ablauf und machen Sie daraus einen skill. Verwandeln Sie einen Arbeitsablauf durch dessen Beschreibung in einen wiederverwendbaren skill; generierte skills entsprechen automatisch den Konventionen in CONTRIBUTING.md des Repositorys.²²
• /journey-Zeitleiste. Eine visuelle, bearbeitbare Chronik von Speicher und skills im Zeitverlauf sowie ein Speichergraph auf dem Desktop.²²
• Auffächerung von Subagents im Hintergrund. Delegieren Sie mehrere Aufgaben, die gleichzeitig ausgeführt werden, ohne die Unterhaltung zu blockieren — aus dem einzelnen Subagent im Hintergrund von v0.17.0 wird eine ganze Flotte.²²
• Desktop Projects. Vollwertige Programmier-Projects mit einem Organisationsmodell aus Projekt, Repository und Lane.²²
• Scale-to-zero-gateway. Gateways können bei Inaktivität in den Ruhezustand wechseln und das kontrollierte Beenden laufender Aufgaben für nahtlose Bereitstellungen koordinieren — besonders relevant für alle, die Hermes als dauerhaft verfügbaren Dienst betreiben.²²
• Unterstützung für Google Vertex AI. Gemini-Zugriff über GCP-Dienstkonten mit automatischer Aktualisierung des OAuth2-Tokens als Ergänzung des Anbieterkatalogs.²²
• Editorbefehl /prompt. Öffnet $EDITOR, damit Sie mehrzeilige Prompts verfassen können, statt mit der Eingabezeile zu kämpfen.²²

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 —, ein vollwertiges MoA mit nachvollziehbaren Ensembles und /learn zur Erfassung von skills.

Neues 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 gewachsenen Reichweite des Agenten – neue Messaging-Kanäle, neue Modellanbieter sowie eine umfassendere Steuerung über Desktop und Dashboard. Die Version erweitert v0.16.x; die CLI-Oberfläche bleibt unverändert.²¹

• Neue Messaging-Kanäle. iMessage funktioniert jetzt über Photon Spectrum ohne Mac-Relay (Gerätecode-OAuth, hermes photon login); die WhatsApp Business Cloud API ist ein offizieller Meta-Adapter, der den bisher erforderlichen Bridge-Prozess ersetzt; SimpleX unterstützt nun Gruppen, native Anhänge, Textbündelung und automatische Annahme; außerdem kommt Raft als gebündeltes Plattform-Plugin mit einem Wake-Channel-Design hinzu, dessen Datenschutz vertraglich zugesichert wird.²¹
• Neue Modelle und Anbieter. Der Katalog enthält nun 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). 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 unterstützt jetzt Hintergrund-Subagenten mit live gestreamten „Beobachtungsfenstern“ für delegierte Aktivitäten (delegate_task(background=true)), eine Modellauswahl im Composer, frei belegbare Tastenkürzel, native Betriebssystembenachrichtigungen, eigene Composer-Entwürfe pro Thread, Themes aus dem VS Code Marketplace sowie eine japanische und traditionell-chinesische Benutzeroberfläche. Das Dashboard erhält 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-Befehle, Unterhaltungen und Dokumentation) sowie eine sichere Anmeldung, die hinter der OAuth-Zugriffskontrolle den Statuscode 401 zurückgibt.²¹
• Skills und Tools. image_generate kann ein Quellbild nun bei allen unterstützten Bildanbietern bearbeiten und transformieren, statt nur neue Bilder zu erstellen; das memory-Tool unterstützt ein operations-Array, um Hinzufüge-, Ersetzungs- und Entfernungsvorgänge atomar in einem einzigen Aufruf auszuführen; ein neuer simplify-code-skill führt parallel eine Überprüfung und Bereinigung durch drei Agenten aus, deren Freigabe von einer auf Chestertons Zaun basierenden Risikostufe abhängt; außerdem ersetzt der boolesche Wert write_approval den dreistufigen Wert 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 verspätet verbundene MCP-Tools werden zwischen Turns cache-sicher bereitgestellt; cron wird zu einem austauschbaren CronScheduler mit Chronos als Anbieter für verwaltete cron-Aufgaben; zudem können Administratoren über einen neuen Managed scope (/etc/hermes) für Benutzer unveränderliche Konfigurationen festschreiben. 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 ist jetzt optional, sodass die routinemäßige Hintergrundkuratierung keine Tokens verbraucht.²¹
• Sicherheit. v0.17.0 schließt eine Umgehungsmöglichkeit der Denylist für Shell-Escapes, verweigert bei fehlenden Freigabemodulen und Gateway-Adaptern mit eigener Richtlinie standardmäßig den Zugriff, bereinigt die Umgebung für Unterprozesse von cron-Aufgabenskripten, 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, beeinträchtigt nichts davon die 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 administrative Managed scope.

Neues 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 CLI-zentrierten Agenten zugänglich machen. Die zentrale 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 mit Ein-Klick-Installation und integrierten automatischen Updates. Sie bietet Ihnen ein Chatfenster mit Streaming-Ausgabe, Drag-and-drop-Dateien, das Einfügen von Bildern aus der Zwischenablage, eine Cmd+K-Palette, eine Sitzungsliste mit Archivierung und Suche sowie eine Modellauswahl in der Statusleiste. Über eine sichere WebSocket kann sie sich mit einem entfernten Hermes gateway verbinden und sich per OAuth oder Benutzername und Passwort authentifizieren. Dabei werden entfernte Hosts pro profile sowie parallele Sitzungen in mehreren profiles unterstützt, die sich über profile-übergreifende @session-Verweise verknüpfen lassen. Die Desktop-Benutzeroberfläche enthält außerdem über eine typisierte i18n-Schicht (display.language; Englisch bleibt die Standardsprache) eine vollständige Übersetzung ins vereinfachte Chinesisch (简体中文).²⁰
• Browserbasiertes Administrationspanel. Das lokale Web-Dashboard wurde von einer Statusansicht zu einem vollständigen Administrationspanel ausgebaut: ein MCP-Katalog mit Schaltern zum Aktivieren und Deaktivieren, Anmeldedatenverwaltung, Erstellung von Webhooks und Hooks, Speicherkonfiguration, Gateway-Steuerung sowie eine Systemseite mit Prüfung vor Updates und Ein-Klick-Debug Share. Auf einer neuen Seite „Channels“ lassen sich sämtliche Messaging-Plattformen des gateways (Telegram, Discord, Slack und alle weiteren) im Browser konfigurieren. Die Authentifizierung ist jetzt austauschbar: Anmeldung mit Benutzername und Passwort, ein generischer selbst gehosteter OIDC-Anbieter, hermes dashboard register für einen selbst gehosteten OAuth-Client sowie die Rotation von Sitzungen mittels Aktualisierungstokens.²⁰
• Neue CLI- und Slash-Befehle. /undo [N] setzt die letzten N Benutzer-Turns mit vorausgefülltem Inhalt und Soft-Delete zurück und funktioniert in der CLI, der TUI sowie auf allen Messaging-Plattformen. Hinzu kommen eine konfigurierbare Standardschnittstelle (cli oder tui) mit einer --cli-Überschreibung sowie ein einheitlicher /model-Befehl und ein Sitzungs-Overlay für die TUI. hermes portal ist ein leicht verständlicher Alias für den Onboarding-Ablauf von Nous Portal, der nun beim ersten Start die Optionen „Quick Setup“ und „Full Setup“ bietet. Zwei neue Diagnosebefehle kommen ebenfalls hinzu: hermes prompt-size und hermes sessions optimize.²⁰
• Neue Modelle und Anbieter. Die Auswahl enthält nun 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). Ein vollwertiger xAI Grok OAuth-Anbieter ergänzt den Desktop-Launcher, die Modellauswahl unterstützt jetzt auf jeder Oberfläche eine unscharfe Suche, Anbieter mit mehreren Endpunkten werden in einer Zeile gruppiert, und der Katalog wird statt täglich nun stündlich aktualisiert.²⁰ (Seit v0.21.1 wurde das Intervall erneut geändert: Die Remote-Kataloge der Auswahl werden alle 20 Minuten aktualisiert, model_catalog.ttl_minutes.⁴⁶)
• Schlankere skills und progressive Offenlegung. Aus dem standardmäßigen skill-Set wurden redundante und nicht mehr verwendete skills entfernt (Spotify wechselte zu einem nativen Plugin, Linear zu hermes mcp install linear, und mehrere veraltete Einträge entfielen); weitere skills wurden optional, und eine neue Relevanzprüfung über environments: im Frontmatter (kanban/docker/s6) hält kontextspezifische skills aus dem Index heraus, bis sie angefordert werden. NVIDIA/skills ist neben OpenAI, Anthropic und HuggingFace nun standardmäßig eine vertrauenswürdige Skills Hub-Quelle. MCP- und Plugin-Tools unterstützen jetzt eine progressive, bereichsbezogene Tool-Offenlegung. 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 die 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, nimmt bws_cache.json in den Dateisicherheits-Leseschutz auf, ergänzt die Liste gefährlicher Muster um docker restart/stop/kill und bereinigt unsichtbare Unicode-Zeichen in überprüften skill-Inhalten. Mit dem Release wurden 2 P0- und 62 P1-Probleme behoben, davon 16 mit Sicherheitskennzeichnung.²⁰

Wenn Sie von v0.15.x aktualisieren, stellt nichts davon eine inkompatible Änderung an der CLI selbst dar; vielmehr ergänzen neue Oberflächen und Anbieter denselben Agenten. Die Desktop-App und das Administrationspanel sind die entscheidenden Upgrade-Gründe, wenn Sie Hermes für Benutzer ohne Terminalkenntnisse bereitstellen oder ein entferntes gateway über den Browser verwalten möchten.

Neues in v0.14.0 (The Foundation Release)

Bei v0.14.0 steht weniger eine einzelne herausragende Funktion im Mittelpunkt als vielmehr ein reibungsloseres Setup bei gleichzeitig erweiterten Einsatzmöglichkeiten für 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 der Startpfad verzögert genügend Arbeitsschritte, um den Kaltstart um etwa 19 Sekunden zu verkürzen. (Seit v0.19.0 gelten pip-Installationen als veraltet – siehe Installation.)
• Abonnements können als lokale API-Endpunkte dienen. hermes proxy verwandelt über OAuth authentifizierte 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 ergänzen das gateway (die Plattformvergleichstabelle der Dokumentation führt beim Tag v2026.8.31 28 Plattformen auf; der Abschnitt Messaging Gateway erläutert, was diese Zahl umfasst), Microsoft Teams ist vollständig integriert, das nachträgliche Laden des Discord-Verlaufs ist standardmäßig aktiviert, und clarify-Abfragen in Telegram und Discord verwenden jetzt native Schaltflächen.
• Die Überprüfung nach Schreibvorgängen wird verbessert. Nach Bearbeitungen kann Hermes für jeden Turn Zusammenfassungen der Dateiänderungen und semantische Diagnosen des Sprachservers anzeigen, bevor der nächste Turn beginnt. Damit nähert sich Hermes einer evidenzbasierten Arbeitsweise für Agenten.
• Desktop- und Medien-Tools werden vielseitiger. computer_use funktioniert über cua-driver auch mit Anbietern außerhalb von Anthropic, video_generate wird hinter austauschbaren Backends vereinheitlicht, und vision_analyze sendet Rohpixel an Modelle, die tatsächlich Bilder verarbeiten können.

Installation

Der Einzeilen-Installer ist der unterstützte Installationsweg. Er kümmert sich um 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 gelten seit v0.19.0 als veraltet. Das mit v0.14.0 eingeführte PyPI-Paket (pip install hermes-agent) und die Homebrew-Formel werden inzwischen als „nicht unterstützte Legacy-Installationen“ gekennzeichnet. Erkennt Hermes eine solche Installation, erscheint an jeder relevanten Stelle eine Warnung, ohne die Ausführung zu blockieren. Die Veröffentlichung über PyPI und Homebrew soll künftig eingestellt werden. Falls Sie Hermes über pip oder brew installiert haben, wechseln Sie zum oben beschriebenen 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 Beta, 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 weisen die Dokumente ausdrücklich hin: Unter macOS wird ausschließlich 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 Beta ü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 stellt Python 3.11 automatisch über uv bereit (ohne sudo), außerdem Node.js 26 (für die Browserautomatisierung und die WhatsApp-Bridge), ripgrep und ffmpeg. Seit v0.20.0 ist Node 26 die verbindliche Mindestversion: 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.⁷ Wenn Sie Hilfe benötigen, können Sie die Ausgabe des Diagnosebefehls hermes dump in ein GitHub-Issue oder einen Discord-Thread einfügen. Sie enthält eine Klartextzusammenfassung Ihrer gesamten Einrichtung, aus der Geheimnisse entfernt wurden.⁸

Manuelle Installation

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

Der Installationsbefehl für Termux unterscheidet sich – 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 die Abhängigkeit faster-whisper einbindet. Diese wiederum benötigt ctranslate2-Wheels, die nicht für Android veröffentlicht werden.⁷

Authentifizierung & Provider

Beim Tag v2026.9.7 enthält hermes_cli/models_catalog_static.py in Zeile 311 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 anhand von plugins/model-providers/ (39 mitgelieferte Verzeichnisse; neun davon – actual, alibaba-coding-plan, commandcode, deepinfra, meta-ai, nebius-token-factory, opencode-free, router, upstage – besitzen keinen statischen Eintrag und werden von der automatischen Erweiterung erfasst, da sie den standardmäßigen Authentifizierungstyp api_key verwenden). Auf der Dokumentationsseite zu Providern werden 45 Cloud- und Abonnementprovider sowie ein Eintrag für benutzerdefinierte Endpunkte tabellarisch aufgeführt; lokale und selbst gehostete Server werden separat erläutert (Ollama, vLLM, SGLang, llama.cpp, LM Studio, LiteLLM, ClawRouter und jeder OpenAI-kompatible Endpunkt).²⁶ Beim Tag v2026.9.24 enthält 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 die kostenlose Stufe von OpenCode inzwischen anonymen Datenverkehr außerhalb des eigenen Clients ablehnt.⁵³ Hinzu kommen benutzerdefinierte Endpunkte und drei unterschiedliche Authentifizierungswege. Nachfolgend finden Sie die gesamte Authentifizierungsoberfläche, nach Wegen geordnet, damit Sie den zu Ihrer Ausgangslage passenden Weg schnell finden.

Die drei Authentifizierungswege

Jeder Provider in Hermes verwendet eines 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 (und MiniMax China), Alibaba Cloud/DashScope, Kilo Code, OpenCode Zen, OpenCode Go, DeepSeek, Hugging Face, Google/Gemini und den meisten Drittanbietern verwendet.² Seit v0.19.0 muss sich der Schlüssel nicht mehr in einer Klartextdatei befinden: Eine erweiterbare SecretSource-Schnittstelle kann Geheimnisse beim Laden aus Bitwarden oder 1Password (op://-Referenzen) abrufen. Dabei können mehrere Vaults gleichzeitig verwendet werden; außerdem stehen eine deterministische Rangfolge, Konfliktwarnungen und Herkunftsangaben für jede Variable zur Verfügung – .env bleibt die Ausweichlösung. (Dies unterscheidet sich vom Bootstrap-Token für Bitwarden Secrets Manager aus v0.15.0, mit dem Providerschlüssel hinter einem einzigen Token gebündelt wurden: SecretSource ersetzt die Klartextdatei selbst, und künftige Vault-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 Anmeldedaten in ~/.hermes/auth.json (bestehende Anmeldedaten 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 in config.yaml gespeichert.²

Die vollständige Providermatrix

Diese Matrix enthält die auf der Dokumentationsseite tabellarisch aufgeführten Provider samt dem jeweils genauen Einrichtungsablauf. Die Auswahl beim Tag umfasst mehr Provider als die Dokumentation (siehe Anzahl oben), und alles OpenAI-Kompatible lässt sich über den Eintrag für benutzerdefinierte Endpunkte anbinden.²²⁶

Anthropic: Drei Authentifizierungsmethoden

Anthropic erhält einen eigenen Abschnitt, weil 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 Anthropic OAuth über hermes model auswählen, bevorzugt Hermes den eigenen Anmeldedatenspeicher von Claude Code, statt das Token in ~/.hermes/.env zu kopieren. Dadurch bleiben aktualisierbare Claude-Anmeldedaten weiterhin aktualisierbar.² Wenn 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: als direkte Copilot-API (empfohlen) und als Copilot ACP, bei dem die lokale Copilot-CLI als Unterprozess gestartet wird.²

# 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

Laut Upstream-Dokumentation wird die Authentifizierung 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-Tokens (gho_*), fein abgestufte PATs (github_pat_* mit der Berechtigung Copilot Requests) und GitHub-App-Tokens (ghu_*). Wenn gh auth token ein ghp_*-Token zurückgibt, authentifizieren Sie sich stattdessen über hermes model per OAuth.²

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

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

Z.AI erkennt den Endpunkt automatisch. Bei Verwendung des Providers z.ai/GLM testet Hermes mehrere Endpunkte (global, China 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 das Prompt-Caching automatisch. Wenn die Basis-URL x.ai enthält, sendet Hermes bei jeder Anfrage den Header x-grok-conv-id, damit Anfragen innerhalb einer Konversationssitzung an denselben Server weitergeleitet und zwischengespeicherte System-Prompts sowie der 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 Anmeldedaten-Pools können Sie mehrere API-Schlüssel oder OAuth-Tokens für denselben Provider rotieren. Das ist praktisch, um Ratenlimits auf mehrere Schlüssel zu verteilen, ohne den Code zu ändern.⁶ Die veralteten Befehle hermes login und 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 speichern die Konfiguration dauerhaft in config.yaml, der zentralen Quelle 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 (allein, ohne Modellnamen) fragt /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 nur ein Modell läuft.²

Lokale LLM-Server (Einrichtungsvorlagen)

Die Upstream-Dokumentation enthält vollständige Einrichtungsanleitungen für Ollama, vLLM, SGLang, llama.cpp und LM Studio. Hier 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 — das OpenAI-kompatible API akzeptiert die Kontextlänge nicht vom Client, sodass Hermes sie nicht für Sie festlegen kann.² Für die Agentennutzung sollten Sie mindestens 16k–32k einstellen.

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

Tool-Aufrufe erfordern --enable-auto-tool-choice und --tool-call-parser <name>. Unterstützte Parser: hermes (Qwen 2.5, Hermes 2/3), llama3_json, mistral, deepseek_v3, deepseek_v31, xlam, pythonic. Ohne diese Flags werden Tool-Aufrufe als Klartext zurückgegeben.²

SGLang — 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 hermes model anschließend auf http://localhost:1234/v1.

Kritischer Stolperstein bei LM Studio: LM Studio liest die Kontextlänge aus den Modellmetadaten, doch viele GGUF-Modelle melden Standardwerte von 2048 oder 4096. Legen Sie die Kontextlänge in den LM Studio-Modelleinstellungen immer ausdrücklich fest — klicken Sie neben der Modellauswahl auf das Zahnradsymbol, stellen 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

Benannte benutzerdefinierte Provider lassen sich außerdem im interaktiven 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/, über das sich Inferenz-Provider von Drittanbietern ohne Änderungen am Kern integrieren lassen.¹⁸ Wenn ein Provider einen OpenAI-, Anthropic- oder Codex-kompatiblen API-Modus unterstützt, können Sie eine Unterklasse von ProviderProfile implementieren, die den Authentifizierungspfad, die Basis-URL, den Modellkatalog und die Caching-Header deklariert; Hermes löst sie über denselben runtime_provider.py-Pfad auf, den auch die integrierten Provider verwenden. Diese Architekturänderung bildet die Grundlage für die 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, der den OAuth-Provider verwendet, bei dem Hermes bereits angemeldet ist — Claude Pro, ChatGPT Pro, SuperGrok oder einen anderen kompatiblen konfigurierten Provider.¹⁹ Dadurch können Tools, die ein OpenAI-artiges API erwarten, darunter Codex CLI, Aider, Cline, Continue oder benutzerdefinierte Skripte, Ihre abonnementbasierte Hermes-Authentifizierung ohne separaten API-Schlüssel verwenden. Behandeln Sie den Proxy als lokale Entwicklungsinfrastruktur: Binden Sie ihn gezielt ein, machen Sie ihn nicht allgemein zugänglich und beachten Sie die providerspezifischen Bedingungen.

Erkennung der Kontextlänge

Laut Upstream-Dokumentation werden zwei Einstellungen häufig verwechselt:²

• context_length — das gesamte Kontextfenster (kombiniertes Token-Budget für Eingabe und Ausgabe, z. B. 1.000.000 für Claude Opus 4.7 oder 200.000 für Sonnet 4.6). Hermes entscheidet anhand dieses Werts, wann der Verlauf komprimiert werden muss.
• model.max_tokens — die Ausgabeobergrenze (maximale Anzahl an Token, die das Modell in einer einzelnen Antwort generieren darf). Sie ist unabhängig von der Verlaufslänge.

Legen Sie context_length fest, wenn die automatische Erkennung die Größe des Kontextfensters falsch bestimmt:

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

Hermes ermittelt Kontextfenster über 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 Register für mehr als 3800 Modelle) → Standardausweichwerte (128K).² Das System berücksichtigt den jeweiligen Provider, sodass dasselbe Modell je nach bereitstellendem Anbieter unterschiedliche Kontextgrenzen haben kann (z. B. verfügt claude-opus-4.6 direkt über Anthropic über 1M, bei GitHub Copilot jedoch über 128K).²

Intelligentes Modellrouting: Provider-Rotation und Fallback

Hermes bindet Sie nicht an ein Modell bei einem einzigen Provider. Intelligentes Modellrouting umfasst alle Mechanismen, die entscheiden, welcher Provider und welches Modell eine bestimmte Anfrage tatsächlich verarbeitet: Credential- Pools verteilen die Last auf mehrere Schlüssel, ein konfigurierter Fallback übernimmt bei einem Ausfall des primären Modells und die nachfolgenden zusätzlichen Slots leiten Nebenaufgaben unabhängig von Ihrem Hauptmodell an günstigere Modelle weiter.²⁶ Konfigurieren Sie diese drei Komponenten gemeinsam – sie entscheiden darüber, ob ein Agent bei einer Ratenbegrenzung zum Stillstand kommt oder weiterarbeitet.

Credential-Pools. 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 einen Ersatz im Format provider:model, 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.² Für den Fallback unterstützte Provider: openrouter, nous, openai-codex, copilot, copilot-acp, anthropic, huggingface, zai, kimi-coding, minimax, minimax-cn, deepseek, ai-gateway, opencode-zen, opencode-go, kilocode, alibaba, custom.²

Zusätzliche Modelle

Hermes verwendet „zusätzliche“ Modelle für Nebenaufgaben: Bildanalyse (Vision), Klassifizierung zur Genehmigung gefährlicher Befehle, Kontextkomprimierung, Generierung von Sitzungstiteln, Einfügung von TTS-Audio-Tags, skill-Abgleich, MCP-Tool-Dispatch sowie die Kanban-Familie für Spezifikation und Zerlegung.⁴³⁴ Standardmäßig (auxiliary.*.provider: "auto") wird jede zusätzliche Aufgabe von Ihrem Haupt-Chatmodell ausgeführt – also demselben Provider 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 Provider ersetzt: „Frühere Builds wiesen Benutzern von Aggregatoren (OpenRouter, Nous Portal) automatisch ein günstiges Provider-Standardmodell zu. Das war unerwartet … auto verwendet nun für alle das Hauptmodell, während aufgabenspezifische Überschreibungen in config.yaml weiterhin Vorrang haben.“³⁴ Für den Einstieg ist keine Konfiguration erforderlich; der Nachteil sind die Kosten – bei teuren Reasoning-Modellen können zusätzliche Aufgaben spürbare Ausgaben verursachen. Weisen Sie einzelne Aufgaben daher bei Bedarf günstigen, schnellen Modellen zu. Zwei frühere Hilfsaufgaben verwenden überhaupt kein LLM mehr: Webextraktion („web_extract und Browser-Snapshots kürzen lange Inhalte deterministisch und speichern den vollständigen Text zum seitenweisen Abruf mit read_file – ohne Beteiligung von LLM“) und Sitzungssuche (das Tool mit einheitlicher Rückgabeform liefert 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 vorhandenen config.yaml sind „harmlose Überbleibsel und werden ignoriert“ – und auch der Slot flush_memories fehlt in den Standardeinstellungen dieses Tags.³⁴

Sie können konfigurieren, welches Modell und welcher Anbieter für die jeweilige Hilfsaufgabe verwendet wird. Jeder Hilfsslot verwendet dieselben Optionen: provider, model, base_url (sowie api_key, timeout, extra_body und ein aufgabenspezifisches 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 ist), curator (der Fork zur Überprüfung der skill-Nutzung), background_review (der Fork zur Selbstverbesserung nach einem Durchlauf), 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 überhaupt nicht manuell bearbeiten: Führen Sie hermes model aus und wählen Sie „Configure auxiliary models“, um für jede Aufgabe eine interaktive Auswahl zu treffen.³⁴

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

Warum das wichtig ist: Da auto bereits Ihr Hauptmodell verwendet, gibt es den früheren Fallstrick „OpenRouter konfigurieren, sonst verschlechtert sich die Leistung der Hilfsaufgaben unbemerkt“ nicht mehr – nun müssen Sie stattdessen die Kosten abwägen. Wenn Ihr Hauptmodell ein teures Reasoning-Modell ist, leiten Sie die kommunikationsintensiven Nebenaufgaben an ein günstiges und 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 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

Auf Geheimnisse kann in config.yaml mittels Shell-artiger Interpolation verwiesen werden:⁴

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

Konfiguration verwalten

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

Beispiele:⁴

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

hermes config check und hermes config migrate sollten Sie nach jedem hermes update ausführen. 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, hat die Quelle mit der höheren Priorität Vorrang:⁴

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 angewendet, wenn der Wert aus keiner anderen Quelle stammt

CLI-Flags haben für den jeweiligen Aufruf immer Vorrang. config.yaml ist langfristig die maßgebliche Quelle.

Lokalisierung (v0.13.0+)

Mit v0.13.0 wurden 7 Gebietsschemata für CLI- und gateway-Nachrichten eingeführt: Chinesisch (vereinfacht), Japanisch, Deutsch, Spanisch, Französisch, Ukrainisch und Türkisch.¹⁸ v0.14.0 lokalisiert sämtliche gateway-Befehle und das Web-Dashboard, ergänzt 8 weitere Gebietsschemata 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 in 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 alle Zeichenfolgen, die von einer Übersetzung noch nicht abgedeckt werden.

Profiles – mehrere isolierte Hermes-Instanzen

Profiles ermöglichen mehrere isolierte Hermes-Instanzen, die jeweils über eine eigene Konfiguration, eigene Sitzungen, skills, einen eigenen Speicher und eine eigene gateway-PID verfügen. So können Sie „Hermes für die Arbeit“ und „Hermes für den privaten Gebrauch“ parallel ausführen, ohne dass eine Instanz 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 den gateway gleichzeitig ausführen können, ohne sich gegenseitig zu beeinträchtigen.⁶³

Seit v0.21.2 wird diese Isolationsgrenze strenger durchgesetzt: Eine Reihe von Korrekturen schloss tatsächliche profile-übergreifende Lecks in Setups mit gebündelten gateways. Dabei konnten sekundäre profiles die Zulassungslisten des Standard-profiles übernehmen, Anmeldedaten an dessen Host senden, Geheimnisse aus dessen Vault an stdio-MCP-Server weitergeben oder .env/auth.json/state.db eines anderen profiles 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 Praxisreferenz für CLI-Befehle der obersten Ebene. Die maßgebliche, aus dem Code abgeleitete Referenz finden Sie in der upstream verfügbaren 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 Variante 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 wechselt direkt zu einem bestimmten 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 bietet mehr Möglichkeiten als tail -f für die Protokolldateien, da gleichzeitig nach Protokollstufe, 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 unter ~/.hermes/logs/:⁶ - agent.log — sämtliche Agentenaktivitäten (API-Aufrufe, Tool-Weiterleitung, Sitzungslebenszyklus, INFO+) - errors.log — ausschließlich Warnungen und Fehler (eine gefilterte Teilmenge von agent.log) - gateway.log — Aktivitäten des Messaging-gateway (Plattformverbindungen, Weiterleitung, webhooks)

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

hermes doctor — Diagnose

hermes doctor [--fix] ist der erste Befehl, den Sie bei einem Problem ausführen sollten. Er prüft die Gültigkeit der Konfiguration, das Vorhandensein von Abhängigkeiten, die Verfügbarkeit von API-Schlüsseln sowie den Dienststatus und kann mit --fix versuchen, Probleme automatisch zu beheben.⁶

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

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 Providern 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 Turn, die nach der Antwort automatisch zum vorherigen Modell zurückkehrt.⁵⁶ Seit dem v0.20.5-Zeitfenster unterstützt die /model-Auswahl außerdem Fuzzy-Suche: Die Ergebnisse werden während Ihrer Eingabe gefiltert.²³³⁵

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 Slash-skill-Aufrufe stapeln: /skill-a /skill-b do XYZ lädt beide skills in der angegebenen Reihenfolge innerhalb eines einzigen Turns, 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 /review, /deploy oder /morning in CLI ein.

Präfixabgleich

Befehle unterstützen Präfixabgleich: Die Eingabe /h wird zu /help, /mod zu /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 den Grund Ihrer Ablehnung, damit er seinen Kurs korrigiert, statt denselben Versuch blind zu wiederholen⁵⁶
• /update — Hermes Agent auf die neueste Version aktualisieren
• /commands [page] — alle Befehle und skills seitenweise durchsuchen

Einige andere funktionieren ausschließlich in CLI: /skin, /tools, /toolsets, /browser, /config, /cron, /skills, /platforms, /paste, /statusbar, /plugins.⁹

Tools und Toolsets

Hermes umfasst eine umfangreiche integrierte Tool-Registry für Websuche, Browserautomatisierung, Terminalausführung, Dateibearbeitung, Speicher, Delegation, RL-Training, Nachrichtenzustellung, Home-Assistant-Integration und mehr.¹⁰ Tools sind in logischen toolsets organisiert, die für jede Plattform aktiviert oder deaktiviert werden können.

Übergeordnete Kategorien

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

Tools verwalten

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

Tools lassen sich außerdem während einer Sitzung über /tools disable <name> und /tools enable <name> umschalten. 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 ebenso wie die Anbieterauswahl durch Plugins erweitern (siehe unten):¹⁰²⁴

Wechseln Sie das Backend 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 Kern-Repository aufgenommen werden: Ein Plugin registriert beim Laden über PluginContext.register_terminal_environment_provider einen TerminalEnvironmentProvider, woraufhin der registrierte Name genau wie bei einem integrierten Backend über terminal.backend ausgewählt werden kann. Die Namen integrierter Backends sind reserviert – die Registry lehnt Anbieter ab, deren Name mit einem Backend im Repository 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, Behandlung von Containerpfaden und Arbeitsverzeichnissen sowie Entfernung von Geheimnissen), da der Kern an jeder Klassifizierungsstelle die Registry abfragt, statt eine fest codierte Namensliste zu verwenden.³²

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

terminal:
  backend: ssh

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

Docker-Backend:

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

Containerressourcen (gilt für docker, singularity, modal 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 Sicherheitsvorkehrungen ausgeführt: schreibgeschütztes Root-Dateisystem (Docker), Entfernung aller Linux-Capabilities außer DAC_OVERRIDE, CHOWN und FOWNER, keine Rechteausweitung, PID-Begrenzung (256 Prozesse), vollständige Namespace-Isolierung und dauerhafter 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

Benötigt ein Befehl sudo, fordert Hermes Sie zur Eingabe Ihres Passworts auf, das für die Sitzung zwischengespeichert wird. Alternativ können Sie SUDO_PASSWORD in ~/.hermes/.env festlegen.¹⁰

Multi-Agent-Kanban (ab v0.13.0)

Mit v0.13.0 wird die Zusammenarbeit mehrerer Agenten zu einem grundlegenden Bestandteil: einem dauerhaften Kanban-Board, das Aufgaben, Status und Mitarbeiteridentitäten agenten- und neustartübergreifend erfasst.¹⁸ Das Board sorgt dafür, dass ein Schwarm von Hermes-Mitarbeitern seine Arbeit tatsächlich abschließt, statt wegen ins Leere laufender Übergaben zum Stillstand zu kommen.

Das Kanban-Board lässt sich auf der Zielseite gut mit /goal (Ralph-Schleife mit festgeschriebenem Ziel) und für die Erzeugungssemantik mit dem vorhandenen Tool delegate_task kombinieren. So entsteht ein Schwarmmuster, bei dem alle Agenten eine gemeinsame verlässliche Quelle dafür nutzen, 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. Es handelt sich nicht um ein separates Subsystem, das Sie aktivieren müssen – vielmehr wird ein Schwarm durch das Board ermöglicht. Das Board liefert das eine Element, das parallele Agenten nicht selbst bereitstellen können: eine einzige maßgebliche Antwort auf die Frage: Welche Aufgabe sollte ich als Nächstes übernehmen, und arbeitet bereits jemand daran?

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

In der Praxis geben Sie dem Schwarm ein Ziel, lassen es durch die automatische Zerlegung in Board-Aufgaben aufteilen und überlassen den Mitarbeitern das Beanspruchen, Ausführen und Zurückgeben der Ergebnisse. Das Wiederholungsbudget gilt pro Aufgabe (max_retries), sodass eine einzige 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 Status fort.

Ein Schwarm ist nur so gut wie seine Zerlegung. Das Board koordiniert Mitarbeiter, kann jedoch ein schlecht aufgeteiltes Ziel nicht in ein gutes verwandeln. Aufgaben mit verborgenem gemeinsamem Status geraten weiterhin aneinander – mit oder ohne Worktrees.

Skills-System

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

Alle Skills befinden sich in ~/.hermes/skills/ — dem primären Verzeichnis und der maßgeblichen Quelle. Bei einer Neuinstallation werden 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 Skill 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 eignet sich besonders für Fallback-Skills — kostenlose oder lokale Alternativen, die nur angezeigt werden sollen, wenn ein Premium-Tool nicht verfügbar ist:¹¹

Beispiel: Der integrierte Skill duckduckgo-search verwendet fallback_for_toolsets: [web]. Wenn 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 auftraten und er den funktionierenden Lösungsweg 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 hat sie in der Quellenliste ersetzt.¹¹⁵⁵

Sicherheitsprüfung

Alle über den Hub installierten Skills durchlaufen eine Sicherheitsprüfung auf Datenexfiltration, Prompt-Injection, destruktive Befehle, Hinweise auf Angriffe über die Lieferkette und weitere Bedrohungen.¹¹

Vertrauensstufen:¹¹

--force kann nicht gefährliche Richtlinienblockierungen für Community-Skills übergehen. Eine Einstufung der Sicherheitsprüfung als dangerous wird dadurch nicht außer Kraft gesetzt.¹¹

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

Die Pfade unterstützen die Erweiterung von ~ sowie 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 unter demselben Namen an beiden Orten, hat die lokale Version Vorrang.¹¹

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

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

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

Die Liste wird einmal aufgelöst, wenn der Prompt des Agenten erstmals erstellt wird. Bei einem fehlenden oder deaktivierten Namen wird eine Warnung ausgegeben und der Eintrag übersprungen, anstatt die Sitzung abzubrechen. HERMES_IGNORE_RULES (der Mechanismus hinter --ignore-rules) unterdrückt die Liste wie den übrigen automatisch eingefügten Kontext. Dies ist die Entsprechung für dauerhaft geltende Anweisungen zu -s/--skills, womit Skills nur für eine einzelne Sitzung vorab geladen werden.⁵¹

Persistenter Speicher

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

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 aus Leistungsgründen 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

Folgendes speichern (der Agent erledigt dies proaktiv):¹² - Benutzerpräferenzen: „Ich bevorzuge TypeScript gegenüber JavaScript“ → user - Fakten 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 15. Januar 2026 von MySQL zu PostgreSQL migriert“ → memory

Folgendes überspringen:¹² - Triviale oder offensichtliche Informationen - Leicht erneut zu ermittelnde Fakten - Rohdaten-Dumps (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 seine früheren Unterhaltungen durchsuchen. Alle CLI- und Messaging-Sitzungen werden mit FTS5-Volltextsuche in SQLite (~/.hermes/state.db) gespeichert. Seit der Überarbeitung in v0.15.0 ist überhaupt kein LLM mehr am Tool beteiligt — es gibt die gespeicherten Gesprächsinhalte direkt zurück (in den Worten 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 beim 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), jeweils als ISO-Datum/-Uhrzeit — ein reiner Datumswert steht für Mitternacht UTC an diesem Tag — oder als relative Dauer (7d, 24h, 2w). Diese Angaben 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 Recall-Wiederholungsversuch bei null Ergebnissen: Da FTS5 zwischen Begriffen implizit AND verwendet, kann eine umformulierte Abfrage mit mehreren Wörtern einen gespeicherten Satz übersehen, sobald auch nur eines dieser Wörter darin fehlt. Bleiben daher sowohl die exakte Abfrage als auch sämtliche Substring-Fallbacks ohne Ergebnis, wird der Index erneut nach Übereinstimmungen mit BELIEBIGEN Begriffen durchsucht, wobei Zeilen mit mehr abgedeckten Begriffen in der Rangfolge weiter oben stehen. Treffer behalten die Semantik exakter Übereinstimmungen (der Wiederholungsversuch erfolgt nur, wenn keine Ergebnisse gefunden wurden); Abfragen mit explizitem OR/NOT, Einzelbegriff-Abfragen und über CJK geleitete Abfragen bleiben unverändert.⁵¹

Externe Speicheranbieter

Für einen umfangreicheren persistenten Speicher über MEMORY.md und USER.md hinaus enthält Hermes sieben Plugins für externe Speicheranbieter: Honcho, OpenViking, Mem0, Holographic, RetainDB, ByteRover und Supermemory. Weitere, etwa Hindsight, lassen sich aus dem Plugin-Katalog installieren.¹²

Hindsight war bis einschließlich v0.21.4 im Kernverzeichnis enthalten und wurde in v0.21.5 in den von Vectorize gepflegten Katalog verschoben. Bestehende Installationen werden automatisch migriert: Ist memory.provider: hindsight festgelegt, installiert hermes update das Katalog-Plugin in jedem Profilverzeichnis, in dem es angegeben ist; fehlt es weiterhin, 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 hindsight aus. Das Plugin wird unter ~/.hermes/plugins/hindsight/ abgelegt und zu plugins.enabled hinzugefügt; memory.provider, memory.hindsight.*, HINDSIGHT_API_KEY und Ihre Speicherdaten bleiben unverändert. Prüfen Sie den Status mit hermes memory status und hermes plugins list. Das pip-Extra hermes-agent[hindsight] ist entfallen.⁵³

Externe Anbieter werden parallel zum integrierten Speicher ausgeführt (sie ersetzen ihn niemals) und ergänzen Funktionen wie Wissensgraphen, semantische Suche, automatische Faktenextraktion und sitzungsübergreifende Benutzermodellierung:⁶¹²

hermes memory setup         # Pick a provider and configure it
hermes memory status        # Check what's active
hermes memory off           # Disable external provider (built-in only)

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

Automatische Sitzungsfortsetzung (v0.13.0+)

Mit v0.13.0 können Unterbrechungen während der Agentenausführung überstanden werden. Das gateway setzt unterbrochene Sitzungen nach einem Neustart automatisch fort; Neustarts durch /update bewahren den Sitzungsstatus während des Upgrades; beim erneuten Laden von Quelldateien während der Entwicklung bleibt die aktive Sitzung bestehen, statt eine neue zu erzwingen.¹⁸ In der Praxis bedeutet das: Länger laufende gateway-Aufgaben und cron-gesteuerte Jobs setzen ihr Kontextfenster bei einem Prozessneustart nicht mehr zurück.

Checkpoints v2 (v0.13.0+)

Die Statuspersistenz wurde in v0.13.0 als Single-Store-Design mit echter Bereinigung, Schutzmechanismen für den Datenträger und ohne verwaiste Schatten-Repositories neu implementiert.¹⁸ Das vorherige checkpoint-System sammelte bei lang laufenden profiles fortlaufend Statusdaten auf dem Datenträger an. Der v2-Speicher setzt dem lokalen checkpoint-Speicher eine feste Obergrenze und entfernt die doppelte Buchführung, die dieses Wachstum verursachte. Eine Änderung der benutzerseitigen Konfiguration ist nicht erforderlich; beim nächsten Schreiben eines checkpoints wird der v2-Pfad verwendet.

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 (beziehungsweise unter $HERMES_HOME/SOUL.md für benutzerdefinierte profiles). Vorhandene Benutzerdateien werden niemals überschrieben. Hermes lädt SOUL.md ausschließlich aus HERMES_HOME — im aktuellen Arbeitsverzeichnis wird nicht danach gesucht. 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:¹³ - Ton - Kommunikationsstil - Grad der Direktheit - Standardinteraktionsstil - stilistisch zu vermeidende Elemente - Umgang von Hermes mit Unsicherheit, Meinungsverschiedenheiten und Mehrdeutigkeit

Weniger geeignet ist sie 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 die wichtigste Unterscheidung bei der Identitätsverwaltung von Hermes:¹³

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

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

Eine hilfreiche Faustregel: 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 sitzungsbezogene Ergänzung.¹³ Behalten Sie eine pragmatische standardmäßige SOUL.md bei und verwenden Sie dann /personality teacher für ein Lerngespräch oder /personality creative für Brainstorming.

Nous Tool Gateway (v0.10.0+)

Seit Hermes Agent v0.10.0 (2026-04-16) erhalten zahlende Nous Portal-Abonnenten über ihre vorhandenen Portal-Anmeldedaten verwalteten Zugriff auf eine kuratierte Auswahl von Tools — ohne zusätzliche API-Schlüssel verwalten zu müssen.⁶¹ Hermes CLI selbst bleibt MIT-lizenziert und vollständig quelloffen. Neu ist, dass Ihre Portal-Authentifizierung nun mehr als nur die Modellinferenz freischaltet.

Der schnellste Einstieg ist hermes setup --portal, das im README als „Ein Befehl nach einer Neuinstallation“ vorgestellt wird: Sie werden über OAuth angemeldet, Nous wird als Ihr Anbieter festgelegt und der Tool Gateway aktiviert. Anschließend verwalten Sie die Verbindung mit hermes portal. hermes portal login (die Standardeinstellung, 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 davon über Nous geleitet werden. hermes portal status bleibt als verborgener Alias für die Abwärtskompatibilität mit info erhalten, und in der CLI-Referenz der Dokumentation zu diesem Tag wird der Unterbefehl weiterhin als status bezeichnet, sodass beide Varianten funktionieren.²⁸

Inhalt des gateway

Funktionsweise

Der gateway wird über das neue Konfigurationsfeld use_gateway für jedes Tool einzeln aktiviert. Wenn Sie Portal-Anmeldedaten in hermes auth hinterlegt und den gateway für ein Tool aktiviert haben, werden die Aufrufe dieses Tools über das Portal geleitet. Andernfalls wird Ihr direkter API-Schlüssel verwendet, sofern einer vorhanden ist.

# 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

Priorität zur Laufzeit: Wenn der gateway verfügbar ist und für ein Tool use_gateway: true festgelegt wurde, bevorzugt Hermes den gateway, selbst wenn Sie zusätzlich einen direkten API-Schlüssel konfiguriert haben. Das ist für die Abrechnung relevant — gateway-Aufrufe werden über Ihr Portal-Abonnement abgerechnet und nicht vom Guthaben Ihres direkten API-Schlüssels abgezogen.

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-Anmeldedaten erkannt, die Sie bereits in hermes auth hinterlegt haben — eine separate Anmeldung ist nicht erforderlich. Seit v0.19.0 können Sie das Abonnement außerdem direkt innerhalb einer Sitzung verwalten: /subscription zeigt Ihren Tarif und Ihr verbleibendes Kontingent an, gibt eine genaue Vorschau auf die Kosten eines Upgrades oder den Zeitpunkt, zu dem ein Downgrade wirksam wird, und übernimmt die Änderung mit Hinweisen zu geplanten Änderungen sowie einer Option zum Rückgängigmachen; mit /topup können Sie Guthaben aufladen. Die Desktop-App bietet eine entsprechende Registerkarte für Abrechnungseinstellungen.⁵⁶

Preise und Zugang

Preise und Tarifbezeichnungen werden auf der Preisseite des Nous Portal veröffentlicht (https://portal.nousresearch.com/pricing). Dieser Leitfaden führt die Tarife nicht einzeln auf, da sie zum Portal-Produkt und nicht zu 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 agent zu erhalten: Kostenlose Inferenz und connectors sind sofort verfügbar, die Anmeldung erfolgt mit einem einzigen Befehl und /login startet den Anmeldevorgang direkt aus einem Chat heraus. 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; ausschließlich der Literalwert 1 aktiviert ihn – ein eigener Test der Desktop-App bestätigt, dass 'true', '0' und ein leerer Wert ihn jeweils deaktiviert lassen, und die Startentscheidung wird in die Umgebung des gestarteten Backends geschrieben, sodass ein geerbter Wert niemals durchsickert.⁴⁸

Seit dem Veröffentlichungszeitraum von v0.21.4 erfolgt die Verbindung dieser connectors als ein einziger, vom Backend gesteuerter Vorgang und nicht mehr über verteilte Logik in den einzelnen Frontends: Ein Aufruf des Tools manage_connections steuert im Backend eine rein datenbasierte Zustandsmaschine für Verbindungen (mit einer festen Vorgangsfrist von 300 Sekunden – bewusst nicht als Konfigurationsschlüssel umgesetzt), die Desktop, TUI und CLI jeweils als dieselbe Einrichtungskarte darstellen. Die Karte zeigt für jede fehlende Anmeldeinformation ein Feld an (Name, Eingabeaufforderung, Pflichtstatus) und deaktiviert ihre Aktionsschaltfläche, bis alle Pflichtfelder Text enthalten; das Backend erzwingt für jedes 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 nun über das Konfigurationsfeld use_gateway für jedes Tool einzeln aktiviert und anhand des Status Ihres Portal-Abonnements freigegeben.⁶¹

Einordnung: Was diese Version nicht ist

Hermes Agent CLI ist nicht an ein Abonnement gebunden. Das Projekt bleibt MIT-lizenziert; sämtliche Kernfunktionen (CLI, skills, Speicher, Messaging-gateway, cron, MCP, lokales dashboard, BYOK für jeden Anbieter) funktionieren vollständig, ohne dass Sie dafür jemanden bezahlen müssen. v0.10.0 bietet Benutzern, die bereits für Nous Portal bezahlen, einen komfortableren Weg — der kostenlose Weg bleibt vollständig erhalten.

Messaging Gateway

Hermes kann als dauerhaft laufender gateway-Prozess betrieben werden, der über einen einzigen gateway-Prozess eine Verbindung 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 ein generischer Webhook-Adapter.^360171819 Die Zahl 28 stammt aus der Tabelle zum Plattformvergleich in der Dokumentation beim Tag v2026.8.31. Darunter definiert gateway/config.py 24 integrierte Mitglieder des Platform-Enums (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 mitgelieferten Adapterverzeichnisse unter plugins/platforms/ zu. Daher stimmt eine reine 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 WeCom Callback-Modus für Unternehmens-Apps.¹⁶ v0.11.0 ergänzte QQBot.⁶⁰ v0.12.0 ergänzte Microsoft Teams und Tencent Yuanbao.¹⁷ Mit v0.13.0 kam Google Chat als 20. Plattform hinzu, basierend auf derselben modularen Adapterarchitektur. IRC und Microsoft Teams wurden ebenfalls auf das neue Adaptermuster mit generischen Plugin-Hooks für env_enablement_fn / cron_deliver_env_var umgestellt.¹⁸ v0.14.0 ergänzt LINE und SimpleX Chat und vervollständigt zugleich den Microsoft-Teams-Stack durchgängig mit Graph-Authentifizierung, Webhook-Listener, Pipeline-Laufzeit und ausgehender Zustellung.¹⁹ v0.17.0 (19. Juni 2026) ergänzt iMessage ohne Relay über Photon Spectrum (Gerätecode-OAuth mit hermes photon login — kein Mac-/BlueBubbles-Relay erforderlich), den offiziellen WhatsApp Business Cloud API-Adapter (wodurch kein Bridge-Prozess mehr erforderlich ist), SimpleX-Gruppen und native Anhänge sowie Raft als mitgeliefertes Plattform-Plugin.²¹ Zwei weitere Plattformen erscheinen ohne besondere Erwähnung in den Versionshinweisen in der Dokumentationstabelle: ntfy ist ein schlanker HTTP-Pub/Sub-Push-Kanal (Sie abonnieren ein Thema über die mobile ntfy-App, senden eine Nachricht an das Thema, um mit dem Agenten zu sprechen, und erhalten die Antwort auf Ihrem Smartphone; dies funktioniert mit dem öffentlichen Server ntfy.sh oder einer selbst gehosteten Instanz und erfordert weder SDK noch einen Daemon), während Buzz Hermes mit einer Buzz-Community verbindet, 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 CLI buzz auf, für eingehende Nachrichten nutzt er ein natives Nostr-WebSocket-Abonnement. 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 Anbindung jeder Plattform: API-Token, Bot-IDs, Kanalzuordnungen und Zulassungslisten.⁶

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 ein in Telegram geplanter cron-Job kann seine Ausgabe an Discord übermitteln — die Unterschiede zwischen den Plattformen bestehen lediglich an den Schnittstellen.³

v0.19.0 ergänzt profilbasiertes Nachrichten-Routing und dauerhafte Zustellung. Ein einzelner multiplexender gateway, der ein Bot-Token gemeinsam nutzt, kann bestimmte Server, Kanäle oder Threads unterschiedlichen profiles zuordnen — jeweils mit vollständig isolierter Konfiguration, eigenen skills, eigenem Speicher und eigenen Geheimnissen. Dafür steht auch die Überschreibung GATEWAY_MULTIPLEX_PROFILES zur Verfügung. Dank umfassender Härtungsmaßnahmen kann ein einziges falsch konfiguriertes profile nicht mehr den gesamten gateway zum Absturz bringen. Intern wurde der Routing-Index nach state.db verschoben (sessions.json ist jetzt nur noch ein optionaler Legacy-Spiegel), und endgültige Antworten werden rund um den Plattformversand in einem dauerhaften Register offener Zustellungsverpflichtungen erfasst. Führt ein gateway-Absturz dazu, dass eine fertige Antwort nicht zugestellt wird, erfolgt die Zustellung beim nächsten Start erneut, statt die Antwort unbemerkt zu verlieren.⁵⁶ Mit v0.21.2 wurde die Isolation zwischen gerouteten profiles weiter gehärtet. Dabei wurde eine Reihe profilübergreifender Datenlecks genau in dieser Multiplex-Konfiguration geschlossen: übernommene Zulassungslisten, an den Host des Standard-profiles gesendete Anmeldedaten, Geheimnisse aus dem Vault des Standard-profiles, die stdio-MCP-Server erreichten, profilübergreifende MEDIA:-Anhänge sowie das Nous-Bearer-Token eines anderen profiles, 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 beschreibt den Vertrag in vier Sätzen: „Weder Inaktivität noch die verstrichene Zeit führen jemals zu einer neuen Konversation. /new und /reset setzen eine explizite Grenze; die Kontextkomprimierung verwaltet weiterhin lange Verläufe. Veraltete Timer-Konfigurationen werden ignoriert. Der vorhandene Datentyp SessionResetPolicy dient nur als inaktive Kompatibilitätsstruktur und nicht als Laufzeitrichtlinie.“ Eine explizite Unterbrechung setzt beim nächsten eingehenden Beitrag weiterhin 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“, entspricht das inzwischen dem vorgesehenen Verhalten; beginnen Sie mit /new selbst eine neue Konversation.⁴³

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 bereits vom laufenden Multiplexer bedient wird, stellt der Befehl lediglich eine Verbindung her und wird mit Status 0 beendet. Wird das profile noch nicht bedient, fordert Hermes den Multiplexer auf, profiles/ erneut einzulesen, und stellt die Verbindung her, sobald das profile verfügbar ist. Kann der Multiplexer das profile nicht bedienen, verweigert der Befehl den Start, anstatt unbemerkt einen zweiten gateway auszuführen. --replace zielt nun auf diesen Hostprozess, unabhängig davon, von welchem profile er gestartet wurde, und --force überspringt die Rückfrage vollständig, wenn der zuständige Prozess 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 profiles, startet Ihr profile wie bisher einen eigenen daneben, bis diese Migration erzwungen wird (#109417). Werden zwei gateways gleichzeitig gestartet, wird der Prozess, der die Host-Sperre nicht erhält, mit Status 75 beendet; jeder von Hermes erzeugte Supervisor versucht den Start daraufhin erneut. Zu diesem Zeitpunkt ist der Datensatz des erfolgreichen Prozesses vorhanden, sodass der Wiederholungsversuch 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 sind auf den Betriebssystembenutzer beschränkt. Ein Datensatz, dessen PID nicht mehr aktiv ist oder inzwischen von einem anderen Prozess verwendet wird, gilt als veraltet und wird ignoriert. Ein abgestürzter gateway blockiert daher nicht den nächsten Start. Die Desktop-App folgt derselben Regel und stellt eine Verbindung zum laufenden Host-Backend her, statt ein zweites zu starten.⁵¹

Seit v0.21.5 ist Multiplexing nicht mehr optional. gateway.multiplex_profiles hat genau einen gültigen Wert: true. Fehlt der Schlüssel, wird er als aktiviert interpretiert und in die config.yaml des Standard-profiles geschrieben. Ein ausdrücklich gesetztes false wird direkt durch true ersetzt, wobei beim betreffenden gateway-Start einmalig ein eingerahmter Hinweis erscheint und im nächsten Bericht von hermes update erneut darauf hingewiesen wird. Zwei Steuerelemente ersetzen die frühere Möglichkeit zur Deaktivierung. 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 mithilfe einer Markierungsdatei unter profiles/<name>/gateway.parked. Mit hermes -p <name> gateway start heben Sie diesen Zustand wieder auf; die Schaltflächen „Stop“ und „Start“ im Dashboard und in der Desktop-App bewirken dasselbe. Benötigt ein benanntes profile weiterhin einen eigenen gateway, setzt es in seiner eigenen config.yaml den Wert gateway.standalone: true. Der Host bedient dieses profile dann nie, und dessen Befehle stop/start wirken auf den 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 mehrere Betriebssystembenutzer oder ein HERMES_HOME außerhalb des Verzeichnisses profiles/ des Standard-Benutzerverzeichnisses 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. Von diesem Zeitpunkt an ist der Benutzer autorisiert.⁶

unauthorized_dm_behavior legt fest, welche Antwort die Direktnachricht eines Fremden vor dem Pairing 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 einmalig eine höfliche Absage und reagiert anschließend 24 Stunden lang nicht mehr auf diesen Absender (#88028). Die Absage wird plattform- und absenderbezogen sowie aliasübergreifend dedupliziert. 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. Entschuldigung!“). Legen Sie das Verhalten global oder für einzelne Plattformen fest; bei der plattformspezifischen Konfiguration schreibt der Einrichtungsassistent den Wert:

# ~/.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 wirksame Standardwert von Ihren Zulassungslisten ab. Sind keine konfiguriert, lautet er pair. Sobald eine beliebige Zulassungsliste festgelegt wurde (GATEWAY_ALLOWED_USERS oder die Variable einer Plattform für zugelassene Benutzer, zugelassene Gruppenbenutzer oder zugelassene Gruppenchats), wird ignore verwendet. Die Zulassungsliste signalisiert nämlich einen bewusst eingeschränkten gateway, bei dem das Senden von Codes an unbekannte Kontakte störend wäre und potenziell Informationen preisgeben könnte (#9337). Ein globales ignore oder decline setzt diese Regel außer Kraft, ein globales pair hingegen nicht, da es nicht vom Standardwert zu unterscheiden ist. Soll Pairing trotz Zulassungsliste möglich bleiben, legen Sie pair für jede Plattform einzeln fest. (Falls für den Adapter einer Plattform eine eigene dm_policy festgelegt ist, wird diese vor der Zulassungslistenregel berücksichtigt.) E-Mail ist als Posteingang konzipiert und verwendet standardmäßig ignore, sofern nicht über den eigenen plattformspezifischen Schlüssel ausdrücklich eine andere Einstellung aktiviert wird; ein globaler Wert gilt dafür nicht. Wenn Sie in hermes gateway setup eine Plattform ohne Zulassungsliste konfigurieren, steht „Ablehnen“ als Antwortoption zur Verfügung.⁵¹

Geplante Aufgaben (Cron)

Hermes verfügt über ein vollwertiges Cron-System, in dem Jobs Agentenaufgaben und keine Shell-Befehle sind. Jeder geplante Job wird über einen neuen AIAgent mit 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 innerhalb eines Messaging-Chats 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. Dafür sorgen 4 Mechanismen, die alle mit dem Tag v2026.8.31 verifiziert wurden:³⁵³⁷

• Kontinuität. continuity=true fügt bei jedem Durchlauf die eigene letzte Ausgabe eines Jobs ein, sodass ein Scout oder Monitor „aufwacht, sieht, was er zuletzt gemeldet hat, Duplikate vermeiden und dort weitermachen kann, wo er aufgehört hat“. Der eingefügte Hinweis lautet „Wiederholen Sie keine bereits gemeldeten Informationen“, der erste Durchlauf bleibt unverändert und intern wird das Flag als reservierter Eintrag self in context_from gespeichert. Schalten Sie es mit hermes cron create ... --continuity sowie hermes cron edit <job_id> --continuity / --no-continuity um.³⁷
• Dauerhafte Notizblöcke. Jeder Job erhält einen kleinen KV-Zwischenspeicher für Cursor, Markierungen und Beobachtungslisten (16 KB pro Wert, 64 KB pro Job – da er bei jedem Durchlauf in den Prompt eingefügt wird, sind diese Obergrenzen bewusst gewählt). Geschrieben wird 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 Takt zuerst ausgeführt wird: Eine unveränderte Ausgabe (als exakte Bytes verglichen) unterdrückt den Agentendurchlauf vollständig – kein LLM-Aufruf, keine Zustellung, sondern ein stiller no_change-Durchlauf. Bei einer Änderung wird dagegen ein Diff-Block eingefügt und der Agent wie gewohnt ausgeführt. Geben Sie aus Monitor-Skripten stabile Ausgaben zurück, da sonst jeder Takt wie eine Änderung wirkt.³⁷
• Individueller Reasoning-Aufwand pro Job und Zustellung an Bot Chat. Mit --reasoning-effort legen Sie die Denktiefe eines Jobs (none bis ultra) fest und überschreiben damit die globalen sowie modellspezifischen Einstellungen für dessen Durchläufe. Mit deliver=bot-chat gelangt die Ausgabe als echte eingehende Nachricht in die kanonische Bot-Chat-Sitzung eines profile. Dort „kümmert sich der Bot um alles, was Maßnahmen erfordert, und antwortet in seinem Chat“, statt dass ein Mensch lediglich einen Kanal liest.³⁷

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 die verfügbaren Tools 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

Alternativ können Sie die Konfiguration manuell in config.yaml vornehmen:¹⁴

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 2 Server dasselbe Tool anbieten. Außerdem erscheinen Protokollbenachrichtigungen der MCP-Server 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 verwendet weiterhin den PKCE-Ablauf, während device eine Gerätecode-Anmeldung gemäß RFC 8628 für headless oder entfernte Systeme ermöglicht. Das Flag überschreibt die Konfiguration oauth.flow des Servers. Diese Version erzwingt außerdem während der gesamten OAuth-Sitzung die profile-Zuständigkeit, ignoriert fehlerhafte Caches mit OAuth-Metadaten, anstatt einen Server zu blockieren, und leitet Desktop-MCP-OAuth über clientlokale Callbacks weiter. -t/--toolsets filtert nun zudem, welche konfigurierten MCP-Server gestartet werden, sodass ein eingeschränkter Aufruf nicht benötigte Server nicht erst zeitaufwendig startet.⁴⁴

Mit v0.21.0 wird die MCP-Oberfläche der Desktop-Anwendung zur Kommandozentrale: Server und Katalog erscheinen gemeinsam auf einer Seite, beliebige Inhalte lassen sich per Drag-and-drop importieren, Zustandsprüfungen im Hintergrund weisen auf bald ablaufende Authentifizierungen hin, bevor ein Tool-Aufruf fehlschlägt, und eine Kosten- und Nutzungsübersicht für die gesamte Serverflotte zeigt geschätzte Schema-Token sowie die Nutzung jedes Servers über 30 Tage. Über hermes://-Deep-Links kann nach ausdrücklicher Bestätigung ein MCP-Server installiert werden.³⁵

Das Versionsfenster v0.21.4 ergänzt mcp.discovery_concurrency (Standardwert 4; 0 = unbegrenzt, #117373): Damit wird begrenzt, zu wie vielen konfigurierten MCP-Servern die Erkennung gleichzeitig eine Verbindung aufbaut. Die Verbindung wird weiterhin zu jedem Server hergestellt – die Begrenzung verhindert lediglich, dass alle gleichzeitig angesprochen werden. Bei einem nicht ganzzahligen oder negativen Wert wird eine Warnung protokolliert und auf den Standardwert zurückgegriffen.⁵¹

Als Server – stellen Sie Hermes-Konversationen anderen Agenten zur Verfügung:

hermes mcp serve
hermes mcp serve -v    # Verbose

Kontextkomprimierung

Hermes komprimiert lange Konversationen automatisch, damit sie in das Kontextfenster Ihres Modells passen. Die Komprimierungszusammenfassung erfolgt über einen separaten LLM-Aufruf, den Sie an einen beliebigen Anbieter oder Endpunkt richten können.⁴ Seit v0.20.6 verwendet die Richtlinie für das beibehaltene Ende standardmäßig lean (compression.tail_mode: lean). Beim angegebenen Tag befinden sich die Optionen für Modell, Anbieter und Endpunkt der Zusammenfassung unter auxiliary.compression.* und nicht mehr 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 unverändertes Ende in der durch target_ratio bestimmten Größe bei. Bei Konfigurationen mit großem Kontextfenster oder erhöhtem Schwellenwert werden dadurch pro Komprimierung 100–240K Token gehortet. lean behält dagegen ein begrenztes unverändertes Ende von 2,5 % des Kontextfensters bei (mindestens 10K, höchstens 25K) und wahrt die Kontinuität stattdessen in der Zusammenfassung: durch ein detailliertes, Bezeichner erhaltendes Sitzungsprotokoll des komprimierten Bereichs (ein zusätzlicher Zusammenfassungsaufruf pro Versuch), einen mechanisch extrahierten Ankerindex (PR-Nummern, SHAs, Pfade, Fehlerzeichenfolgen – mittels regulärer Ausdrücke und niemals umformuliert), jedes echte Benutzerstatement als wörtliches Zitat sowie einen session_search-Wiederherstellungsverweis, über den der Agent erneut auf zusammengefasste Inhalte zugreifen kann. Das in der Dokumentation angegebene Messergebnis für echte Sitzungen mit 500K Token: Statt etwa 162K Token werden rund 49K beibehalten. Alte Tool-Ergebnisse innerhalb des lean-Endes werden zu einzeiligen Platzhaltern mit Wiederherstellungsverweis reduziert, und bei unbekannten tail_mode-Werten wird auf lean zurückgegriffen.³¹

Anbieteroptionen:⁴³¹

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

Warnungen bei knappem Budget

Wenn der Agent eine komplexe Aufgabe mit vielen Tool-Aufrufen bearbeitet, kann er sein Iterationsbudget (seit v0.20.0 standardmäßig 500 statt zuvor 90 Schritte) aufbrauchen, ohne es zu bemerken. Bei knappem Budget wird das Modell automatisch gewarnt:⁴

Streaming-Zeitüberschreitungen

Die LLM-Streaming-Verbindung verfügt über 2 Zeitüberschreitungsebenen, die sich für lokale Anbieter (localhost, LAN-IPs) automatisch anpassen:⁴

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

Lokales Web-Dashboard (v0.9.0+)

Ein browserbasiertes Dashboard zur lokalen Verwaltung Ihres Hermes Agent. Konfigurieren Sie Einstellungen, überwachen Sie Sitzungen, durchsuchen Sie skills und verwalten Sie Ihr gateway, ohne Konfigurationsdateien oder das Terminal verwenden zu müssen.¹⁶ 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 Sie beim Abschluss von Hintergrundaufgaben benachrichtigt, verfügt Hermes nun über eine vollständige Beobachtungsebene für Hintergrundprozesse.¹⁵

Austauschbare Context Engine (v0.9.0+)

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

Sicherung und Wiederherstellung (v0.9.0+)

hermes backup erstellt ein vollständiges Archiv Ihrer Konfiguration, Sitzungen, skills und Speicherinhalte. Mit hermes import stellen Sie diese aus einem Sicherungsarchiv wieder her.¹⁶ Damit können Sie zwischen Geräten migrieren, vor größeren Änderungen Momentaufnahmen erstellen oder eine bewährte Konfiguration mit Teammitgliedern teilen.

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

Hermes läuft über Termux nativ unter 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 schloss 8 P0-Sicherheitslücken und änderte eine Standardeinstellung zugunsten der Benutzer.¹⁸ v0.14.0 folgte mit der Behebung von weiteren 12 P0- und 50 P1-Problemen, darunter Schutzmaßnahmen gegen sudo-Brute-Force-Angriffe und Missbrauch von sudo-stdin, Korrekturen für die Umgehung der Erkennung gefährlicher Befehle, die Bereinigung von Tool-Fehlern vor ihrer erneuten Einspeisung in das Modell, die Authentifizierung für Dashboard-Plugin-API, SSRF-Schutz für den skills-hub sowie die Prüfung auf Lieferkettenwarnungen während der Installation.¹⁹

Wenn Sie eine Hermes-Bereitstellung verwalten, sollten Sie v0.13.0 und v0.14.0 als sicherheitsrelevante Upgrades behandeln und nicht nur als Funktionsupdates. v0.13.0 schließt die Guild-übergreifende Discord-Umgehung sowie zwei TOCTOU-Zeitfenster; v0.14.0 ergänzt weitere Härtungsmaßnahmen für die sudo-Verarbeitung, die erneute Einspeisung von Tool-Fehlern, Plugin-API, SSRF im skills-hub und Abhängigkeitswarnungen.

v0.21.0 ergänzt eine vierte Welle. Schreibzugriffe auf geschützte Dateien mit Agentenanweisungen – AGENTS.md, CLAUDE.md, SOUL.md, .cursorrules, skills und Speicher – erfordern nun stets eine Genehmigung. Dadurch kann ein durch Prompt-Injection kompromittierter Agent seine eigenen dauerhaft geltenden Anweisungen nicht unbemerkt umschreiben. Die Sperre ist standardmäßig aktiviert (security.protected_instruction_files: true, mit einer anhand von fnmatch ausgewerteten Liste zusätzlicher Basismuster in protected_instruction_extra_patterns). Der Quelltext benennt den dadurch geschlossenen Angriffsvektor ausdrücklich als „eine eingeschleuste Anweisung, die AGENTS.md / CLAUDE.md / SOUL.md bearbeitet“ und weist darauf hin, dass Anweisungsdateien aus cwd-Verzeichnisbäumen geladen werden. Deshalb sei „jede AGENTS.md an einem Ort, von dem aus der Agent später ausgeführt werden könnte, ein aktives Angriffsziel“.³⁵³⁹ 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 mit 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 Upstream-Projekts den Blender-MCP-Katalogeintrag samt skill und ergänzt Sicherheitsprüfungen der Stufe 1 bei Plugin-Installationen.³⁵³⁹

Architektur für Praktiker

Dieser Abschnitt richtet sich an alle, die verstehen möchten, was im Hintergrund geschieht, um Fehler zu beheben, Hermes zu erweitern oder die Performance zu beurteilen. 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 und angepasst.³

„47 Tools / 20 toolsets“ gegenüber „28 Tools“ in Ihrem Banner. Die Angabe „47 Tools“ bezeichnet die Gesamtzahl im Tool-Register des vorgelagerten Repositorys – also jedes Tool, dessen Quellcode Hermes über alle toolsets hinweg mitliefert. Ihr tatsächlich laufender CLI zeigt im Startbanner eine niedrigere Zahl an (die für diesen Leitfaden überprüfte Installation 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 gibt an, „was verfügbar ist“; die Zahl im Banner zeigt, „was in Ihrem aktuellen profile aktiviert ist“. Mit hermes tools --list prüfen Sie, welche toolsets aktiv sind. Einzelne toolsets aktivieren oder deaktivieren Sie über den Block toolsets: in ~/.hermes/config.yaml (oder innerhalb einer laufenden Sitzung mit /tools list / /tools enable <name> / /tools disable <name> – beim Entfernen eines Tools wird die Sitzung zurückgesetzt, damit der Agent sein Tool-Manifest neu erstellt).

Die drei API-Modi

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

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

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 beim Zusammensetzen des Prompts

Der Prompt-Stack umfasst:¹³

1. SOUL.md (Identität des Agents – oder ein integrierter Fallback, 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 die Grundlage – alles Weitere baut darauf auf.¹³

Sitzungsspeicher

SQLite-basierter Sitzungsspeicher mit FTS5-Volltextsuche. Sitzungen verfügen über eine Abstammungsverfolgung (über Komprimierungen hinweg zwischen übergeordneten und untergeordneten Sitzungen), eine plattformspezifische Trennung sowie atomare Schreibvorgänge mit Konfliktbehandlung.³

Falls der Speicher bei einer v0.21.x-Installation Probleme verursacht, verwenden Sie v0.21.2 oder neuer: Diese Version beseitigte die aus v0.21.0 bekannte Klasse von state.db-Problemen (zweite Schreibprozesse hoben gegenseitig ihre Sperren auf, intakte Datenbanken wurden als beschädigt gemeldet, eine einzige fehlerhafte Zeile ließ sessions list scheitern) und verlagerte die Koordination gehosteter Räume aus dem Root-Speicher in eine eigene shared-state.db, sodass profile-gateways den zentralen Sitzungsspeicher niemals mit Schreibzugriff öffnen. hermes doctor unterscheidet nun zwischen strukturellen Schäden und Schäden am FTS-Index. Bei FTS-Schäden wird lediglich die Suche eingeschränkt, statt den Turn fehlschlagen zu lassen. Zudem meldet hermes sessions recover --inspect-only (offline, nicht destruktiv und an das profile gebunden), ob die kanonischen Tabellen lesbar sind, ohne eine Ausgabedatenbank anzulegen – der Unterbefehl existierte bereits vor diesem Zeitfenster, war hier jedoch noch nicht dokumentiert. Weitere Informationen finden Sie unter Neuerungen in v0.21.2.⁴⁸ Für einen Speicher, der im falschen SQLite-Journalmodus feststeckt, führte das v0.21.4-Zeitfenster den Offline-Konverter hermes sessions set-journal-mode delete|wal ein (siehe die Zeile 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 einen Kontext-API. Speicheranbieter sind ein spezialisierter Plugin-Typ unter plugins/memory/.³ Seit v0.21.2 gibt es außerdem einen kuratierten, per SHA fixierten Plugin-Katalog, den Sie durchsuchen und aus dem Sie Plugins nach Namen installieren können, sowie hermes plugins pack für „deklarative, teilbare Plugin-Sammlungen“: Eine einzelne hermes-pack.yaml fixiert eine Gruppe von Plugins auf exakte Commit-SHAs. Bei der Installation eines Packs werden daraus reguläre, fixierte Einzelinstallationen; die Zustimmung zu Funktionen bleibt für jedes Plugin separat erforderlich.⁴⁸

Im v0.21.4-Zeitfenster 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 überprüfter YAML pro Plugin (Name, Repository, Betreuer, Stufe, Kategorie, Funktionen), jeweils auf einen exakten 40-stelligen Commit-SHA fixiert, wobei die Aufnahme in das Verzeichnis zugleich die Zulassung darstellt. Für den CLI wird der Katalog als plugin-catalog.json veröffentlicht (live abgerufen und unter ~/.hermes/cache/ zwischengespeichert). Die Dokumentationswebsite erstellt nun aus denselben Daten je eine Seite pro Plugin (/docs/plugins/<name>) und Autor (/docs/plugins/by/<slug>). Jede Seite stellt die README-Datei des Plugins dar, die vom fixierten Commit und niemals von der Spitze eines Branches abgerufen wird. Dabei kommt eine Allowlist zur Build-Zeit zum Einsatz, die unverarbeitetes HTML entfernt; die Sortierung nach „hinzugefügt“ und „aktualisiert“ basiert auf den Datumsangaben der Committer. Die zehn Community-Plugins, die in der Veröffentlichung von v0.21.4 genannt werden, sind am Tag im Katalog 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-Anwendung können Plugins nun über den Plugins-Hub und einen 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+)

Das Kompatibilitätsfenster (v0.21.1) ist 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-Schicht exportierte 1.148 verschobene öffentliche Namen erneut aus ihren alten Modulen und gab pro Name und Prozess einmalig eine Warnung aus (HermesPluginCompatWarning). Die Entfernung trat planmäßig am 14. September 2026 in Kraft – über eine Datumssperre im ausgelieferten Code (COMPAT_REMOVAL_DATE in hermes_cli/plugin_compat.py; ein Zurücksetzen des Codes war nicht erforderlich): Seit diesem Datum wird ein betroffenes Plugin deaktiviert und nicht geladen. Ein roter Hinweis erscheint im CLI-Banner, in hermes doctor und in hermes update, einmalig als Desktop-Dialog; außerdem wird der Grund in hermes plugins list angezeigt. Für Autoren gilt: hermes plugins compat <path> gibt weiterhin jede Fundstelle im Format file:line mit altem Pfad -> neuem Pfad aus und beendet sich mit Status 1, solange noch Fundstellen 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 boolescher YAML-Wert und darf keine Zeichenkette in Anführungszeichen sein. Dies funktioniert weiterhin, weil der Revert, der die alten Pfade löscht, noch nicht übernommen wurde: Manifest und Shims sind in v2026.9.14, v2026.9.21, v2026.9.24 sowie mit Stand vom 24. September auf main vorhanden (im v0.21.4-Zeitfenster wurde das Kompatibilitätsmodul lediglich geändert, um Plugin-Scans zwischenzuspeichern und Windows-Pfade zu normalisieren; im v0.21.5-Zeitfenster blieb hermes_cli/plugin_compat.py unverändert, und nur die Manifesteinträge für das gelöschte Hindsight-Modul wurden entfernt). Sobald dieser Revert übernommen wird, funktioniert dieser Ausweg nicht mehr, weil dann 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 öffentlichen Oberfläche und werden nicht wiederhergestellt.⁴²⁵³

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 älteren Verzeichnisse ~/.clawdbot und ~/.moldbot) und schreibt nach ~/.hermes.⁶

Direkt importiert (mehr als 30 Kategorien): SOUL.md, MEMORY.md, USER.md, AGENTS.md, skills aus 4 Quellverzeichnissen, Standardmodell, benutzerdefinierte Anbieter, 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 niemals eine Konversation⁴³), Genehmigungsregeln, TTS-Konfiguration, Browsereinstellungen, Tool-Einstellungen, Zeitüberschreitung für Ausführungen, Befehlszulassungsliste, gateway-Konfiguration und API-Schlüssel aus 3 Quellen.⁶

Zur manuellen Prüfung archiviert: cron-Aufgaben, 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 von API-Schlüsseln werden 3 Quellen in folgender Prioritätsreihenfolge geprüft: Konfigurationswerte → ~/.openclaw/.env → auth-profiles.json.⁶

Fehlerbehebung

„Kein Inferenzanbieter konfiguriert. Führen Sie ‘hermes model’ aus, um einen Anbieter und ein Modell auszuwählen“

Auf diesen ersten Fehler stößt jede Neuinstallation: Für Hermes wurde noch kein Anbieter aufgelöst. Die Meldung ist wörtlich zu verstehen – keiner der 3 Authentifizierungswege hat einen verwendbaren Anbieter ergeben. Führen Sie Folgendes aus:

hermes model

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

„API-Schlüssel nicht festgelegt“

Führen Sie hermes model aus, um Ihren Anbieter 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.⁷

„Kontextlimit: 2048 Tokens“ beim Start (lokale Modelle)

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

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

Tool-Aufrufe erscheinen als Text, anstatt 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 gibt es 2 mögliche Ursachen:²

1. Niedrige Ausgabebegrenzung (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.

„Verbindung abgelehnt“ von WSL2 zu einem unter Windows ausgeführten Modellserver

WSL2 verwendet einen virtuellen Netzwerkadapter mit eigenem Subnetz – localhost innerhalb von WSL2 verweist 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 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 agent.max_turns: 500 festgelegt ist, liegt dies wahrscheinlich an einer veralteten Zeile HERMES_MAX_ITERATIONS in ~/.hermes/.env: Der Einrichtungsassistent schrieb das Budget früher in beide Speicher. Bricht die Startbrücke aufgrund eines vorherigen Fehlers beim Parsen der Konfiguration ab, setzt sich der verwaiste .env-Wert unbemerkt durch. Seit v0.21.1 erkennt hermes doctor dieses sich überschneidende Wertepaar, und hermes doctor --fix löscht die Zeile aus .env, sodass config.yaml maßgeblich bleibt.⁴¹

Wo befindet sich was?

hermes status und hermes dump helfen Ihnen dabei weiter. hermes logs list zeigt alle Protokolldateien mit ihren Größen 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.¹² Hermes enthält außerdem einen Messaging-gateway für Telegram/Discord/Slack/WhatsApp/Signal, den Claude Code nicht bietet.

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

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

1. Legen Sie ANTHROPIC_API_KEY in ~/.hermes/.env fest 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 wird empfohlen, 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 werden vollständig übernommen:⁹

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

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

In aktuellen Builds kann dies auf die frühere Weise größtenteils nicht mehr passieren. Standardmäßig (auxiliary.*.provider: "auto") wird jede Hilfsaufgabe — Bildverarbeitung, Genehmigungsklassifizierung, Komprimierung und Sitzungstitel — mit Ihrem Haupt-Chatmodell ausgeführt. Eine reine Anthropic-Konfiguration verarbeitet diese Aufgaben daher mit dem bereits vorhandenen OAuth. Der frühere Standard (Gemini Flash über OpenRouter → Nous → automatische Codex-Erkennung, mit stiller Funktionseinschränkung, wenn 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 dennoch 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 dem Tag v2026.8.31 wird die Komprimierungszusammenfassung wie jeder andere Hilfsaufgabenplatz konfiguriert — über auxiliary.compression.provider — und veraltete compression.summary_*-Schlüssel werden automatisch dorthin migriert (Konfigurationsversion 17).³¹ Die Webextraktion ist überhaupt keine LLM-Aufgabe mehr („kein LLM beteiligt“). Ein Fehler bei der Webzusammenfassung ist in aktuellen Builds daher kein Problem des Hilfsmodells.³⁴ So weisen Sie eine Aufgabe ausdrücklich wieder Ihrem Hauptanbieter zu:

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

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

SOUL.md definiert die Identität Ihres Agenten — Tonalität, Stil und Kommunikationsvorgaben. 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, kommt 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.² Die Einrichtung für die einzelnen Server 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 vorgelagerten Architekturregistrierung — das ist die Gesamtzahl der Tools, deren Quellcode Hermes über alle toolsets hinweg bereitstellt. Ihre laufende Installation zeigt im Banner eine geringere Zahl an (die für diesen Leitfaden verwendete Referenzinstallation meldet 28 Tools), weil 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 unter toolsets: in ~/.hermes/config.yaml explizit aufgeführt werden, bevor sie geladen werden. Registrierungsgesamtzahl = „was verfügbar ist, wenn Sie es aktivieren“. Bannergesamtzahl = „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. Beim Deaktivieren wird die Sitzung zurückgesetzt, damit der Agent sein Toolmanifest 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 zum Fallback, ohne den Unterhaltungsverlauf zu verlieren. Dies geschieht höchstens einmal pro Sitzung.

Kann der Agent seine eigenen skills im Laufe der Zeit verbessern?

Ja — genau darin besteht der „selbstverbessernde“ Teil von Hermes Agent. Der Agent kann über das Tool skill_manage skills erstellen, aktualisieren und löschen. Wenn er einen nicht trivialen Arbeitsablauf entwickelt, speichert er die Vorgehensweise als skill zur späteren Wiederverwendung.¹¹ Der Agent erstellt skills nach komplexen Aufgaben (mehr als 5 Toolaufrufe), wenn Fehler auftreten und er den funktionierenden Lösungsweg findet, wenn Sie seine Vorgehensweise korrigieren oder wenn er einen nicht trivialen Arbeitsablauf entdeckt.

Gibt es eine IDE-Integration?

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

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

Änderungsprotokoll