Hermes Agent installieren: Anleitung für Anfänger

Du hast von Hermes Agent gehört, willst ihn ausprobieren und sitzt jetzt vor deinem Terminal. Und fragst dich:

Wo fange ich an?

Kein Wunder. Hermes Agent zählt mittlerweile zu den populärsten selbstverbessernden KI-Agenten. Über 177.000 GitHub-Stars, eine breite Community und eine fast schon unverschämte Anzahl an Integrationen. Aber eine vernünftige Schritt-für-Schritt-Anleitung auf Deutsch? Die musst du erst mal finden.

Hermes Agent läuft auf macOS, Linux-Servern und sogar auf Termux unter Android. Die Installation ist deutlich angenehmer als bei den meisten Agent-Frameworks. Aber es gibt ein paar Stolperfallen, die dir keiner sagt, wenn du einfach den Einzeiler aus der Dokumentation kopierst.

In dieser Anleitung zeige ich dir Schritt für Schritt, wie du Hermes Agent installierst, einen LLM-Provider verbindest und deinen ersten Channel zum Laufen bringst. Egal ob du macOS, Linux oder Windows nutzt.

Was ist Hermes Agent eigentlich?

Kurz zur Einordnung, falls du nicht genau weißt, worum es geht.

Hermes Agent ist ein Open-Source-KI-Agent von Nous Research, veröffentlicht unter MIT-Lizenz. Die Tagline „The Agent That Grows With You“ trifft den Kern. Hermes lernt mit der Nutzung dazu, behält Wissen über Sessions hinweg und baut mit der Zeit ein tieferes Bild deiner Arbeitsweise auf.

Und nein.

Hermes Agent ist kein weiteres Coding-Tool wie Claude Code oder GitHub Copilot. Hermes ist ein universeller persönlicher KI-Agent. Das heißt, du kannst ihn über Telegram, Discord, Slack, WhatsApp, Signal, E-Mail, Microsoft Teams, Home Assistant oder direkt über die Kommandozeile nutzen.

Du fragst ihn per Nachricht, etwas zu tun, und er erledigt es. Recherche, Zusammenfassungen, Web-Suchen, Bildgenerierung, Browser-Steuerung. Wenn du vor allem Coding-Unterstützung suchst, ist ein Vergleich der KI-Coding-Tools vielleicht hilfreicher. Hermes punktet vor allem dort, wo du langfristig mit einem Agent zusammenarbeiten willst, der dich kennt.

Im Prinzip ist es ein persönlicher KI-Assistent, der mit der Zeit wirklich besser wird.

Was du für die Hermes-Agent-Installation brauchst

Prüfe kurz diese Punkte, bevor du anfängst.

Python 3.11 oder neuer. Das ist die wichtigste Voraussetzung. Wenn du nicht weißt, welche Version bei dir installiert ist, öffne dein Terminal und tippe python --version oder python3 --version. Steht da etwas unter 3.11? Dann musst du aktualisieren.

Auf macOS geht das am einfachsten über Homebrew, auf Linux über den Paketmanager deiner Distribution.

brew install python@3.11

Dein Betriebssystem. Hermes Agent läuft auf

• macOS 13 (Ventura) oder neuer
• Linux mit glibc 2.31+
• Windows 10/11 (nativ oder über WSL2)
• Android über Termux (ja, ernsthaft, läuft erstaunlich gut)

Ein Account bei einem LLM-Anbieter (optional, aber empfohlen). Du brauchst Zugang zu einem KI-Modell. Hermes unterstützt über 30 Anbieter, darunter Anthropic Claude, OpenAI, Google Gemini, OpenRouter und das Nous Portal. Alternativ kannst du Ollama für lokale Modelle nutzen. Das ist komplett kostenlos. Dazu später mehr.

Mehr brauchst du nicht. Los geht’s!

Hermes Agent installieren auf macOS und Linux

Die schnellste Variante ist der offizielle Einzeiler. Öffne dein Terminal und füge folgenden Befehl ein:

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

Das Skript prüft deine Python-Installation, lädt Hermes Agent über uv (einen schnellen Python-Package-Manager) herunter, legt eine virtuelle Umgebung an und konfiguriert den Gateway-Dienst. Der Gateway läuft danach als Hintergrundprozess und kümmert sich um die Kommunikation mit den Channels.

Wenn du (verständlicherweise) ungern ein Skript aus dem Internet blind ausführst, gibt es eine Alternative über pip.

pip install hermes-agent
hermes setup

Beide Wege führen zum gleichen Ergebnis. Der pip-Weg gibt dir nur etwas mehr Kontrolle darüber, was passiert. Falls du Conda statt pip nutzt, funktioniert das genauso.

Sobald die Installation durch ist, kannst du den Einrichtungsassistenten starten.

hermes setup --portal

Der Portal-Modus ist die einfachste Variante für den Einstieg. Eine OAuth-Anmeldung beim Nous Portal setzt den Standard-Provider und schaltet alle vier Tool-Gateway-Tools frei (Web-Suche, Bildgenerierung, Text-to-Speech und Cloud Browser). Wenn du lieber Claude oder OpenAI direkt nutzen willst, kannst du den Provider später über hermes model umstellen.

Hermes Agent installieren unter Windows

Hier hat Hermes einen Vorteil gegenüber den meisten Agent-Frameworks.

Hermes Agent läuft unter Windows nativ. Du brauchst kein WSL2 (außer du willst). Lade dir Python 3.11+ von python.org herunter und installiere es. Achte darauf, dass „Add Python to PATH“ während der Installation angehakt ist.

Danach öffnest du PowerShell oder die Eingabeaufforderung und installierst Hermes über pip.

pip install hermes-agent
hermes setup --portal

Native CLI, Gateway, TUI und alle Tools funktionieren unter Windows. Die Channel-Integrationen (Telegram, Discord etc.) laufen ebenfalls problemlos.

Wenn du WSL2 bevorzugst, weil du eh schon Linux-Workflows hast, funktioniert auch das. Öffne PowerShell als Administrator

wsl --install

Danach startest du deinen Rechner neu und öffnest das WSL-Terminal (standardmäßig Ubuntu). Ab hier ist die Installation identisch mit Linux.

Hermes Agent einrichten (LLM-Provider und Modell wählen)

Nach der Installation hast du zwei Dinge zu tun. Einen LLM-Provider verbinden und ein Modell auswählen. Der Befehl hermes setup --portal macht das in einem Schritt mit dem Nous Portal als Provider. Wer einen anderen Provider will, nutzt den interaktiven Wizard hermes model, der OAuth-Flows, API-Keys und Endpoints für über 30 unterstützte Anbieter abdeckt.

hermes model

Anthropic Claude konfigurieren

Wenn du schon einen Anthropic-Account hast, ist Claude die einfachste Wahl. Im hermes model-Wizard wählst du Anthropic als Provider aus und entscheidest dich zwischen OAuth (für Claude Pro/Max-Abos) oder direkter API-Key-Eingabe.

Bei OAuth wirst du auf eine Webseite weitergeleitet, loggst dich ein und gibst Hermes die Berechtigung, in deinem Namen Anfragen zu schicken. Fertig. Wenn du den API-Key direkt eingibst, landet er sicher in der Konfiguration unter ~/.hermes/config.json.

OpenAI GPT konfigurieren

Genau das gleiche Spiel für OpenAI. Starte hermes model, wähle OpenAI und gib deinen API-Key ein. Alternativ kannst du den Key als Umgebungsvariable setzen.

export OPENAI_API_KEY="dein-key"
hermes model

Hermes unterstützt GPT-5.5, GPT-5.4, GPT-5-Codex sowie ältere Modelle wie GPT-4.1 und GPT-4o. Welches Modell du nutzen willst, kannst du pro Skill konfigurieren oder als globalen Default setzen.

Lokale Modelle mit Ollama

Die beste Wahl für Datenschutz-bewusste Setups. Lade Ollama von ollama.com herunter, installier ein Modell (z. B. Qwen 2.5 Coder oder Llama 3.3) und verbinde es mit Hermes.

ollama pull qwen2.5-coder:32b
hermes model

Im Wizard wählst du Ollama als Provider und gibst den Endpoint an (Default ist http://localhost:11434). Hermes erkennt automatisch alle Modelle, die du in Ollama installiert hast. GPU-Offloading läuft auf macOS und Linux komplett automatisch. Du musst nichts konfigurieren.

Erste Schritte mit Hermes Agent

Alles eingerichtet? Dann probier es aus.

Der schnellste Weg, Hermes auszuprobieren, ist die Kommandozeile.

hermes chat

Damit landest du in einer interaktiven Session. Frag etwas Einfaches wie „Fasse mir die wichtigsten KI-Nachrichten der letzten Woche zusammen“ und schau, was passiert. Hermes nutzt das konfigurierte Modell, ruft bei Bedarf das Web-Suche-Tool auf und antwortet dir.

Wenn du Multi-Channel-Integration nutzen willst, ist Telegram der einfachste Einstieg. Das Gateway-Setup ist ein interaktiver Wizard, der dich durch alle unterstützten Plattformen führt.

hermes gateway setup

Für Telegram brauchst du einen Bot-Token vom Telegram-BotFather (kostenlos in 2 Minuten erstellt) und gibst den im Wizard ein. Danach schreibst du deinem Hermes-Bot eine Nachricht und der Agent antwortet wie über die Kommandozeile, nur halt via Telegram.

Discord, Slack, Signal, E-Mail, Microsoft Teams und Home Assistant funktionieren analog im selben Wizard. Für WhatsApp und Slack gibt es zusätzlich dedizierte Top-Level-Befehle (hermes whatsapp und hermes slack), die etwas mehr Setup-Optionen bieten.

Häufige Fehler bei der Installation (und wie du sie löst)

Diese Fehler tauchen bei fast jeder ersten Installation auf. Hier die häufigsten Probleme und was du dagegen tun kannst.

„hermes: command not found“

Der Klassiker. Nach der Installation findet dein Terminal den Befehl nicht. Das liegt fast immer am PATH. Schließe das Terminal und öffne es neu. Hilft das nicht, prüfe, ob das pip-User-Bin-Verzeichnis im PATH liegt.

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Python-Version zu alt

Wenn du eine Fehlermeldung bekommst, die sich auf Python bezieht, prüfe deine Version mit python --version. Alles unter 3.11 ist zu alt. Auf macOS aktualisier über Homebrew, auf Linux über deinen Paketmanager.

sudo apt install python3.11 python3.11-venv python3-pip

Build-Werkzeuge fehlen (Linux)

Unter Linux brauchst du eventuell zusätzliche Pakete. Wenn der Build fehlschlägt, installiere

sudo apt install build-essential python3-dev git

API-Key wird nicht erkannt

Nimmt Hermes deinen API-Key nicht an, prüfe die Konfigurationsdatei.

cat ~/.hermes/config.json

Achte darauf, dass der Key korrekt unter dem richtigen Provider hinterlegt ist. Tippfehler sind die häufigste Fehlerquelle. Falls du auf Nummer sicher gehen willst, setze ihn als Umgebungsvariable (ANTHROPIC_API_KEY, OPENAI_API_KEY etc.).

Channel-Verbindung schlägt fehl

Wenn ein Channel (Telegram, Discord, Slack) nicht startet, läuft der Gateway-Dienst wahrscheinlich nicht. Prüf das mit

hermes gateway status

Falls der Gateway nicht läuft, starte ihn manuell mit hermes gateway start. Bei Telegram-Bots ist häufig der Token vertippt oder der Bot wurde nicht korrekt mit BotFather aktiviert.

Sicherheitshinweise, die du kennen solltest

Hermes Agent ist deutlich datenschutzfreundlicher aufgestellt als viele andere Agent-Frameworks.

Alle Daten bleiben standardmäßig auf deiner Maschine. Keine Telemetrie, kein Cloud-Lock-in, keine versteckten Datenabflüsse. Das ist einer der Hauptgründe für die Beliebtheit. Wer DSGVO-konform arbeiten will, hat hier deutlich weniger Stress als bei Cloud-Agenten.

Trotzdem gibt es ein paar Punkte, die du beachten solltest.

Sobald du Cloud-LLMs (Claude, GPT, Gemini) nutzt, gehen deine Prompts an die jeweiligen Anbieter. Das ist normal, aber gut zu wissen. Wenn du absolute Privatsphäre willst, kombinier Hermes mit Ollama. Dann verlässt kein einziger Token deine Maschine.

hermes update

Vier sinnvolle Sicherheitsregeln für Hermes Agent:

1. Immer die neueste Version nutzen, neue Releases kommen wöchentlich
2. Bei sensiblen Workflows lokale Modelle über Ollama nutzen statt Cloud-LLMs
3. Channel-Berechtigungen so eng wie möglich setzen (z. B. Telegram-Bot nur für deine User-ID freigeben)
4. Bei API-Kosten ein monatliches Limit beim Anbieter setzen

Was kostet Hermes Agent?

Die Software selbst kostet nichts. Hermes Agent ist komplett Open Source unter MIT-Lizenz.

Die eigentlichen Kosten entstehen durch die KI-Modelle, die du im Hintergrund nutzt. Die hast du selbst in der Hand.

Typische Kosten bei normaler Nutzung liegen bei 5 bis 30 $ pro Monat für API-Aufrufe (je nach Modell und Intensität). Das ist vergleichbar mit einem ChatGPT-Plus-Abo. Wenn du Claude Sonnet 4.6 nutzt, liegst du eher bei 10 bis 20 $.

Wenn du komplett kostenlos fahren willst, installier Ollama und nutz lokale Modelle. Dann zahlst du wirklich gar nichts, abgesehen vom Strom für deinen Rechner.

Fazit

Das war’s! Du hast Hermes Agent installiert, einen LLM-Provider verbunden und weißt, worauf du achten musst.

Die Installation ist deutlich angenehmer als bei den meisten Agent-Frameworks. Native Windows-Unterstützung, Python statt der ewigen Node-Versionskonflikte und ein vernünftiges Setup-Tool machen den Einstieg fair. Was Hermes wirklich besonders macht, zeigt sich aber erst nach ein paar Wochen Nutzung. Wenn der Agent anfängt, deine Vorlieben zu kennen und dir vorausschauend Vorschläge zu machen.

Wenn du tiefer einsteigen willst, schau dir als Nächstes die Skill-Entwicklung an. Eigene Skills zu bauen ist bei Hermes der eigentliche Aha-Moment. Falls du dir nicht sicher bist, ob Hermes das richtige Tool für dich ist, hilft dir mein Vergleich der besten OpenClaw-Alternativen bei der Entscheidung. Hermes ist dort als populärster Adaptive-Agent gelistet.