Hermes KI-Assistent – Installation, Einrichtung, Arbeitsablauf und Fehlerbehebung

Hermes Agent ist ein selbst gehosteter, modellagnostischer KI-Assistent, der auf einer lokalen Maschine oder einem kostengünstigen VPS läuft, über Terminal- und Messaging-Oberflächen arbeitet und sich mit der Zeit verbessert, indem er wiederholte Aufgaben in wiederverwendbare Fähigkeiten umwandelt.

In seiner Funktionalität ist er sehr ähnlich zu OpenClaw, einem anderen selbst gehosteten Assistenten-Stack, der um Werkzeuge, Gedächtnis und lokale Kontrolle herum aufgebaut ist.

Wenn Sie den weiteren Kontext selbst gehosteter Assistenten, Abrufsysteme und lokaler Infrastruktur rund um Hermes verstehen möchten, verbindet diese Übersicht über KI-Systeme diese Themen mit den gleichen Problemen, die Hermes zu lösen versucht.

Für Kompromisse bei der Bereitstellung und Laufzeitentscheidungen bietet LLM Hosting in 2026: Lokal, selbst gehostet und Cloud-Infrastruktur im Vergleich die Hosting-Landkarte, während LLM-Leistung in 2026: Benchmarks, Engpässe und Optimierung die Seite des Durchsatzes und der Latenz abdeckt, sobald Hermes läuft.

Meine voreingenommene Meinung: Hermes ist am interessantesten, wenn er als Infrastruktur und nicht als Reiter behandelt wird, den man gelegentlich öffnet. Sobald er als Dienst läuft und ein stabiles Heimatverzeichnis hat, beginnen Ihre Prompts weniger wie „Chat" und mehr wie „Ops" auszusehen.

Was Hermes Agent ist und warum es wichtig ist

Hermes Agent ist ein Open-Source-KI-Agent, der von Nous Research entwickelt wurde. Er ist darauf ausgelegt, persistent zu laufen, Werkzeuge (Terminal, Dateien, Web und mehr) zu nutzen und sein eigenes Verhalten im Laufe der Zeit mit einem System aus Fähigkeiten und Gedächtnis zu verbessern.

Zwei Designentscheidungen sind erwähnenswert, da sie alles andere in diesem Leitfaden prägen.

Erstens ist Hermes nicht an einen einzelnen Modellanbieter gebunden. Der offizielle Setup-Workflow unterstützt mehrere Anbieter und jede OpenAI-kompatible Endstelle, und das Umschalten erfolgt über den Befehl hermes model statt durch Code-Änderungen.

Zweitens zieht Hermes eine harte Trennlinie zwischen „Gespräch" und „Ausführung". Der Agent kann den ganzen Tag reden, aber wenn er handeln muss, tut er dies durch explizite Werkzeuge und eine konfigurierbare Ausführungsumgebung. Dort leben Sicherheit, Reproduzierbarkeit und Fehlerbehebung.

Kosten und Lizenzierung sind erfrischend langweilig. Hermes Agent selbst ist freie Software unter der MIT-Lizenz. Wenn Sie gehostete Modelle nutzen, fallen laufende Kosten an, die Ihrem Anbieter berechnet werden. Wenn Sie lokale Modelle ausführen, können Sie API-Gebühren vollständig vermeiden.

Wenn Ihre Hermes-Konfiguration Claude über externe Werkzeugschichten nutzt, ist diese Änderung an den Anthropic-Abonnements eine nützliche Referenz dafür, warum die abrechnungsbasierte Nutzung von APIs jetzt der erwartete Weg ist.

Hermes Agent installieren

Hermes bietet einen schnellen Installationspfad für Linux, macOS und WSL2. Die offiziellen Dokumente halten dies absichtlich einfach.

Einzeilige Installation

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

Nach der Installation laden Sie Ihre Shell neu und starten die CLI.

source ~/.bashrc   # oder source ~/.zshrc
hermes

Der Installer ist nicht nur eine dünne Hülle. Laut Installationsanleitung richtet er Abhängigkeiten, das Repository, eine virtuelle Umgebung und den hermes-Befehl ein und bringt Sie in einen ersten chatbereiten Zustand.

Hinweise zu Windows und Android

Native Windows-Unterstützung ist nicht vorhanden. Die Dokumente empfehlen WSL2 und das Ausführen von Hermes darin.

Für Android unterstützt Hermes einen Installationspfad über Termux. Er ist so konzipiert, dass er Termux erkennt und seine Abhängigkeiten und Umgebungssetup entsprechend anpasst.

Schnellstart

Der schnellste erste Start ist buchstäblich nur hermes, aber ein aussagekräftiger Schnellstart bedeutet zwei zusätzliche Entscheidungen: Welchen Modellanbieter zu nutzen und welche Werkzeuge aktiviert werden sollen.

Anbieter und Modell auswählen

Hermes bietet drei ergänzende Einstiegspunkte:

• hermes model, um einen Anbieter und ein Standardmodell auszuwählen
• hermes tools, um Werkzeugsets zu aktivieren oder zu deaktivieren
• hermes setup, um einen interaktiven Assistenten für wichtige Konfigurationsbereiche zu starten

Ein minimaler Workflow sieht so aus:

hermes model
hermes tools
hermes

In Bezug auf das, was tatsächlich unterstützt wird, listet der offizielle Schnellstart eine Reihe von Anbietern auf und weist darauf hin, dass Hermes mit OpenAI-kompatiblen APIs funktioniert. Das ist wichtig, da dies sowohl gehostete Dienste als auch selbst gehostete Endstellen umfasst.

Werkzeugausführung frühzeitig beweisen

Bevor Sie Gewohnheiten rund um Hermes aufbauen, ist es sinnvoll zu überprüfen, ob die Werkzeugnutzung in Ihrer Umgebung funktioniert. Der Schnellstart schlägt explizit die Terminalnutzung als erstes Feature vor, das man ausprobieren sollte.

In der Praxis erledigt eine kleine „Rauchtest"-Anfrage zwei Aufgaben: Sie überprüft das Terminal-Werkzeug und validiert Berechtigungsaufforderungen.

Beispielaufforderung:

Zeige meine Festplattenbelegung und die fünf größten Verzeichnisse.

Wenn Hermes das Terminal-Werkzeug nicht ausführen kann, springen Sie direkt zu Fehlerbehebung. Eine fehlerhafte Konfiguration des Terminal-Backends ist eine der häufigsten Ursachen, und die Lösung ist meist offensichtlich, sobald man sich die Konfiguration anschaut.

Skalierbare Konfiguration

Hermes belohnt Menschen, die verstehen, wo er seinen Zustand speichert und wie er Konfigurationen auflöst. Hierher stammen auch viele Probleme vom Typ „Es funktionierte gestern noch".

Wo Konfiguration und Zustand gespeichert werden

Hermes speichert seine Einstellungen und seinen Zustand unter ~/.hermes. Der offizielle Konfigurationsleitfaden dokumentiert die Struktur, einschließlich config.yaml für Einstellungen, .env für Geheimnisse, auth.json für OAuth-Credentials, SOUL.md für die Identität sowie Ordner für Erinnerungen, Fähigkeiten, Cron-Jobs, Sitzungen und Logs.

Das ist aus zwei Gründen wichtig.

• Fehlerbehebung wird mechanisch, weil Sie genau wissen, wo Sie suchen müssen.
• Backups werden einfach, weil ein Verzeichnis den größten Teil des Agentenzustands erfasst, der Ihnen wichtig ist.

Konfigurationspräzedenz und Geheimnisse aus config.yaml heraushalten

Hermes löst Konfigurationen mit einer Präzedenzreihenfolge auf. An der Spitze stehen CLI-Überschreibungen, dann config.yaml, dann .env, mit integrierten Standards am unteren Ende.

Das nette Detail ist, dass hermes config set Werte in die richtige Datei leitet: API-Schlüssel in .env und nicht vertrauliche Einstellungen in config.yaml.

hermes config set model openrouter/meta-llama/llama-3.1-70b-instruct
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxx

Hermes unterstützt auch die Substitution von Umgebungsvariablen innerhalb von config.yaml über die Syntax ${VAR_NAME}. Dies ist nützlich, wenn Sie bestimmte Werte in der Umgebung behalten, aber dennoch in der strukturierten Konfiguration darauf verweisen möchten.

Sandbox und Ausführungsbackends

Hermes unterstützt mehrere Terminal-Backends, die definieren, wo Shell-Befehle tatsächlich ausgeführt werden. Der Konfigurationsleitfaden listet local, docker, ssh, modal, daytona und singularity auf.

Die meinungsbasierte, aber nicht missionarische Art, dies zu betrachten, ist:

• local ist am schnellsten und einfachsten, aber nicht isoliert
• docker ist eine pragmatische Sicherheitsschicht und Reproduzierbarkeitsschicht
• ssh ist eine saubere Möglichkeit, Ihr Chat-Gerät von Ihrer Rechenbox zu trennen
• modal und daytona passen zu Workflows, die „serverlos, aber persistent genug" sind
• singularity ist die HPC-freundliche Option

Ein minimales Beispiel für ein Docker-Backend:

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_volumes:
    - "/home/user/projects:/workspace/projects"
  docker_forward_env:
    - "GITHUB_TOKEN"

Die Dokumente beschreiben auch die Sicherheitsverstärkung für das Docker-Backend, wie das Entfernen von Fähigkeiten und das Deaktivieren der Privilegieneskalation.

Fähigkeiten, Gedächtnis und Profile

Hermes hat zwei verwandte Mechanismen zur Wertschöpfung.

Fähigkeiten sind prozedurales Gedächtnis. Hermes kann seine eigenen Fähigkeiten erstellen, aktualisieren und löschen und kann anbieten, einen Ansatz als Fähigkeit zu speichern, nachdem er eine komplexe Aufgabe abgeschlossen hat.

Das integrierte Gedächtnis wird als Dateien wie MEMORY.md und USER.md unter ~/.hermes gespeichert, und Hermes kann auch externe Gedächtnisanbieter für tiefere Erinnerungen nutzen. Die Gedächtnisdokumente listen mehrere Anbieter-Plugins auf, und der Leitfaden für Gedächtnisanbieter dokumentiert einen interaktiven Setup-Workflow.

Wenn Sie mehrere unabhängige Agenten auf derselben Maschine haben möchten, bieten Hermes-Profile Isolation. Jedes Profil erhält sein eigenes Verzeichnis mit eigener Konfiguration, Geheimnissen, Erinnerungen, Sitzungen, Fähigkeiten, Cron-Jobs und Gateway-Zustand.

Für einen tieferen Einblick in welche Fähigkeiten in der Produktion nach Rolle gut funktionieren – Ingenieure, Forscher, Betreiber und Führungskräfte-Workflows – sehen Sie Hermes AI Assistant Skills für echte Produktionssetups.

Typischer Workflow

Wenn Sie Hermes wie einen Agenten behandeln, den Sie behalten werden, beginnt der Workflow, wie Service-Engineering auszusehen.

Eine stabile Basislinie

Eine Basislinie, die tendenziell nicht verrottet, ist:

1. Installieren und führen Sie einen ersten Chat in der CLI aus.
2. Wählen Sie einen Anbieter und ein Modell mit hermes model und bestätigen Sie die Kosten.
3. Konfigurieren Sie Werkzeugsets und entscheiden Sie, ob die Terminalausführung lokal oder sandboxed ist.
4. Ändern Sie SOUL.md nur nach einer Weile der Nutzung der Standardeinstellung. Identitätsänderungen sind wichtiger, als die meisten erwarten, da es „Slot 1" im System-Prompt ist.

Tägliche Nutzung, die sich summiert

Hermes hat eine Terminal-Oberfläche statt einer Weboberfläche und ist für lange Sitzungen mit Slash-Befehlen, wieder aufnehmbaren Sitzungen und gestreamtem Werkzeugoutput konzipiert.

In der Praxis ist ein nützlicher Rhythmus:

• Arbeiten Sie in einer benannten Sitzung für ein Projekt
• Komprimieren Sie den Kontext, wenn er zu groß wird
• Lassen Sie Hermes wiederholte Routinen in Fähigkeiten umwandeln
• Halten Sie eine mentale Grenze zwischen „fragen" und „handeln", damit die Werkzeugausführung überprüfbar bleibt

Messaging-Gateway für 24/7-Zugriff

Das Messaging-Gateway ist das Element, das Hermes wie einen Assistenten und nicht wie eine Terminal-App fühlen lässt. Die Dokumente beschreiben es als einen einzelnen Prozess, der sich mit mehreren Plattformen verbindet, Sitzungen verwaltet, Cron-Jobs ausführt und Nachrichten liefert.

Das Setup wird über hermes gateway setup aufgerufen, und das Gateway kann im Vordergrund oder als Benutzerservice laufen. Der CLI-Referenz dokumentiert Gateway-Subbefehle wie run, install, start, stop, status und restart.

Sicherheit für einen Werkzeug benutzenden Bot ist wichtig. Die Gateway-Dokumente beschreiben Zulassungslisten für spezifische Plattformen und einen DM-Pairing-Workflow, der einmalige Pairing-Codes ausgibt und eine Genehmigung über hermes pairing approve erfordert.

Updates ohne Drama

Hermes-Updates sind ein First-Class-Befehl. Der Update-Leitfaden dokumentiert hermes update, Konfigurationsmigrationsprüfungen und eine kleine Validierungsroutine nach dem Update, einschließlich hermes doctor und hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Fehlerbehebung und Diagnose

Die meisten Hermes-Fehler sind nicht mysteriös. Sie wirken mysteriös, weil Menschen nur die Modellschicht prüfen und die Laufzeitschicht ignorieren.

Schnelle Triage-Befehle

Die CLI-Referenz positioniert explizit drei Befehle als Kernschleife:

• hermes doctor für interaktive Diagnose
• hermes status für eine schnelle Übersicht
• hermes dump für eine teilbare, zensierte Zusammenfassung des Setups

Für Logs folgt hermes logs Dateien unter ~/.hermes/logs.

hermes doctor --fix
hermes status
hermes dump --show-keys
hermes logs errors -f

Häufige Installationsfehler

Die FAQ und der Fehlerleitfaden listen mehrere wiederkehrende Probleme und ihre Lösungen auf, einschließlich Python-Version-Problemen, uv nicht gefunden und Berechtigungsproblemen, die durch das Mischen von sudo-Installationen mit Benutzerinstallationen verursacht werden.

Wenn Sie auf diese Fehler stoßen, bieten die Dokumente spezifische Schritte zur Behebung an, wie das Aktualisieren von Python, das Installieren von uv und das Neuinstallieren von Hermes ohne sudo.

Probleme mit Anbietern und Modellen

Wenn API-Schlüssel nicht funktionieren, empfiehlt die FAQ, die Konfiguration zu überprüfen, hermes model erneut auszuführen oder einen Schlüssel direkt über hermes config set zu setzen. Es wird auch auf eine häufige Falle hingewiesen: Schlüssel sind anbieter spezifisch.

Bei Problemen mit „Modell nicht gefunden" verweist die FAQ zurück auf die Verwendung von hermes model, um eine gültige Identifikation auszuwählen, und zeigt sowohl Konfigurations- als auch pro-Sitzungs-Überschreibungen.

Probleme mit Limitierung und Kontextlänge werden ebenfalls behandelt. Die FAQ schlägt vor, bei 429-Fehlern zu warten, den Anbieter oder das Modell zu wechseln und den Kontextdruck durch Komprimierung oder eine neue Sitzung zu reduzieren.

Terminal-Backend- und Gateway-Probleme

Wenn Terminal-Befehle sofort fehlschlagen, enthält der Konfigurationsleitfaden einen Abschnitt „Häufige Terminal-Backend-Probleme" und weist auf die typischen Ursachen pro Backend hin, einschließlich Docker läuft nicht und fehlende SSH-Variablen. Es wird auch angemerkt, dass ein Fallback auf lokal eine gültige Debugging-maßnahme ist, wenn die Sandbox-Konfiguration in Frage steht.

Bei Gateway-Problemen hebt der Messaging-Leitfaden Zulassungslisten und Pairing als sichere Standardeinstellungen hervor, was bedeutet, dass viele Vorwürfe „Bot ist still" eigentlich Autorisierungen sind, die ihre Arbeit tun.

Referenzen

• Hermes Agent Homepage
• Hermes AI Assistant Skills für echte Produktionssetups