DEV Community

Cover image for Hermes Agent nutzen: Eine Anleitung
Emre Demir
Emre Demir

Posted on • Originally published at apidog.com

Hermes Agent nutzen: Eine Anleitung

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.

Testen Sie Apidog noch heute

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:

  • Erinnert sich — Speichert Konversationen, Entscheidungen und von Ihnen geschriebenen Code
  • Lernt — Erstellt wiederverwendbare Fähigkeiten aus wiederholten Aufgaben
  • Multi-Plattform — Chatten über CLI, Telegram, Discord, Slack, WhatsApp oder IDE
  • Selbst gehostet — Läuft auf Ihrem Laptop, einem 5-Dollar-VPS oder in der Cloud-Infrastruktur
  • Modell-agnostisch — Nutzen Sie über 200 Modelle über OpenRouter oder direkte Anbieter
  • Erweiterbar — Plugin-System für benutzerdefinierte Tools und Befehle

Wer sollte Hermes nutzen:

  • Entwickler, die einen KI-Paarprogrammierer wünschen, der ihre Codebasis kennt
  • Teams, die einen gemeinsamen KI-Assistenten mit Mehrbenutzerunterstützung benötigen
  • Power-User, die eine 24/7-Agentenautomatisierung über Cron-Scheduling wünschen
  • Forscher, die benutzerdefinierte KI-Modelle mit Trajektorien-Daten trainieren

Installation: Schritt für Schritt

Voraussetzungen

  • Betriebssystem: macOS, Linux oder Windows (WSL empfohlen)
  • Python: 3.10 oder höher
  • Git: Zum Klonen von Repositories
  • API-Schlüssel: OpenRouter, Anthropic, OpenAI oder ein anderer LLM-Anbieter

Schnellinstallation (Empfohlen)

Installieren Sie Hermes mit einem Befehl:

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

Das Skript erledigt:

  1. Klonen des Hermes-Repos
  2. Installation von uv (schneller Python-Paketmanager)
  3. Erstellen einer virtuellen Umgebung
  4. Installation aller Abhängigkeiten
  5. Hinzufügen von Hermes zum PATH

Shell nach der Installation neu laden:

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

Funktion prüfen:

hermes --version

Sie sollten z.B. Hermes Agent v0.5.0 sehen.

Manuelle Installation (Für Entwickler)

Für mehr Kontrolle:

# Repository klonen
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# uv installieren (falls nicht vorhanden)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Virtuelle Umgebung anlegen & aktivieren
uv venv venv --python 3.11
source venv/bin/activate  # Linux/macOS
# oder
.\venv\Scripts\activate  # Windows

# Hermes mit allen Features installieren
uv pip install -e ".[all,dev]"

# Tests ausführen
python -m pytest tests/ -q

Installation mit RL-Trainingsunterstützung

Für eigenes Modell-Training:

# Atropos-Submodul initialisieren
git submodule update --init tinker-atropos

# Mit Trainings-Abhängigkeiten installieren
uv pip install -e "./tinker-atropos"

Erstmalige Einrichtung und Konfiguration

Setup-Assistenten ausführen

Führen Sie das interaktive Setup aus:

hermes setup
  1. LLM-Anbieter wählen
  2. API-Schlüssel eingeben (wird in ~/.hermes/.env gespeichert)
  3. Speicher konfigurieren
  4. Terminal-Backend wählen
  5. Optional: Gateways wie Telegram/Discord/Slack aktivieren

Manuelle Konfiguration

hermes config edit

Oder per CLI:

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

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

# API-Schlüssel setzen
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...

Speicherort der Konfigurationsdatei

~/.hermes/
├── config.yaml      # Hauptkonfiguration
├── .env             # API-Schlüssel (vertraulich)
├── memory/          # Speicherdaten
├── skills/          # Fähigkeiten
└── plugins/         # Plugins

Ihre Einrichtung überprüfen

hermes doctor
  • Konfiguration und API-Keys prüfen
  • Speicherstatus
  • Gateway-Status
  • Backend-Verbindung

Ihren LLM-Anbieter auswählen

Hermes unterstützt über 200 Modelle bei verschiedenen Anbietern.

OpenRouter (Empfohlen für Einsteiger)

Vorteil: Ein API-Key, Zugriff auf 200+ Modelle.

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

Beispiele für Modelle:

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

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

OpenAI Direkt

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

Lokale Modelle (Ollama)

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

Modellkonfiguration Beispiele

Intelligentes Routing:

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

Kostenlimit:

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

Grundlegende Nutzung: CLI-Modus

Hermes starten

hermes

Willkommensbanner erscheint, direkt loschatten.

Grundlegende Befehle

Natürlich chatten:

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

Slash-Befehle:

> /help
> /skills
> /memory
> /config
> /clear
> /history

Dateibasierte Aufgaben:

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

Terminalbefehle ausführen:

> Run: npm install && npm run build

Hermes fragt vor Ausführung nach Bestätigung.

Persistente Shell

> cd /my/project && source venv/bin/activate
> python src/main.py

Shell-Zustand bleibt über mehrere Befehle erhalten.

Arbeiten mit Dateien

Datei einsehen:

> Zeige mir den Inhalt von config.yaml

Datei bearbeiten:

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

Neue Datei anlegen:

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

Mehrstufige Workflows

> 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 führt die Schritte nacheinander aus und fragt ggf. nach Ihrer Bestätigung.

Messaging-Gateway: Telegram, Discord, Slack

Hermes kann als Bot auf mehreren Plattformen laufen. So geht die Einrichtung:

Telegram

  • Mit @botfather /newbot ausführen, Token kopieren
  • Token setzen: 
    hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
  • Gateway starten: 
    hermes gateway setup telegram
hermes gateway start
  • Im Chat /start senden und nutzen

Discord

  • App unter https://discord.com/developers/applications erstellen, Bot-Token kopieren
  • Bot per OAuth2 zum Server einladen
  • Token setzen und starten: 
    hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
hermes gateway setup discord
hermes gateway start
  • Im Server oder per DM nutzen

Slack

  • App unter https://api.slack.com/apps erstellen, Bot-Rechte vergeben
  • Installieren, Token kopieren
  • Konfiguration: 
    hermes config set SLACK_BOT_TOKEN xoxb-...
hermes gateway setup slack
hermes gateway start

Multi-Plattform-Nutzung

hermes gateway start --all

Konversationsstatus bleibt über Plattformen synchron.

IDE-Integration: VS Code, JetBrains

Hermes kann per ACP in Ihren Editor eingebunden werden.

VS Code

  • ACP-Erweiterung installieren ("Agent Communication Protocol")
  • Backend starten: 
    hermes acp start
  • Hermes in der ACP-Sidebar auswählen, chatten

JetBrains (IntelliJ, PyCharm, ...)

  • ACP-Plugin installieren
  • Backend starten: 
    hermes acp start
  • In Einstellungen → Tools → KI-Agenten Hermes als Backend eintragen

Zed Editor

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

Speicher- und Lernsystem

Nutzen Sie Hermes' Speicher gezielt für produktive Workflows:

Speichertypen

  • Episodisch: Einzelne Chats und Sessions (durchsuchbar) 
    > /memory search "Datenbankmigration"
  • Semantisch: Wissensgraph zu Projekten und Präferenzen 
    > /memory projects
  • Prozedural: Wiederverwendbare Workflows/Fähigkeiten 
    > /skills list

Sitzungssuche

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

Hermes findet relevante Abschnitte und fasst zusammen.

Speicherhinweise

[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

  • Gateway-Komprimierung bei 85 %
  • Agenten-Komprimierung bei 50 % (anpassbar)

Lange Konversationen ohne Kontextverluste.

Export und Sicherung

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

Fähigkeiten und Plugins

Was sind Fähigkeiten?

Workflows, die Sie mehrfach automatisiert ausführen lassen:

  • code_review — Code prüfen
  • debug_session — Debugging
  • api_tester — APIs testen
  • git_workflow — Git-Handling
  • documentation — Docs generieren

Fähigkeiten durchsuchen & installieren

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

Eigene Skills schreiben

# ~/.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):
        # Eigene Logik hier
        return "Skill executed successfully"

Plugin-System

# ~/.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"}
  • Tools — Neue Agentenfunktionen
  • Befehle — Slash-Befehle hinzufügen
  • Hooks — Events abfangen

Erweiterte Funktionen

Cron-Planung

> Richten Sie einen täglichen Digest meiner GitHub-Benachrichtigungen um 9 Uhr ein

Oder direkt in config.yaml:

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

Subagenten-Delegation

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

Subagenten werden für parallele Aufgaben erzeugt.

Sprachmodus

hermes --voice
  • Sprachnotizen in Telegram/Discord: Nachricht senden, Hermes transkribiert und antwortet
  • Discord-Sprachkanal: Hermes kann beitreten

Browser-Steuerung

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

MCP-Integration

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

Worktree-Modus

hermes -w

Mehrere Agenten können gleichzeitig am selben Repo arbeiten.

Andere Agenten innerhalb von Hermes ausführen

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

Fehlerbehebung

Häufige Probleme

API-Schlüssel nicht gefunden:

hermes config get OPENROUTER_API_KEY
hermes config set OPENROUTER_API_KEY sk-or-...

Modell nicht verfügbar:

hermes models list
hermes config set model anthropic/claude-opus-4

Gateway konnte nicht gestartet werden:

hermes gateway status
hermes gateway stop
hermes gateway start

Speicherbeschädigung erkannt:

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

Hilfe erhalten

> /help
hermes logs tail --follow
hermes doctor

Häufig gestellte Fragen (FAQ)

Wie viel kostet der Betrieb von Hermes?

  • Leichte Nutzung: 5-15 $/Monat mit OpenRouter
  • Moderate Nutzung: 20-50 $/Monat
  • Intensive Nutzung: 50-200 $/Monat

Mit lokalen Modellen (Ollama) kostenlos, Hardware erforderlich.

Kann Hermes rund um die Uhr laufen?

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

Ist Hermes für den Unternehmenseinsatz geeignet?

  • Mehrbenutzer-Gateway-Modus
  • PII-Redaktion
  • Lieferkettensicherheit
  • Self-Hosting
  • Audit-Logs

Wie migriere ich von OpenClaw?

hermes claw migrate --dry-run
hermes claw migrate
hermes doctor

Kann ich Hermes ohne Internet nutzen?

curl -fsSL https://ollama.ai/install.sh | sh
ollama pull qwen2.5-coder:32b
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?

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 für die Sie Berechtigung erteilt haben. Standardmäßig kein Dateisystemzugriff.

💡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.

Top comments (0)