Was ist Hermes Agent? Installation (Mac, Linux, Windows)

Hermes Agent ist ein quelloffener KI-Agent, den Nous Research entwickelt. Er steht unter der MIT-Lizenz auf GitHub und läuft im Terminal, in einer Desktop-App, in Messenger-Apps und in Editoren. Von einem gewöhnlichen Chatbot unterscheidet ihn, dass er aus seiner Arbeit lernt, wiederverwendbare Skills (Fähigkeiten) schreibt und sein Gedächtnis über Sitzungen hinweg behält.

Dieser Artikel ist der erste Teil einer Serie: Ich erkläre, was Hermes ist, wie man es installiert und was Sie beim ersten Start einstellen sollten. Im zweiten Teil geht es um Telegram, zeitgesteuerte Aufgaben und den sicheren Betrieb.

Dieser Artikel beruht auf der offiziellen Dokumentation und dem GitHub-Repository; ich habe die Installation nicht auf meinem eigenen Rechner ausprobiert. Die Befehle gebe ich unten so wieder, wie sie dort stehen, die Quellen stehen am Ende. Versionsnummern nenne ich bewusst nicht, da sie je nach Quelle abweichen.

Was ist Hermes Agent?

Hermes ist ein Agenten-Framework, das um ein Sprachmodell herum gebaut ist. Es ist kein Modell; das Modell wählen Sie selbst. Das Framework bietet:

• Dauerhaftes Gedächtnis. Sitzungen werden in einer SQLite-Datenbank (mit Volltextsuche) gespeichert, sodass sich ein Gespräch von vor Wochen wieder abrufen lässt. Ihre Vorlieben liegen in Dateien wie memory.md und user.md.
• Skill-System. Nach einer komplexen Aufgabe kann der Agent daraus ein wiederverwendbares Vorgehen ableiten und es mit der Nutzung verbessern. Skills liegen unter ~/.hermes/skills/ und sind mit dem Format von agentskills.io kompatibel.
• Plattformübergreifendes Gateway. Sie können mit demselben Agenten über Telegram, Discord, Slack, WhatsApp und Signal sprechen; eine im Terminal gestartete Sitzung lässt sich in Telegram fortsetzen.
• Unteragenten. Mit dem Werkzeug delegate_task kann er parallele Arbeitsabläufe starten.
• MCP-Unterstützung. Er kann sich mit Servern des Model Context Protocol verbinden.
• Verschiedene Laufzeitumgebungen. Lokal, Docker, SSH, Singularity, Modal, Daytona und Vercel Sandbox.

Das Repository enthält auch den Befehl hermes claw migrate für den Umstieg von OpenClaw; er überträgt Persönlichkeiten, Gedächtnis, Skills und Einstellungen.

Das Konzept der Skills habe ich zuvor ausführlich in Was ist ein Agent Skill? Nützliche Skills schreiben erklärt. Hermes ist eines der Werkzeuge, die diese Idee am direktesten umsetzen.

Voraussetzungen

Laut der offiziellen Installationsseite ist die einzige harte Voraussetzung Git. Das Installationsskript kümmert sich selbst um Python, Node.js und die nötigen Werkzeuge. Unterstützte Umgebungen:

Umgebung	Status
macOS	Desktop-Paket nur für Apple Silicon; die Installation über die Kommandozeile funktioniert auch auf Intel
Linux	Installation über die Kommandozeile
Windows	PowerShell-Installer oder WSL2
Android	Termux-Paket (aarch64)

Wenn Sie ein lokales Modell auf Ihrer eigenen Hardware betreiben, brauchen Sie zusätzlich GPU-Speicher; bei einem Cloud-Modell nicht. Eine Anleitung eines Drittanbieters gibt an, dass der Agent im Modell mindestens 64.000 Tokens Kontext erwartet; wählen Sie ein Modell mit kleinem Kontext, kann es beim Start zu Fehlern kommen.

Installation

macOS, Linux und WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc   # bei bash: ~/.bashrc
hermes

Die alternative Adresse im GitHub-Repository liefert dasselbe Skript: https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh.

Windows

In PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Alternativ können Sie WSL2 einrichten und den Linux-Befehl im Ubuntu-Terminal ausführen. Anleitungen von Drittanbietern bezeichnen die native Windows-Installation als frühes Stadium (Beta); bei Problemen ist WSL2 der robustere Weg.

Desktop-App

Für macOS und Windows gibt es auch ein herunterladbares Desktop-Paket; die macOS-Version unterstützt nur Apple Silicon. Sie können auch über die Kommandozeile beginnen und die lokale App mit dem Befehl hermes desktop öffnen.

Installation prüfen

hermes doctor

Dieser Befehl prüft den Systemzustand. Bei der Fehlermeldung hermes: command not found starten Sie das Terminal neu oder führen source für Ihre Shell-Datei aus; der Installer legt den Einstieg der Kommandozeile unter ~/.local/bin/hermes ab. Installieren Sie nicht mit sudo.

Ersteinrichtung

hermes setup

Der Einrichtungsassistent fragt nach Ihrem Modellanbieter. Zur Auswahl stehen unter anderem Nous Portal, OpenRouter, Anthropic, OpenAI, Google Gemini und lokale Modelle wie Ollama. Zum späteren Ändern:

hermes model       # Anbieter und Modell wählen
hermes tools       # Werkzeuge ein-/ausschalten
hermes config set FIRECRAWL_API_KEY ihr_schluessel

Zwei Regeln sind wichtig:

1. Geheimnisse liegen in ~/.hermes/.env, Einstellungen in config.yaml. Die Dokumentation sagt ausdrücklich, dass Sie eine Einstellung nicht in die .env-Datei schreiben sollen.
2. Ändern Sie Einstellungen mit hermes config set, bearbeiten Sie die YAML-Datei nicht von Hand.

Die Dateien liegen gebündelt unter ~/.hermes/: unter anderem skills/, state.db (Sitzungsspeicher), sessions/ und logs/.

Mit welchem Modell betreiben?

Hermes selbst kostet nichts; die Kosten entstehen durch das gewählte Modell.

• Cloud-API (OpenRouter, Anthropic, OpenAI, Gemini): Einfach einzurichten, Sie zahlen nach Nutzung.
• Nous Portal: Das eigene Abo von Nous; die Anmeldung erfolgt mit hermes setup --portal.
• Lokales Modell mit Ollama: Kostenlos und offline. Beispielablauf: ein Modell herunterladen, ollama serve starten, dann in hermes model „Custom endpoint" wählen und die Adresse http://localhost:11434/v1 angeben. Da das Standard-Kontextfenster von Ollama klein ist, müssen Sie es eventuell mit der Variablen OLLAMA_CONTEXT_LENGTH vergrößern.

Wie sich neu erschienene Modelle in Hermes nutzen lassen, habe ich zum Beispiel in der Installationsanleitung für LongCat 2.5 Preview erwähnt, die eine fertige Anleitung für Hermes Agent enthält. Bei Modellen wie Gemini 4 Argon, die noch nicht zugänglich sind, muss zuerst die Modell-ID veröffentlicht werden.

Erster Start

hermes

Im Terminal öffnet sich ein Chat. Beginnen Sie mit etwas Kleinem, etwa „Was liegt in dem Ordner, in dem ich gerade bin?". Hilfsbefehle, die Sie nutzen:

hermes chat -q "einmalige Frage"   # eine Frage, ohne Chat zu öffnen
hermes --continue                   # letzte Sitzung fortsetzen
hermes --tui                        # Terminal-Oberfläche
hermes update                       # aktualisieren

Wenn Sie für eine einzelne Arbeit mehrere Persönlichkeiten einrichten möchten, gibt es Profile wie hermes profile create work --clone; jedes Profil nutzt seinen eigenen Ordner ~/.hermes/profiles/<name>/.

Für wen eignet es sich?

• Wer sich im Terminal wohlfühlt. Das Werkzeug ist terminalzentriert; es gibt auch eine Desktop-App, aber die eigentliche Stärke liegt in der Kommandozeile.
• Wer denselben Agenten auch vom Handy nutzen möchte. Dafür ist das Telegram-Gateway da.
• Wer wiederkehrende Arbeit automatisieren möchte. Dafür sind Skills und zeitgesteuerte Aufgaben da.
• Wer die Kontrolle behalten möchte. Open Source und Modellwahl liegen bei Ihnen.

Für eine einfache einmalige Code-Frage kann es zu schwergewichtig sein; dafür genügt direkt ein Chat-Werkzeug.

Häufige Fragen

Ist Hermes Agent kostenlos?

Die Software selbst ist MIT-lizenziert und Open Source. Sie zahlen die API-Gebühr des Modells, das Sie nutzen; mit einem lokalen Modell über Ollama kann es kostenlos laufen.

Läuft Hermes Agent unter Windows?

Ja. Die offizielle Dokumentation liefert den PowerShell-Installer; Sie können auch den Linux-Befehl in WSL2 verwenden.

Was ist der Unterschied zwischen Hermes Agent und Claude Code?

Hermes ist ein modellunabhängiges Agenten-Framework mit Gedächtnis und Skill-Erzeugung; es läuft auch über Messenger-Apps. Claude Code ist Anthropics eigener Coding-Agent. Für einen Werkzeugvergleich siehe den Vergleich der Vibe-Coding-Werkzeuge.

Welche Modelle unterstützt Hermes?

Nous Portal, OpenRouter, Anthropic, OpenAI, Google Gemini und jede OpenAI-kompatible benutzerdefinierte Adresse, einschließlich Ollama.

Wie lange dauert die Installation?

Anleitungen von Drittanbietern nennen 2 bis 5 Minuten; je nach Verbindungsgeschwindigkeit unterschiedlich.

Quellen

• Nous Research, hermes-agent (GitHub): Funktionen, Installationsbefehle, MIT-Lizenz, Umstieg von OpenClaw.
• Hermes Agent, Installation: Voraussetzungen, Installationsorte, Fehlerbehebung.
• Hermes Agent, offizielle Dokumentation: Struktur von ~/.hermes, Konfigurationsregeln, Anbieter.
• DataCamp, Nous Research Hermes Agent: Setup and Tutorial Guide: Architektur von Gedächtnis und Skills, Ollama-Einrichtung, Profile.
• Hermes Atlas, How to Install Hermes Agent: Hinweise zu Betriebssystemen und Fehlerbehebung (Drittanbieter).
• NxCode, Hermes Agent Tutorial: Anforderung an das Kontextfenster (Drittanbieter).