Hermes Agent ☤

Hermes Agent | Hermes Desktop

Der selbstverbessernde KI-Agent, entwickelt von Nous Research. Es ist der einzige Agent mit einer integrierten Lernschleife – er erstellt Fähigkeiten aus Erfahrungen, verbessert sie während der Nutzung, stößt sich selbst an, Wissen zu persistieren, durchsucht seine eigenen vergangenen Konversationen und baut über Sitzungen hinweg ein immer tieferes Modell davon auf, wer du bist. Betreibe ihn auf einem $5-VPS, einem GPU-Cluster oder serverloser Infrastruktur, die im Leerlauf fast nichts kostet. Er ist nicht an deinen Laptop gebunden – sprich mit ihm über Telegram, während er auf einer Cloud-VM arbeitet.

Verwende jedes beliebige Modell – Nous Portal, OpenRouter, OpenAI, deinen eigenen Endpoint und viele andere. Wechsle mit hermes model – keine Codeänderungen, keine Bindung.

Schnellinstallation

Linux, macOS, WSL2, Termux

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows (nativ, PowerShell)

Hinweis: Natives Windows führt Hermes ohne WSL aus – CLI, Gateway, TUI und Tools funktionieren alle nativ. Wenn du lieber WSL2 verwenden möchtest, funktioniert der Linux/macOS-Einzeiler oben auch dort. Einen Fehler gefunden? Bitte melde Probleme.

Führe dies in PowerShell aus:

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

Der Installer übernimmt alles: uv, Python 3.11, Node.js, ripgrep, ffmpeg, und ein portables Git Bash (MinGit, entpackt nach %LOCALAPPDATA%\hermes\git – keine Admin-Rechte erforderlich, vollständig isoliert von jeder System-Git-Installation). Hermes verwendet dieses gebündelte Git Bash, um Shell-Befehle auszuführen.

Wenn du bereits Git installiert hast, erkennt der Installer dies und verwendet stattdessen dieses. Andernfalls ist ein ~45MB-MinGit-Download alles, was du brauchst – er berührt oder stört kein System-Git.

Android / Termux: Der getestete manuelle Pfad ist im Termux-Leitfaden dokumentiert. Auf Termux installiert Hermes ein kuratiertes .[termux]-Extra, weil das vollständige .[all]-Extra derzeit Android-inkompatible Sprachabhängigkeiten mit sich bringt.

Windows: Natives Windows wird vollständig unterstützt – der PowerShell-Einzeiler oben installiert alles. Wenn du lieber WSL2 verwenden möchtest, funktioniert der Linux-Befehl auch dort. Die native Windows-Installation liegt unter %LOCALAPPDATA%\hermes; WSL2-Installationen liegen unter ~/.hermes wie unter Linux.

Nach der Installation:

source ~/.bashrc    # Shell neu laden (oder: source ~/.zshrc)
hermes              # Chat starten!

Fehlerbehebung

Windows Defender oder Antivirus markiert uv.exe als Malware

Wenn dein Antivirus (Bitdefender, Windows Defender usw.) uv.exe aus dem Hermes-bin-Ordner (%LOCALAPPDATA%\hermes\bin\uv.exe) unter Quarantäne stellt, handelt es sich um einen Fehlalarm. Die Datei ist Astral's uv – der Rust-Python-Paketmanager, den Hermes zur Verwaltung seiner Python-Umgebung bündelt. ML-basierte Antivirus-Engines markieren häufig unsignierte Rust-Binaries, die Pakete herunterladen und installieren.

So verifizierst du, dass deine Kopie authentisch ist:

# GitHub CLI bei Bedarf installieren
winget install --id GitHub.cli

# Bei GitHub anmelden
gh auth login

# Verifizierung ausführen
$uv = "$env:LOCALAPPDATA\hermes\bin\uv.exe"
$ver = (& $uv --version).Split(' ')[1]
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$zip = "$env:TEMP\uv.zip"
Invoke-WebRequest "https://github.com/astral-sh/uv/releases/download/$ver/uv-x86_64-pc-windows-msvc.zip" -OutFile $zip -UseBasicParsing
gh attestation verify $zip --repo astral-sh/uv
Expand-Archive $zip "$env:TEMP\uv_x" -Force
(Get-FileHash "$env:TEMP\uv_x\uv.exe").Hash -eq (Get-FileHash $uv).Hash

Wenn die Attestierung „Verification succeeded" sagt und die letzte Zeile True ausgibt, ist alles in Ordnung.

So setzt du Hermes auf die Whitelist:

• Windows Defender: PowerShell als Admin ausführen → Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"
• Bitdefender: Eine Ausnahme in der Bitdefender-Konsole hinzufügen (Schutz > Antivirus > Einstellungen > Ausnahmen verwalten)
• Setze den Ordner auf die Whitelist, nicht den Datei-Hash – Hermes aktualisiert uv und der Hash ändert sich bei jeder Version

Für mehr Kontext siehe die vorgelagerten Astral-Berichte: astral-sh/uv#13553, astral-sh/uv#15011, astral-sh/uv#10079.

Erste Schritte

hermes              # Interaktive CLI – eine Konversation starten
hermes model        # LLM-Anbieter und Modell wählen
hermes tools        # Konfigurieren, welche Tools aktiviert sind
hermes config set   # Einzelne Konfigurationswerte setzen
hermes config get   # Einzelne Konfigurationswerte anzeigen
hermes gateway      # Messaging-Gateway starten (Telegram, Discord usw.)
hermes setup        # Vollständigen Setup-Assistenten ausführen (konfiguriert alles auf einmal)
hermes claw migrate # Von OpenClaw migrieren (falls von OpenClaw kommend)
hermes update       # Auf die neueste Version aktualisieren
hermes doctor       # Probleme diagnostizieren

📖 Vollständige Dokumentation →

Überspringe das API-Key-Sammeln – Nous Portal

Hermes funktioniert mit jedem Anbieter, den du möchtest – das ändert sich nicht. Aber wenn du nicht fünf separate API-Keys für das Modell, Websuche, Bildgenerierung, TTS und einen Cloud-Browser sammeln möchtest, deckt Nous Portal alle unter einem einzigen Abonnement ab:

• 300+ Modelle – wähle jedes beliebige mit /model <name>
• Tool Gateway – Websuche (Firecrawl), Bildgenerierung (FAL), Text-to-Speech (OpenAI), Cloud-Browser (Browser Use), alles über dein Abo geroutet. Keine zusätzlichen Konten.

Ein Befehl von einer frischen Installation:

hermes setup --portal

Das meldet dich per OAuth an, setzt Nous als deinen Anbieter und aktiviert das Tool Gateway. Überprüfe jederzeit, was eingerichtet ist, mit hermes portal info. Vollständige Details auf der Tool-Gateway-Dokumentationsseite.

Du kannst weiterhin jederzeit eigene Keys pro Tool mitbringen – das Gateway ist pro Backend, nicht alles-oder-nichts.

CLI vs. Messaging – Kurzreferenz

Hermes hat zwei Einstiegspunkte: Starte die Terminal-UI mit hermes, oder betreibe das Gateway und sprich mit ihm über Telegram, Discord, Slack, WhatsApp, Signal oder E-Mail. Sobald du in einer Konversation bist, werden viele Slash-Commands in beiden Oberflächen geteilt.

Für die vollständigen Befehlslisten siehe den CLI-Leitfaden und den Messaging-Gateway-Leitfaden.

Dokumentation

Die gesamte Dokumentation befindet sich unter hermes-agent.nousresearch.com/docs:

Migration von OpenClaw

Wenn du von OpenClaw kommst, kann Hermes automatisch deine Einstellungen, Erinnerungen, Fähigkeiten und API-Keys importieren.

Während der Ersteinrichtung: Der Setup-Assistent (hermes setup) erkennt automatisch ~/.openclaw und bietet an, vor Beginn der Konfiguration zu migrieren.

Jederzeit nach der Installation:

hermes claw migrate              # Interaktive Migration (vollständiges Preset)
hermes claw migrate --dry-run    # Vorschau, was migriert würde
hermes claw migrate --preset user-data   # Ohne Geheimnisse migrieren
hermes claw migrate --overwrite  # Bestehende Konflikte überschreiben

Was importiert wird:

• SOUL.md – Persona-Datei
• Erinnerungen – MEMORY.md- und USER.md-Einträge
• Fähigkeiten – benutzererstellte Fähigkeiten → ~/.hermes/skills/openclaw-imports/
• Befehls-Allowlist – Genehmigungsmuster
• Messaging-Einstellungen – Plattformkonfigurationen, erlaubte Benutzer, Arbeitsverzeichnis
• API-Keys – allowlistete Geheimnisse (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
• TTS-Assets – Arbeitsbereichs-Audiodateien
• Arbeitsbereichsanweisungen – AGENTS.md (mit --workspace-target)

Siehe hermes claw migrate --help für alle Optionen, oder verwende die openclaw-migration-Fähigkeit für eine interaktive, agentengeführte Migration mit Dry-Run-Vorschauen.

Mitwirken

Wir freuen uns über Beiträge! Siehe den Mitwirkungs-Leitfaden für Entwicklungseinrichtung, Codestil und PR-Prozess.

Schnellstart für Mitwirkende – verwende den Standard-Installer und arbeite dann vom vollständigen Git-Checkout, das er unter $HERMES_HOME/hermes-agent erstellt (normalerweise ~/.hermes/hermes-agent). Dies entspricht dem Layout, das von hermes update, der verwalteten venv, Lazy-Dependencies, Gateway und Docs-Tooling verwendet wird.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
cd "${HERMES_HOME:-$HOME/.hermes}/hermes-agent"
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

Manueller Clone-Fallback (für Wegwerf-Clones/CI, wo du bewusst nicht das verwaltete Installationslayout möchtest):

Erstelle die venv außerhalb des geklonten Quellbaum-Verzeichnisses – eine venv innerhalb des Verzeichnisses, in dem der Agent arbeitet, kann durch einen relativen Pfadbefehl gelöscht werden, den der Agent gegen sein eigenes Checkout ausführt, was die laufende Runtime mitten in der Sitzung zerstört.

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv ~/.hermes/venvs/hermes-dev --python 3.11
source ~/.hermes/venvs/hermes-dev/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

Community

• 💬 Discord
• 📚 Skills Hub
• 🐛 Issues
• 🔌 computer-use-linux – Linux-Desktop-Steuerungs-MCP-Server für Hermes und andere MCP-Hosts, mit AT-SPI-Zugänglichkeitsbäumen, Wayland/X11-Eingabe, Screenshots und Compositor-Fensterzielung.
• 🔌 HermesClaw – Community-WeChat-Bridge: Betreibe Hermes Agent und OpenClaw auf demselben WeChat-Konto.

Lizenz

MIT – siehe LICENSE.

Erstellt von Nous Research.