Hermes Agent kostenlos installieren und nutzen: Ein praktischer Leitfaden

Hermes Agent ist vor ein paar Wochen auf meinem Radar aufgetaucht, und nachdem ich das GitHub-Repo durchgegangen bin (37,5k Sterne, MIT-Lizenz, von Nous Research entwickelt), wurde mir klar, dass er etwas tut, was die meisten KI-Agenten nicht können: Er wird besser, je mehr du ihn nutzt. Nicht in dem vagen Sinne von „das Modell verbessert sich" — er baut regelrecht Fähigkeiten aus deinen Interaktionen auf, merkt sich, was funktioniert hat, und verfeinert diese Fähigkeiten im Laufe der Zeit. Das allein macht ihn einen Blick wert.

Der Teil, der mich überzeugt hat: Er läuft auf einem 5-$-VPS. Keine GPU nötig, es sei denn, du willst eine. Und du kannst ihn mit Telegram, Discord, Slack, WhatsApp und etwa einem Dutzend weiterer Plattformen verbinden. Wir empfehlen LightNode als VPS-Anbieter — die Abrechnung pro Stunde beginnt bei 0,013 $/Stunde, was beim Experimentieren mit selbstgehosteter KI kaum zu unterbieten ist.

Inhaltsverzeichnis

1. Was Hermes Agent wirklich macht
2. Systemanforderungen
3. Installation
4. Einen kostenlosen Modell-Anbieter einrichten
5. Konfiguration
6. Deine erste Session starten
7. Verbindung mit Messaging-Plattformen
8. Wichtige Funktionen, die man kennen sollte
9. Fehlerbehebung
10. Fazit

Was Hermes Agent wirklich macht

Die meisten KI-Agenten folgen demselben Muster: Du schickst einen Prompt, sie führen ein paar Tools aus, liefern ein Ergebnis und vergessen alles. Hermes Agent geht einen anderen Weg. Er hat eine eingebaute Lernschleife:

1. Du gibst ihm eine Aufgabe
2. Er ermittelt, welche Fähigkeiten benötigt werden
3. Wenn eine Fähigkeit nicht existiert, erstellt er sie
4. Er nutzt die Fähigkeit, bewertet das Ergebnis und speichert, was funktioniert hat
5. Wenn du das nächste Mal etwas Ähnliches verlangst, greift er auf die verfeinerte Fähigkeit zurück

Das bedeutet, dass der Agent tatsächlich durch Nutzung besser wird, nicht nur weil das zugrundeliegende Modell ein Update erhalten hat. Deine spezifischen Workflows, deine Codebasis, deine Gewohnheiten — er lernt diese Muster.

Über die Lernschleife hinaus wird Hermes Agent mit 47 integrierten Tools ausgeliefert, unterstützt MCP-Integration (Model Context Protocol) zur Erweiterung der Fähigkeiten und kann Aufgaben an Unteragenten delegieren. Außerdem gibt es einen Cron-Scheduler für wiederkehrende Aufgaben und einen Sprachmodus, wenn du freihändig arbeiten willst.

Systemanforderungen

Bevor du installierst, stell sicher, dass dein System die Grundvoraussetzungen erfüllt:

• Betriebssystem: Linux (Ubuntu 20.04+ empfohlen), macOS (12+) oder Windows via WSL2
• Python: 3.10 oder höher
• RAM: 2 GB Minimum, 4 GB empfohlen
• Festplatte: ~500 MB für den Agenten selbst
• Netzwerk: Internetzugang für Modell-API-Aufrufe

Für Android-Nutzer funktioniert auch Termux. Natives Windows wird nicht unterstützt — du brauchst WSL2.

Wenn du auf einem VPS bereitstellst, reicht ein 5-$/Monat-Server mit 1 vCPU und 1 GB RAM für leichte Nutzung problemlos. Höhere Lasten (mehrere Messaging-Plattformen, häufige Cron-Jobs) profitieren von 2 GB+.

Installation

Es gibt zwei Wege, Hermes Agent zu installieren. Der schnelle Weg erledigt alles für dich. Der manuelle Weg gibt dir mehr Kontrolle.

Methode 1: Einzeiler-Installation (empfohlen)

Öffne dein Terminal und führe aus:

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

Dieses Script erledigt die Schwerstarbeit: prüft Abhängigkeiten, richtet eine virtuelle Umgebung ein, klont das Repo, installiert Pakete und startet den Einrichtungsassistenten. Auf einem frischen Ubuntu dauert das Ganze etwa 2–3 Minuten.

Überprüfe danach die Installation:

hermes --version

Du solltest die Versionsnummer sehen. Wenn du einen „command not found"-Fehler bekommst, starte deine Shell neu oder führe source ~/.bashrc aus (oder ~/.zshrc, falls du zsh nutzt).

Methode 2: Manuelle Installation

Wenn du lieber genau wissen willst, was auf deiner Maschine landet, oder wenn der Einzeiler aus irgendeinem Grund scheitert:

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

# Create and activate a virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run the setup wizard
python setup.py

Der Einrichtungsassistent führt dich durch die Auswahl des Modell-Anbieters, die Eingabe des API-Schlüssels und die Grundeinstellungen. Du kannst ihn jederzeit mit hermes setup erneut starten.

Einen kostenlosen Modell-Anbieter einrichten

Hermes Agent wird nicht mit einem eigenen Modell ausgeliefert. Er verbindet sich mit externen Anbietern. Die gute Nachricht: Mehrere Anbieter bieten kostenlose Tarife an, die mit Hermes Agent funktionieren.

Option 1: OpenRouter (die einfachste kostenlose Option)

OpenRouter gibt dir Zugang zu über 200 Modellen, und mehrere davon sind kostenlos. Das ist der Weg, den ich für den Einstieg empfehle.

1. Erstelle ein Konto auf openrouter.ai
2. Generiere einen API-Schlüssel in deinem Dashboard
3. Finde kostenlose Modelle — suche nach Modellen mit dem Tag „free" im Katalog

Zu den häufigen kostenlosen Modellen auf OpenRouter gehören Varianten von Llama, Mistral und Qwen. Die verfügbaren Modelle wechseln regelmäßig, schau also in den aktuellen Katalog.

Wähle während des Einrichtungsassistenten von Hermes Agent „OpenRouter" als Anbieter und füge deinen API-Schlüssel ein, wenn du dazu aufgefordert wirst.

Option 2: Nous Portal

Nous Research betreibt ein eigenes Inferenz-Portal. Es bietet gelegentlich kostenlose Credits für neue Nutzer an, und die dort verfügbaren Modelle sind speziell für Agenten-Workloads optimiert.

1. Besuche nousresearch.com und registriere dich
2. Prüfe dein Dashboard auf eventuell zugewiesene Gratis-Guthaben
3. Verwende den bereitgestellten API-Schlüssel im Hermes Agent Setup

Option 3: Weitere Anbieter

Hermes Agent unterstützt auch:

• z.ai / GLM: Chinesische KI-Plattform mit kostenlosem Tarif
• Kimi / Moonshot: Eine weitere Option mit begrenzter kostenloser Nutzung
• MiniMax: Kostenloser Tarif für leichte Nutzung verfügbar
• Jeder OpenAI-kompatible Endpunkt: Wenn du Zugang zu anderen Anbietern hast, kannst du sie direkt einbinden

Um einen benutzerdefinierten Endpunkt zu konfigurieren, brauchst du die Basis-URL und einen API-Schlüssel. Der Einrichtungsassistent erledigt das, oder du kannst die Konfigurationsdatei direkt bearbeiten (siehe nächster Abschnitt).

Konfiguration

Hermes Agent speichert seine Konfiguration in ~/.hermes/config.toml. Nach dem Durchlauf des Einrichtungsassistenten findest du etwas wie folgt:

[model]
provider = "openrouter"
api_key = "sk-or-v1-..."
model = "meta-llama/llama-3.3-70b-instruct:free"

[agent]
name = "Hermes"
memory = true
skills_dir = "~/.hermes/skills"

[messaging]
# Configure messaging platforms here
# telegram_token = ""
# discord_token = ""

Wichtige Konfigurationsoptionen

Modell-Einstellungen: Wechsle jederzeit das Modell oder den Anbieter. Wenn du ein anderes kostenloses Modell auf OpenRouter ausprobieren möchtest, aktualisiere einfach das Feld model. Du kannst auch den Anbieter komplett wechseln — ändere provider auf "openai" oder "nous" und passe den API-Schlüssel entsprechend an.

Speicher: Behalte memory = true. Das aktiviert die Lernschleife. Der Agent speichert Gesprächsverlauf und Fähigkeitsverfeinerungen in ~/.hermes/memory/.

Fähigkeiten-Verzeichnis: Hier werden die erlernten Fähigkeiten gespeichert. Du kannst ~/.hermes/skills/ durchsuchen, um zu sehen, was der Agent gelernt hat. Fähigkeiten werden als JSON-Dateien gespeichert und können manuell bearbeitet werden, wenn du sie feinabstimmen möchtest.

Modelle über die CLI wechseln

Du musst nicht jedes Mal die Konfigurationsdatei bearbeiten. Hermes Agent hat dafür eingebaute Befehle:

# List available models for your current provider
hermes model list

# Switch to a specific model
hermes model set meta-llama/llama-3.3-70b-instruct:free

# Check what model you're currently using
hermes model show

Gesundheitsprüfung

Führe das nach jeder Konfigurationsänderung aus, um sicherzustellen, dass alles richtig verbunden ist:

hermes doctor

Es prüft deinen API-Schlüssel, die Modellverfügbarkeit, die Netzwerkverbindung und den Status des Fähigkeiten-Systems. Wenn etwas nicht stimmt, sagt es dir genau, was du beheben musst.

Deine erste Session starten

Sobald alles konfiguriert ist, starte eine Session:

hermes chat

Das öffnet ein interaktives REPL. Probier zuerst etwas Einfaches:

You: What tools do you have available?
Hermes: I have access to 47 built-in tools including:
- file_read / file_write (file operations)
- shell_exec (run shell commands)
- web_search / web_fetch (web access)
- code_search (search codebases)
- calendar / reminders (scheduling)
- ...and more. I can also use MCP tools if configured.

Dann gib ihm eine echte Aufgabe:

You: Create a Python script that monitors a directory for new files and logs their names to a file called new_files.log

Hermes: I'll create that for you.
[creates watch_dir.py with inotify or polling-based implementation]
[tests the script]
The script is ready at ./watch_dir.py. Run it with python watch_dir.py /path/to/watch

Wenn du zum ersten Mal nach etwas fragst, baut der Agent die Fähigkeit von Grund auf neu auf. Frag später nach einer ähnlichen Aufgabe, und er verwendet die verfeinerte Version. Du kannst das in Aktion sehen, indem du nach ein paar Sessions das Fähigkeiten-Verzeichnis überprüfst.

Verbindung mit Messaging-Plattformen

Eine der herausragenden Funktionen von Hermes Agent ist die Plattformunterstützung. Du kannst mit ihm über mehr als 15 Messaging-Plattformen kommunizieren, nicht nur über die CLI.

Telegram-Einrichtung

1. Sende eine Nachricht an @BotFather auf Telegram, um einen neuen Bot zu erstellen
2. Kopiere den Bot-Token
3. Füge ihn zu deiner Konfiguration hinzu:

hermes gateway add telegram --token "YOUR_BOT_TOKEN"

4. Starte das Gateway:

hermes gateway start telegram

Jetzt kannst du direkt in Telegram mit deinem Agenten chatten. Er behält denselben Speicher und dieselben Fähigkeiten wie deine CLI-Sessions.

Discord-Einrichtung

1. Erstelle einen Bot im Discord Developer Portal
2. Aktiviere die Message Content Intent
3. Kopiere den Bot-Token
4. Konfiguriere:

hermes gateway add discord --token "YOUR_BOT_TOKEN"
hermes gateway start discord

Weitere unterstützte Plattformen

Dasselbe Muster gilt für alle Plattformen. Verwende hermes gateway add <plattform> mit den erforderlichen Anmeldedaten:

• Slack: Erfordert eine Slack App mit Bot-Berechtigungen
• WhatsApp: Nutzt die WhatsApp Business API oder eine inoffizielle Bridge
• Signal: Erfordert signal-cli-Einrichtung
• Matrix: Braucht ein Matrix-Bot-Konto
• Mattermost: Persönlicher Zugangstoken
• E-Mail: IMAP/SMTP-Zugangsdaten
• SMS: Twilio oder ein ähnlicher Anbieter
• DingTalk / Feishu / WeCom: Für chinesische Messaging-Plattformen

Führe hermes gateway list aus, um alle verfügbaren Plattformen und ihren Status zu sehen.

Wichtige Funktionen, die man kennen sollte

Skills Hub

Hermes Agent hat ein Community-Fähigkeiten-Repository. Stöbere und installiere Fähigkeiten, die andere erstellt haben:

# Browse available community skills
hermes skills browse

# Install a specific skill
hermes skills install web-scraper

# List your installed skills
hermes skills list

Das ist nützlich, wenn du nicht warten willst, bis der Agent von Grund auf lernt. Wahrscheinlich hat schon jemand eine Fähigkeit für gängige Aufgaben wie Web-Scraping, API-Tests oder Dokumentenparsing erstellt.

Cron-Planung

Richte wiederkehrende Aufgaben ohne externen Cron ein:

hermes cron add "0 9 * * *" "Summarize yesterday's git commits and post to #dev-channel"

Der Agent kümmert sich intern um die Planung und nutzt seine Fähigkeiten zur Ausführung der Aufgabe.

Sprachmodus

Wenn du freihändig arbeiten willst:

hermes chat --voice

Das verwendet dein Systemmikrofon und die Lautsprecher. Es funktioniert am besten mit Modellen, die Audioeingabe verarbeiten können, kann aber auch eine lokale Speech-to-Text-Schicht nutzen.

Delegation an Unteragenten

Für komplexe mehrstufige Aufgaben kann Hermes Agent Unteragenten starten:

You: Research the top 5 VPS providers, compare their pricing, and create a summary document

Hermes: I'll delegate this to subagents for parallel research.
[spawns subagents for each provider]
[collects results]
[generates comparison document]

Unteragenten teilen sich den Speicher und das Fähigkeiten-System des übergeordneten Agenten und profitieren somit von allem, was der Hauptagent gelernt hat.

Fehlerbehebung

„command not found: hermes"

Das Installationsscript fügt Hermes zu deinem PATH hinzu, aber deine aktuelle Shell hat es vielleicht noch nicht erkannt. Lösung:

source ~/.bashrc  # or ~/.zshrc

Wenn das nicht funktioniert, prüfe ob ~/.local/bin/hermes existiert und füge es manuell zu deinem PATH hinzu:

export PATH="$HOME/.local/bin:$PATH"

API-Schlüssel-Fehler

Führe zuerst hermes doctor aus. Es sagt dir, ob dein API-Schlüssel ungültig ist, abgelaufen ist oder ob das ausgewählte Modell nicht verfügbar ist. Häufige Lösungen:

• Für OpenRouter: Prüfe deinen Schlüssel unter openrouter.ai/keys
• Kostenlose Modelle haben manchmal Ratenbeschränkungen — probiere ein anderes kostenloses Modell
• Stelle sicher, dass kein Leerzeichen am Ende deines API-Schlüssels steht

Modell antwortet nicht

Modelle im kostenlosen Tarif haben Nutzungslimits. Wenn du ein Limit erreichst:

hermes model list    # see what's available
hermes model set <different-free-model>  # switch

Hoher Speicherverbrauch

Wenn der Speicher des Agenten zu groß wird (prüfe mit du -sh ~/.hermes/memory/), kannst du alte Einträge entfernen:

hermes memory prune --older-than 30d

Das behält aktuelle Interaktionen und Fähigkeiten, löscht aber Gesprächsprotokolle, die älter als 30 Tage sind.

Gateway-Verbindungsprobleme

Stelle bei Messaging-Plattformen sicher, dass der Gateway-Prozess läuft:

hermes gateway status

Wenn ein Gateway ständig die Verbindung verliert, prüfe dein Netzwerk und starte es neu:

hermes gateway restart telegram

Fazit

Hermes Agent macht etwas, das ich bei anderen Open-Source-Agenten nicht gut umgesetzt gesehen habe: Er lernt tatsächlich aus deinen Nutzungsmustern und wird mit der Zeit besser, ohne dass du manuell Workflows definieren oder benutzerdefinierte Plugins schreiben musst. Das Fähigkeiten-System ist der eigentliche Unterschied — Aufgaben, die beim ersten Mal 10 Minuten dauern, dauern beim fünften Mal 30 Sekunden.

Dass er auf günstiger Hardware läuft und sich mit kostenlosen Modell-Anbietern verbindet, bedeutet, dass du einen persönlichen KI-Agenten rund um die Uhr für nahezu null Kosten betreiben kannst. Verbinde ihn mit Telegram oder Discord, und du hast einen immer verfügbaren Assistenten, der sich an deine Präferenzen, deine Codebasis und deine Workflows erinnert.

So startest du:

1. Wähle einen VPS (oder nutze deinen lokalen Rechner) — LightNode eignet sich dafür gut
2. Führe den Einzeiler-Installer aus
3. Registriere dich bei OpenRouter und schnapp dir ein kostenloses Modell
4. Fang an zu chatten

Das GitHub-Repo hat eine detaillierte Dokumentation, und die Community ist aktiv, falls du auf Probleme stößt. Gib ihm ein Wochenende — bis Montag hast du einen Agenten, der bereits damit begonnen hat, Fähigkeiten speziell für deine Arbeit aufzubauen.