Skip to main content

🚀 Kompletter Einsteiger-Guide für Hermes Agent (hermes-ai.net)

Was ist Hermes Agent?

Hermes Agent ist ein Open-Source-KI-Agent von Nous Research (MIT-Lizenz). Er ist weder ein reiner Coding-Copilot noch ein simpler Chatbot, sondern ein autonomer, selbst-verbessernder Agent, der mit der Zeit klĂĽger wird.

ℹ️ Wichtig zu wissen: hermes-ai.net ist eine inoffizielle, unabhängige Community-Seite mit lokalisierten Docs (u.a. auf Deutsch). Die offizielle Software und Dokumentation kommen von Nous Research (hermes-agent.nousresearch.com bzw. GitHub).

Kernmerkmale auf einen Blick

Feature Beschreibung
đź§  Selbstlernender Loop Erstellt Skills aus Erfahrung, verbessert sie im Betrieb, baut ein Modell von dir ĂĽber Sessions hinweg
đź’¬ 15+ Messaging-Plattformen Telegram, Discord, Slack, WhatsApp, Signal, Matrix, E-Mail, SMS u.v.m.
🛠️ 47 eingebaute Tools Websuche, Dateioperationen, Terminal-Befehle
🔌 MCP-Integration Bindet beliebige Model-Context-Protocol-Server ein
⏰ Cron-Automationen Geplante Aufgaben, Ergebnis an jeden Kanal
🖥️ 6 Runtime-Backends local, Docker, SSH, Daytona, Singularity, Modal

⚡ Schnellstart – in ~60 Sekunden startklar

Voraussetzungen

  • Betriebssystem: Linux, macOS oder WSL2 unter Windows
  • Modell: Ein LLM mit groĂźem Kontextfenster empfohlen
  • API-Key: Bereithalten fĂĽr deinen Anbieter (oder ein OpenAI-kompatibler Endpoint)

Schritt 1 – Installation (Linux / macOS / WSL2)

# Installer herunterladen
curl -fsSLO https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh

# Skript ANSCHAUEN, bevor du es ausfĂĽhrst (Sicherheits-Best-Practice!)
less install.sh

# AusfĂĽhren
bash install.sh

Danach Shell neu laden:

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

🪟 Windows-Nutzer: Der empfohlene Weg ist WSL2. Installiere WSL2, öffne ein Ubuntu/WSL-Terminal und führe dort den Linux-Befehl aus. Das erspart dir viele Abhängigkeits- und Automatisierungsprobleme.

Schritt 2 – Modell konfigurieren

hermes model    # LLM-Anbieter und Modell wählen
hermes tools    # aktivierte Tools einstellen
hermes setup    # kompletter Setup-Assistent

Bei hermes model wählst du die Verbindungsart:

  • OAuth-Login
  • API-Key
  • Custom OpenAI-kompatibler Endpoint (Base-URL, API-Key, Modellname, Kontextfenster eingeben)

đź’ˇ Du kannst hermes model jederzeit erneut ausfĂĽhren, um das Modell zu wechseln.

Schritt 3 – Loslegen und Chatten

hermes

Es erscheint ein Willkommens-Banner mit gewähltem Modell, Tools und Skills. Dann einfach tippen:

> Was kannst du gerade fĂĽr mich tun?

🎯 Die wichtigsten Workflows

Hermes das Terminal nutzen lassen

> Prüfe die Festplattennutzung und liste die fünf größten Verzeichnisse.

Hermes führt die Befehle aus, erklärt die Ergebnisse und untersucht bei Bedarf weiter.

Slash-Befehle (im Chat / tippen)

Befehl Funktion
/help Alle Befehle anzeigen
/tools VerfĂĽgbare Tools auflisten
/model Modell interaktiv wechseln
/skills Skills anzeigen/verwalten
/save Aktuelle Konversation speichern

NĂĽtzliche TastenkĂĽrzel

  • Mehrzeilige Eingabe: Alt+Enter oder Ctrl+J (fĂĽr Code, Logs, lange Prompts)
  • Aufgabe unterbrechen: Einfach neue Nachricht senden oder Ctrl+C
  • Session fortsetzen:
    hermes --continue    # letzte Session fortsetzen
    hermes -c            # Kurzform
    

đź”§ Erweiterte Nutzung

Sandboxed Terminal (mehr Isolation)

hermes config set terminal.backend docker
hermes config set terminal.backend ssh

Messaging-Plattformen anbinden

hermes gateway setup

Danach erreichst du Hermes ĂĽber Telegram, Discord, WhatsApp, Signal, E-Mail, Home Assistant u.v.m.

Sprachmodus (Voice)

pip install "hermes-agent[voice]"
pip install faster-whisper    # optional: lokale Spracherkennung

Im CLI aktivieren:

/voice on
  • Ctrl+B zum Aufnehmen
  • /voice tts lässt Hermes Antworten vorlesen

Skills durchsuchen & installieren

⚠️ Sicherheit: Prüfe Skills von Dritten immer vor der Installation – du siehst so, welche Tools und Daten sie nutzen. Community-Skills findest du auf agentskills.io.

MCP-Server verbinden

Bearbeite ~/.hermes/config.yaml:

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

In Editoren nutzen (ACP-Server)

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

đź“‹ Befehls-Referenz (Cheat Sheet)

Befehl Beschreibung
hermes Chat starten
hermes model LLM-Anbieter/Modell wählen
hermes tools Tools konfigurieren
hermes setup Kompletter Setup-Assistent
hermes doctor Installation/Konfiguration diagnostizieren
hermes update Auf neueste Version aktualisieren
hermes gateway Messaging-Gateway starten/konfigurieren
hermes --continue Vorherige Session fortsetzen

âś… Empfohlene Reihenfolge zum Einstieg

  1. Installieren → install.sh ausführen
  2. Modell einrichten → hermes setup durchlaufen
  3. Ersten Chat starten → hermes und eine echte Aufgabe stellen
  4. Slash-Befehle erkunden → mit /help beginnen
  5. Bei Problemen → hermes doctor ausführen
  6. Nächste Ebene → Gateway (Messaging), Skills und MCP-Server ergänzen

  • Community-Guide (Deutsch): hermes-ai.net/de/docs/quickstart/
  • Offizielle Docs: hermes-agent.nousresearch.com/docs
  • GitHub (101K+ Stars): github.com/NousResearch/hermes-agent
  • Community-Skills: agentskills.io
  • Reddit: r/hermesagent