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

Hermes-Agent-Installation und Schnellstart für Entwickler

Inhaltsverzeichnis

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-Schnittstellen arbeitet und sich im Laufe der Zeit verbessert, indem er wiederholte Aufgaben in wiederverwendbare Fähigkeiten umwandelt.

In Bezug auf die Funktionalität ist er sehr ähnlich zu OpenClaw, einem weiteren selbst gehosteten Assistenten-Stack, der auf Werkzeugen, Speicher und lokaler Kontrolle aufbaut.

Wenn Sie den größeren Kontext selbst gehosteter Assistenten, Retrieval und lokaler Infrastruktur rund um Hermes verstehen möchten, verbindet dieser Überblick über KI-Systeme diese Themen mit den Problemen, die Hermes lösen will.

Für Kompromisse bei der Bereitstellung und Auswahl der Laufzeitumgebung bietet LLM-Hosting im Jahr 2026: Lokal, selbst gehostet und Cloud-Infrastruktur im Vergleich die Hosting-Landkarte, während LLM-Leistung im Jahr 2026: Benchmarks, Engpässe und Optimierung den Durchsatz und die Latenz abdeckt, sobald Hermes läuft.

peronal-ai-assistant on laptop

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

Was Hermes Agent ist und warum er wichtig ist

Hermes Agent ist ein Open-Source-KI-Agent, der von Nous Research entwickelt wurde. Er ist so konzipiert, dass er persistent läuft, Werkzeuge (Terminal, Dateien, Web und mehr) nutzt und sein eigenes Verhalten im Laufe der Zeit mit einem System für Fähigkeiten und Speicher verbessert.

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

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

Zweitens zieht Hermes eine harte Grenze 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ührungshintergrund. Genau dort liegen Sicherheit, Reproduzierbarkeit und Fehlerbehebung.

Kosten und Lizenzierung sind erfrischend langweilig. Hermes Agent selbst ist freie Software unter der MIT-Lizenz. Wenn Sie gehostete Modelle verwenden, sind die laufenden Kosten, was Ihr Anbieter berechnet. Wenn Sie lokale Modelle ausführen, können Sie API-Gebühren ganz vermeiden.

Hermes Agent installieren

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

Einzeilen-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 werden nicht unterstützt. Die Dokumente empfehlen WSL2 und das Ausführen von Hermes darin.

Für Android unterstützt Hermes einen Termux-Installationspfad. Er ist so konzipiert, dass er Termux erkennt und seine Abhängigkeiten sowie die Umgebungs-setup entsprechend anpasst.

Schnellstart

Der schnellste erste Lauf ist buchstäblich nur hermes, aber ein aussagekräftiger Schnellstart bedeutet zwei zusätzliche Entscheidungen: welchen Model-Anbieter man nutzt und welche Werkzeuge aktiviert werden sollen.

Einen Anbieter und ein Modell auswählen

Hermes bietet drei komplementäre 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 auszuführen

Ein minimaler Ablauf 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 betont, dass Hermes mit OpenAI-kompatiblen APIs funktioniert. Das ist wichtig, weil dies sowohl gehostete Dienste als auch selbst gehostete Endpunkte umfasst.

Werkzeugausführung frühzeitig beweisen

Bevor Sie Gewohnheiten um Hermes herum aufbauen, lohnt es sich zu überprüfen, ob die Werkzeugnutzung in Ihrer Umgebung funktioniert. Der Schnellstart schlägt explizit die Terminal-Nutzung als erste Funktion vor, die man ausprobieren sollte.

In der Praxis erfüllt ein kleiner „Rauchtest"-Prompt zwei Aufgaben: Er überprüft das Terminal-Werkzeug und validiert Berechtigungsabfragen.

Beispielprompt:

Zeige meine Datenträgerauslastung 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 ansieht.

Skalierbare Konfiguration

Hermes belohnt diejenigen, die verstehen, wo er den Status speichert und wie er Konfiguration auflöst. Hier stammen auch viele „es funktionierte gestern"-Probleme her.

Wo Konfiguration und Status gespeichert werden

Hermes speichert seine Einstellungen und seinen Status unter ~/.hermes. Der offizielle Konfigurationsleitfaden dokumentiert das Layout, einschließlich config.yaml für Einstellungen, .env für Geheimnisse, auth.json für OAuth-Credentials, SOUL.md für Identität und Ordner für Erinnerungen, Fähigkeiten, Cron, 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 Agenten-Status erfasst, der Sie interessiert.

Konfigurationspriorität und Geheimnisse aus config.yaml halten

Hermes löst Konfiguration mit einer Prioritätsreihenfolge auf. An der Spitze stehen CLI-Überschreibungen, dann config.yaml, dann .env, mit integrierten Standardwerten am Boden.

Das nette Detail ist, dass hermes config set Werte in die richtige Datei leitet: API-Schlüssel in .env und nicht geheime 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 Ersetzung von Umgebungsvariablen in config.yaml über die ${VAR_NAME}-Syntax. Dies ist nützlich, wenn Sie bestimmte Werte in der Umgebung behalten, aber sie dennoch in strukturierten Konfigurationen referenzieren möchten.

Sandbox und Ausführungs-Backends

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 Meinungsführende, aber nicht evangelische Art, darüber nachzudenken, ist:

  • local ist am schnellsten und einfachsten, aber es ist nicht isoliert
  • docker ist eine pragmatische Schicht für Sicherheit und Reproduzierbarkeit
  • ssh ist eine saubere Möglichkeit, Ihr Chat-Gerät von Ihrem Rechen-Box zu trennen
  • modal und daytona passen zu „serverlos, aber persistent genug"-Workflows
  • singularity ist die HPC-freundliche Option

Ein minimales Docker-Backend-Beispiel:

# ~/.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 Sicherheitshärtung für das Docker-Backend, wie das Entfernen von Fähigkeiten und das Deaktivieren der Privilegieneskalation.

Fähigkeiten, Speicher und Profile

Hermes verfügt über zwei zusammenhängende Mechanismen zur Kumulierung von Wert.

Fähigkeiten sind prozedurales Gedächtnis. Hermes kann seine eigenen Fähigkeiten erstellen, aktualisieren und löschen und kann anbieten, einen Ansatz nach Abschluss einer komplexen Aufgabe als Fähigkeit zu speichern.

Der integrierte Speicher wird als Dateien wie MEMORY.md und USER.md unter ~/.hermes gespeichert, und Hermes kann auch externe Speicheranbieter für tiefere Abrufbarkeit nutzen. Die Speicher-Dokumente listen mehrere Anbieter-Plugins auf, und der Leitfaden für Speicheranbieter dokumentiert einen interaktiven Setup-Workflow.

Wenn Sie mehrere unabhängige Agenten auf derselben Maschine wünschen, bieten Hermes-Profile Isolierung. Jedes Profil erhält sein eigenes Verzeichnis mit eigener Konfiguration, Geheimnissen, Erinnerungen, Sitzungen, Fähigkeiten, Cron-Jobs und Gateway-Status.

Typischer Arbeitsablauf

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

Eine stabile Basis

Eine Basis, die 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 Terminal-Ausführung lokal oder sandboxed ist.
  4. Ändern Sie SOUL.md nur nach einer Weile der Nutzung des Standards. Identitätsänderungen sind wichtiger, als die Leute erwarten, da es „Slot 1" im System-Prompt ist.

Tägliche Nutzung, die sich kumuliert

Hermes hat eine Terminal-Benutzeroberfläche statt einer Web-Oberfläche und ist für lange Sitzungen mit Slash-Befehlen, wiederaufnehmbaren Sitzungen und gestreamten Werkzeugausgaben 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 Stück, das Hermes wie einen Assistenten und nicht wie eine Terminal-App fühlen lässt. Die Dokumente beschreiben es als einen einzelnen Prozess, der mit mehreren Plattformen verbunden ist, 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 Benutzerdienst laufen. Die CLI-Referenz dokumentiert Gateway-Unterbefehle wie run, install, start, stop, status und restart.

Sicherheit für einen werkzeugnutzenden Bot ist wichtig. Die Gateway-Dokumente beschreiben Whitelists für bestimmte Plattformen und einen DM-Paarungs-Workflow, der einmalige Paarungs-Codes ausstellt 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 die Leute nur die Model-Schicht 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 einen schnellen Überblick
  • hermes dump für eine teilbare, zensierte Setup-Zusammenfassung

Für Logs tails hermes logs die Dateien unter ~/.hermes/logs.

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

Häufige Installationsfehler

Die FAQ und der Fehlerbehebungsleitfaden listen mehrere wiederkehrende Probleme und deren Lösungen auf, einschließlich Python-Version-Probleme, uv nicht gefunden und Berechtigungsprobleme durch Mischen von sudo- und Benutzerinstallationen.

Wenn Sie auf diese Fehler stoßen, bieten die Dokumente spezifische Abhilfeschritte 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 weist auch auf eine häufige Falle hin: Schlüssel sind anbieter spezifisch.

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

Drosselungs- und Kontextlängenprobleme werden ebenfalls behandelt. Die FAQ schlägt vor, bei 429-Fehlern zu warten, Anbieter oder Modelle 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 Rückfall auf local eine gültige Debugging-Maßnahme ist, wenn die Sandbox-Konfiguration in Frage steht.

Bei Gateway-Problemen hebt der Messaging-Leitfaden Whitelists und Paarung als sichere Standards hervor, was bedeutet, dass viele „Bot ist still"-Vorfälle tatsächlich Autorisierung sind, die ihre Arbeit verrichten.

Referenzen