Blog

Hermes Agent nutzen: Eine Anleitung

Ashley Innocent

Ashley Innocent

30 March 2026

Hermes Agent nutzen: Eine Anleitung

Apidog für Unternehmen

On-Premises-Bereitstellung

SSO & RBAC

SOC 2 konform

Apidog Enterprise entdecken

TL;DR: Hermes Agent ist ein quelloffener KI-Assistent, der sich merkt, was er lernt, und mit der Zeit immer intelligenter wird. Installieren Sie ihn mit einem einzigen Befehl, konfigurieren Sie Ihren LLM-Anbieter und beginnen Sie, über CLI, Telegram, Discord oder Ihre IDE zu chatten. Dieser Leitfaden behandelt die Installation, Einrichtung, tägliche Nutzung, erweiterte Funktionen und wie Sie das Beste aus Hermes herausholen können.

Button

Was ist Hermes Agent?

Hermes Agent ist ein persönlicher KI-Assistent, der von NousResearch entwickelt wurde und rund um die Uhr läuft, sich alles merkt, was er lernt, und mit der Zeit immer leistungsfähiger wird. Im Gegensatz zu ChatGPT oder Claude, die jede Konversation neu beginnen, erstellt Hermes ein persistentes Modell Ihrer Arbeit, Projekte und Präferenzen.

Hauptfunktionen:

Wer sollte Hermes nutzen:

Installation: Schritt für Schritt

Voraussetzungen

Schnellinstallation (Empfohlen)

Der schnellste Weg, Hermes zu installieren:

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

Dieses Skript:

  1. Klont das Hermes-Repository
  2. Installiert uv (schneller Python-Paketmanager)
  3. Erstellt eine virtuelle Umgebung
  4. Installiert alle Abhängigkeiten
  5. Fügt Hermes zu Ihrem PATH hinzu

Nach der Installation laden Sie Ihre Shell neu:

source ~/.bashrc  # Für bash
source ~/.zshrc   # Für zsh

Installation überprüfen:

hermes --version

Sie sollten so etwas wie Hermes Agent v0.5.0 sehen.

Manuelle Installation (Für Entwickler)

Wenn Sie mehr Kontrolle über die Installation wünschen:

# Clone the repository
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create and activate virtual environment
uv venv venv --python 3.11
source venv/bin/activate  # Linux/macOS
# or
.\venv\Scripts\activate  # Windows

# Install Hermes with all features
uv pip install -e ".[all,dev]"

# Run tests to verify installation
python -m pytest tests/ -q

Installation mit RL-Trainingsunterstützung

Wenn Sie planen, benutzerdefinierte Modelle zu trainieren:

# Initialize the Atropos submodule
git submodule update --init tinker-atropos

# Install with training dependencies
uv pip install -e "./tinker-atropos"

Erstmalige Einrichtung und Konfiguration

Setup-Assistenten ausführen

Erstbenutzer sollten das interaktive Setup ausführen:

hermes setup

Der Assistent führt Sie durch:

  1. Auswahl Ihres LLM-Anbieters — OpenRouter, Anthropic, OpenAI usw.
  2. API-Schlüssel festlegen — Sicher gespeichert in ~/.hermes/.env
  3. Speicher konfigurieren — Persistente Speicher aktivieren/deaktivieren
  4. Terminal-Backend — Lokale, Docker-, SSH- oder Cloud-Optionen
  5. Gateway-Einrichtung — Telegram-, Discord-, Slack-Integration (optional)

Manuelle Konfiguration

Wenn Sie eine manuelle Einrichtung bevorzugen, bearbeiten Sie die Konfigurationsdatei:

hermes config edit

Oder verwenden Sie CLI-Befehle:

# Standardmodell festlegen
hermes config set model anthropic/claude-opus-4

# Terminal-Backend festlegen
hermes config set terminal.backend local

# API-Schlüssel festlegen (wird automatisch in ~/.hermes/.env gespeichert)
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...

Speicherort der Konfigurationsdatei

Hermes speichert die Konfiguration in ~/.hermes/:

~/.hermes/
├── config.yaml      # Hauptkonfiguration
├── .env             # API-Schlüssel (nicht teilen!)
├── memory/          # Permanenter Speicherspeicher
├── skills/          # Installierte Fähigkeiten
└── plugins/         # Benutzerdefinierte Plugins

Ihre Einrichtung überprüfen

Führen Sie den Health Check aus:

hermes doctor

Dies prüft:

Ihren LLM-Anbieter auswählen

Hermes unterstützt über 200 Modelle über mehrere Anbieter. So wählen Sie aus:

OpenRouter (Für Anfänger empfohlen)

Warum: Ein einziger API-Schlüssel ermöglicht den Zugriff auf über 200 Modelle. Kostenloser Tarif verfügbar.

Einrichtung:

hermes config set model openrouter
hermes config set OPENROUTER_API_KEY sk-or-...

Beliebte Modelle auf OpenRouter:

Modell

Anwendungsfall

Kosten

anthropic/claude-opus-4

Komplexes Coding, Argumentation

$$$

anthropic/claude-sonnet-4

Ausgewogene Leistung

$$

openai/gpt-4o

Allgemeiner Zweck

$$

google/gemini-pro-1.5

Lange Kontextfenster

$

meta/llama-3-70b

Open Source, schnell

$

Anthropic Direkt

Warum: Erstklassiges Coding und Argumentation. Direkter Zugriff auf die neuesten Claude-Modelle.

Einrichtung:

hermes config set model anthropic
hermes config set ANTHROPIC_API_KEY sk-ant-...
hermes config set model.default claude-opus-4

OpenAI Direkt

Warum: GPT-4o und o1 Modelle für spezifische Anwendungsfälle.

Einrichtung:

hermes config set model openai
hermes config set OPENAI_API_KEY sk-...

Lokale Modelle (Ollama)

Warum: Kostenlos, privat, offline-fähig.

Einrichtung:

# Install Ollama first: https://ollama.ai
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

Beispiele für die Modellkonfiguration

Intelligentes Routing (teures Modell für komplexe Aufgaben, günstig für einfache):

model:
  provider: openrouter
  default: anthropic/claude-opus-4
  fallback:
    - anthropic/claude-haiku-4-5
    - openai/gpt-4o-mini

Kostenkontrolle (Ausgabenlimits festlegen):

model:
  budget:
    daily_limit: 5.00  # USD
    monthly_limit: 100.00

Grundlegende Nutzung: CLI-Modus

Hermes starten

Der einfachste Weg, Hermes zu nutzen:

hermes

Sie sehen ein Willkommensbanner und können sofort mit dem Chatten beginnen.

Grundlegende Befehle

Innerhalb von Hermes können Sie:

Natürlich chatten:

> Hey, kannst du mir helfen, eine Python-Funktion zum Parsen von JSON zu schreiben?

Slash-Befehle verwenden:

> /help          # Alle Befehle anzeigen
> /skills        # Verfügbare Fähigkeiten durchsuchen
> /memory        # Speicherstatus anzeigen
> /config        # Konfiguration anzeigen/bearbeiten
> /clear         # Aktuelle Konversation löschen
> /history       # Vergangene Konversationen anzeigen

Dateibasierte Aufgaben geben:

> Sieh dir die Datei ./src/main.py an und refaktoriere die Datenbankverbindung

Terminalbefehle ausführen:

> Run: npm install && npm run build

Hermes wird vor der Ausführung eines Befehls um Bestätigung bitten.

Persistente Shell

Im Gegensatz zu anderen KI-Tools behält Hermes den Shell-Zustand über Befehle hinweg bei:

> cd /my/project && source venv/bin/activate
> python src/main.py  # Runs in the same shell session

Die virtuelle Umgebung bleibt für nachfolgende Befehle aktiv.

Arbeiten mit Dateien

Dateien lesen:

> Zeige mir den Inhalt von config.yaml

Dateien bearbeiten:

> Ändere in main.py den Datenbankport von 5432 auf 5433

Neue Dateien erstellen:

> Erstelle eine neue Datei namens utils.py mit Hilfsfunktionen für die Datumsformatierung

Mehrstufige Workflows

Hermes zeichnet sich durch komplexe, mehrstufige Aufgaben aus:

> Ich muss meiner Flask-App eine Benutzerauthentifizierung hinzufügen. Kannst du:
> 1. Die Datenbankmodelle einrichten
> 2. Login-/Logout-Endpunkte erstellen
> 3. JWT-Token-Generierung hinzufügen
> 4. Tests für den Authentifizierungsablauf schreiben

Hermes wird jeden Schritt abarbeiten und dabei um Bestätigung bitten.

Messaging-Gateway: Telegram, Discord, Slack

Hermes kann als Bot auf mehreren Messaging-Plattformen ausgeführt werden, sodass Sie von Ihrem Telefon oder Team-Chat aus mit ihm interagieren können.

Telegram-Einrichtung

1. Bot erstellen:

2. Hermes konfigurieren:

hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

3. Gateway starten:

hermes gateway setup telegram
hermes gateway start

4. Mit dem Chatten beginnen:

Discord-Einrichtung

1. Eine Discord-Anwendung erstellen:

2. Bot zu Ihrem Server einladen:

3. Hermes konfigurieren:

hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
hermes gateway setup discord
hermes gateway start

4. In Discord verwenden:

Slack-Einrichtung

1. Eine Slack-App erstellen:

2. Im Workspace installieren und Token kopieren

3. Hermes konfigurieren:

hermes config set SLACK_BOT_TOKEN xoxb-...
hermes gateway setup slack
hermes gateway start

Multi-Plattform-Nutzung

Sie können mehrere Gateways gleichzeitig ausführen:

hermes gateway start --all

Hermes synchronisiert den Konversationsstatus über alle Plattformen hinweg.

IDE-Integration: VS Code, JetBrains

Hermes integriert sich über das Agent Communication Protocol (ACP) direkt in Ihren Code-Editor.

VS Code-Integration

1. Die ACP-Erweiterung installieren:

2. Hermes als Backend konfigurieren:

hermes acp start

3. In VS Code verwenden:

JetBrains-Integration (IntelliJ, PyCharm usw.)

1. Das ACP-Plugin installieren:

2. Hermes ACP-Server starten:

hermes acp start

3. In JetBrains konfigurieren:

Zed Editor

Zed verfügt über native ACP-Unterstützung:

1. In den Zed-Einstellungen konfigurieren:

{
  "agent": {
    "provider": "acp",
    "endpoint": "hermes"
  }
}

2. Hermes starten:

hermes acp start

Speicher- und Lernsystem

Hermes' Superkraft ist seine Speicherarchitektur. So nutzen Sie sie effektiv.

Speichertypen

Episodischer Speicher: Speichert spezifische Konversationen und Sitzungen. Sie können frühere Interaktionen suchen und abrufen.

> /memory search "Datenbankmigration"

Semantischer Speicher: Baut Wissensgraphen über Ihre Projekte, Präferenzen und Muster auf.

> /memory projects

Prozeduraler Speicher (Fähigkeiten): Erstellt wiederverwendbare Fähigkeiten aus wiederholten Aufgaben.

> /skills list

Sitzungssuche

Finden Sie relevante frühere Arbeiten mit semantischer Suche:

> /memory search "Wie sind wir letzte Woche mit dem JWT-Ablauf umgegangen?"

Hermes durchsucht Ihre gesamte Historie und fasst die Ergebnisse zusammen.

Speicherhinweise

Hermes zeigt proaktiv relevante Informationen an:

[Hermes]: Mir ist aufgefallen, dass Sie am Authentifizierungssystem arbeiten. Letzten Dienstag haben Sie
ein Problem mit dem JWT-Ablauf erwähnt. Möchten Sie das noch einmal aufgreifen?

Kontextkomprimierung

Hermes komprimiert den Kontext automatisch, um das Erreichen von Limits zu vermeiden:

Dies ermöglicht unbegrenzte Konversationen ohne manuelle Kontextverwaltung.

Export und Sicherung

Speicher exportieren:

hermes memory export ~/backup/hermes-memory.json

Speicher importieren:

hermes memory import ~/backup/hermes-memory.json

Fähigkeiten und Plugins

Was sind Fähigkeiten?

Fähigkeiten sind wiederverwendbare Workflows, die Hermes ausführen kann. Stellen Sie sie sich als Makros für komplexe Aufgaben vor.

Integrierte Fähigkeiten umfassen:

Fähigkeiten durchsuchen und installieren

Verfügbare Fähigkeiten anzeigen:

> /skills list

Eine Fähigkeit installieren:

> /skills install code_review

Eine Fähigkeit nutzen:

> /skills run code_review ./src/auth.py

Benutzerdefinierte Fähigkeiten

Erstellen Sie benutzerdefinierte Fähigkeiten in ~/.hermes/skills/:

# ~/.hermes/skills/my_skill.py
from hermes.skills import Skill

class MyCustomSkill(Skill):
    name = "my_custom_skill"
    description = "Does something useful"

    def execute(self, context):
        # Ihre Fähigkeiten-Logik hier
        return "Skill executed successfully"

Plugin-System

Plugins erweitern Hermes um benutzerdefinierte Tools, Befehle und Hooks.

Ein Plugin erstellen:

# ~/.hermes/plugins/my_tool.py
from hermes.tools import Tool

class MyCustomTool(Tool):
    name = "my_tool"
    description = "A custom tool for specific tasks"

    def run(self, **kwargs):
        # Tool-Logik hier
        return {"result": "success"}

Plugin-Typen:

Erweiterte Funktionen

Cron-Planung

Automatisierte Aufgaben planen:

# Bitten Sie Hermes, eine geplante Aufgabe zu erstellen
> Richten Sie einen täglichen Digest meiner GitHub-Benachrichtigungen um 9 Uhr ein

Oder manuell in config.yaml konfigurieren:

cron:
  - name: "Daily digest"
    schedule: "0 9 * * *"
    command: "/skills run github_digest"
    model: "anthropic/claude-haiku-4-5"

Subagenten-Delegation

Hermes kann Subagenten für parallele Arbeit erstellen:

> Ich brauche dich, um alle PRs in meinem Repo zu überprüfen und die Änderungen zusammenzufassen

Hermes wird mehrere Subagenten spawnen, um parallel zu arbeiten, und dann die Ergebnisse zusammenfassen.

Sprachmodus

Push-to-Talk in der CLI:

hermes --voice

Sprachnotizen in Telegram/Discord:

Discord-Sprachkanäle:

Browser-Steuerung

Hermes integriert sich mit Browser Use CLI 2.0 für die Webautomatisierung:

> Gehe zu github.com und finde die Top 5 der angesagtesten Python-Repos

Oder verbinden Sie sich live über CDP mit Chrome:

hermes browser connect --cdp

MCP-Integration

Hermes unterstützt Model Context Protocol (MCP) Server:

mcp:
  servers:
    filesystem:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "~/projects"]
    git:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-git"]

Worktree-Modus

Führen Sie Hermes in einem isolierten Git-Worktree aus:

hermes -w

Mehrere Agenten können gleichzeitig und ohne Konflikte an demselben Repo arbeiten.

Andere Agenten innerhalb von Hermes ausführen

Hermes kann andere KI-Agenten als Subagenten ausführen:

> Verwenden Sie claude-code, um diesen Pull-Request zu überprüfen

Dies ist nützlich, um spezialisierte Agenten für spezifische Aufgaben zu nutzen.

Fehlerbehebung

Häufige Probleme

"API-Schlüssel nicht gefunden"

# Überprüfen, ob der API-Schlüssel gesetzt ist
hermes config get OPENROUTER_API_KEY

# Bei Bedarf neu setzen
hermes config set OPENROUTER_API_KEY sk-or-...

"Modell nicht verfügbar"

# Verfügbare Modelle auflisten
hermes models list

# Modell ändern
hermes config set model anthropic/claude-opus-4

"Gateway konnte nicht gestartet werden"

# Gateway-Status überprüfen
hermes gateway status

# Gateway neu starten
hermes gateway stop
hermes gateway start

"Speicherbeschädigung erkannt"

# Aktuellen Speicher sichern
hermes memory export ~/backup/memory-backup.json

# Speicher zurücksetzen
hermes memory reset

# Bei Bedarf erneut importieren
hermes memory import ~/backup/memory-backup.json

Hilfe erhalten

Integrierte Hilfe:

> /help

Protokolle anzeigen:

hermes logs tail --follow

Diagnose ausführen:

hermes doctor

Häufig gestellte Fragen (FAQ)

Wie viel kostet der Betrieb von Hermes?

Hermes selbst ist kostenlos. Sie zahlen nur für die LLM-Nutzung. Typische Kosten:

Die Verwendung lokaler Modelle (Ollama) ist kostenlos, erfordert jedoch Hardware.

Kann Hermes rund um die Uhr laufen?

Ja. Stellen Sie Hermes auf einem VPS bereit:

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

# Als systemd-Dienst ausführen
hermes service install
hermes service start

Ist Hermes für den Unternehmenseinsatz geeignet?

Ja. Unternehmensfunktionen umfassen:

Wie migriere ich von OpenClaw?

hermes claw migrate --dry-run  # Vorschau
hermes claw migrate            # Vollständige Migration
hermes doctor                  # Überprüfen

Kann ich Hermes ohne Internet nutzen?

Ja, mit lokalen Modellen:

# Ollama installieren
curl -fsSL https://ollama.ai/install.sh | sh

# Ein Modell herunterladen
ollama pull qwen2.5-coder:32b

# Hermes konfigurieren
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

Was ist der Unterschied zwischen Hermes und ChatGPT?

Funktion

Hermes

ChatGPT

Speicher

Persistent, durchsuchbar

Nur Sitzungsbasiert

Bereitstellung

Selbst gehostet, 24/7

Nur Cloud

Modellwahl

Über 200 Modelle

Nur GPT

Erweiterbarkeit

Plugins, Fähigkeiten

Begrenzt

Kosten

Nur für Nutzung bezahlen

Abonnement

Datenschutz

Sie kontrollieren Daten

OpenAI speichert Daten

Wie sichere ich meine Hermes-Daten?

# Alles exportieren
hermes export --all ~/backup/hermes-full-backup.tar.gz

Kann Hermes auf meine lokalen Dateien zugreifen?

Hermes kann nur auf Dateien zugreifen, die Sie explizit referenzieren, oder auf Verzeichnisse, für die Sie die Berechtigung erteilt haben. Standardmäßig hat es keinen Zugriff auf Ihr Dateisystem.

💡
Möchten Sie APIs als Teil Ihres KI-gestützten Entwicklungs-Workflows testen? Schauen Sie sich Apidog an, die All-in-One-API-Entwicklungsplattform zum Entwerfen, Testen und Dokumentieren von APIs.
Button

Praktizieren Sie API Design-First in Apidog

Entdecken Sie eine einfachere Möglichkeit, APIs zu erstellen und zu nutzen

Kostenlos registrierenDownload