nousresearch/hermes-agentDer Agent, der mit dir wächst
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.
| Eine echte Terminal-Oberfläche | Vollwertige TUI mit Mehrzeilenbearbeitung, Slash-Command-Autovervollständigung, Konversationsverlauf, Unterbrechen-und-Umleiten sowie Streaming-Tool-Ausgabe. |
| Lebt dort, wo du lebst | Telegram, Discord, Slack, WhatsApp, Signal und CLI – alles über einen einzigen Gateway-Prozess. Sprachnotiz-Transkription, plattformübergreifende Konversationskontinuität. |
| Eine geschlossene Lernschleife | Agent-kuratierter Speicher mit periodischen Erinnerungen. Autonome Fähigkeitserstellung nach komplexen Aufgaben. Fähigkeiten verbessern sich während der Nutzung selbst. FTS5-Sitzungssuche mit LLM-Zusammenfassung für sitzungsübergreifenden Abruf. Honcho dialektische Benutzermodellierung. Kompatibel mit dem agentskills.io offenen Standard. |
| Geplante Automatisierungen | Integrierter Cron-Scheduler mit Zustellung an jede Plattform. Tägliche Berichte, nächtliche Backups, wöchentliche Audits – alles in natürlicher Sprache, unbeaufsichtigt laufend. |
| Delegiert und parallelisiert | Starte isolierte Subagenten für parallele Arbeitsabläufe. Schreibe Python-Skripte, die Tools über RPC aufrufen, und reduziere mehrstufige Pipelines auf Turns ohne Kontextkosten. |
| Läuft überall, nicht nur auf deinem Laptop | Sieben Terminal-Backends – lokal, Docker, SSH, Singularity, Modal, Daytona und Vercel Sandbox. Daytona und Modal bieten serverlose Persistenz – die Umgebung deines Agents hiberniert im Leerlauf und wacht bei Bedarf auf, was zwischen Sitzungen fast nichts kostet. Betreibe ihn auf einem $5-VPS oder einem GPU-Cluster. |
| Forschungsbereit | Batch-Trajektoriengenerierung, Trajektorienkompression für das Training der nächsten Generation von Tool-Calling-Modellen. |
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
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~/.hermeswie unter Linux.
Nach der Installation:
source ~/.bashrc # Shell neu laden (oder: source ~/.zshrc)
hermes # Chat starten!
uv.exe als MalwareWenn 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:
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"uv und der Hash ändert sich bei jeder VersionFür mehr Kontext siehe die vorgelagerten Astral-Berichte: astral-sh/uv#13553, astral-sh/uv#15011, astral-sh/uv#10079.
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
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:
/model <name>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.
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.
| Aktion | CLI | Messaging-Plattformen |
|---|---|---|
| Chat starten | hermes | hermes gateway setup + hermes gateway start ausführen, dann dem Bot eine Nachricht senden |
| Neue Konversation starten | /new oder /reset | /new oder /reset |
| Modell wechseln | /model [provider:model] | /model [provider:model] |
| Persönlichkeit festlegen | /personality [name] | /personality [name] |
| Letzten Turn wiederholen/rückgängig machen | /retry, /undo | /retry, /undo |
| Kontext komprimieren / Nutzung prüfen | /compress, /usage, /insights [--days N] | /compress, /usage, /insights [days] |
| Fähigkeiten durchsuchen | /skills oder /<skill-name> | /<skill-name> |
| Aktuelle Arbeit unterbrechen | Ctrl+C oder neue Nachricht senden | /stop oder neue Nachricht senden |
| Plattformspezifischer Status | /platforms | /status, /sethome |
Für die vollständigen Befehlslisten siehe den CLI-Leitfaden und den Messaging-Gateway-Leitfaden.
Die gesamte Dokumentation befindet sich unter hermes-agent.nousresearch.com/docs:
| Abschnitt | Was abgedeckt wird |
|---|---|
| Quickstart | Installieren → Einrichten → erste Konversation in 2 Minuten |
| CLI-Nutzung | Befehle, Tastenkombinationen, Persönlichkeiten, Sitzungen |
| Konfiguration | Konfigurationsdatei, Anbieter, Modelle, alle Optionen |
| Messaging-Gateway | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
| Sicherheit | Befehlsfreigabe, DM-Pairing, Container-Isolation |
| Tools & Toolsets | 40+ Tools, Toolset-System, Terminal-Backends |
| Fähigkeitssystem | Prozedurales Gedächtnis, Skills Hub, Fähigkeiten erstellen |
| Speicher | Persistenter Speicher, Benutzerprofile, Best Practices |
| MCP-Integration | Beliebigen MCP-Server für erweiterte Fähigkeiten verbinden |
| Cron-Planung | Geplante Aufgaben mit Plattformzustellung |
| Kontextdateien | Projektkontext, der jede Konversation prägt |
| Architektur | Projektstruktur, Agent-Schleife, Schlüsselklassen |
| Mitwirken | Entwicklungseinrichtung, PR-Prozess, Codestil |
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:
~/.hermes/skills/openclaw-imports/--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.
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
MIT – siehe LICENSE.
Erstellt von Nous Research.
| Alle Befehle und Flags |
| Umgebungsvariablen | Vollständige Env-Var-Referenz |