nousresearch/hermes-agentDer Agent, der mit dir wächst
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7225/75e85ef6fecf5a6227985f2082e5b35331fceff4d8db03720c82a7d9ee8b7eea.png" alt="Hermes Agent" width="100%">
</p>
# Hermes Agent ☤
<p align="center">
<a href="https://hermes-agent.nousresearch.com/">Hermes Agent</a> | <a href="https://hermes-agent.nousresearch.com/">Hermes Desktop</a>
</p>
<p align="center">
<a href="https://hermes-agent.nousresearch.com/docs/"><img src="https://img.shields.io/badge/Docs-hermes--agent.nousresearch.com-FFD700?style=for-the-badge" alt="Dokumentation"></a>
<a href="https://discord.gg/NousResearch"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
<a href="https://github.com/NousResearch/hermes-agent/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="Lizenz: MIT"></a>
<a href="https://nousresearch.com"><img src="https://img.shields.io/badge/Built%20by-Nous%20Research-blueviolet?style=for-the-badge" alt="Entwickelt von Nous Research"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.zh-CN.md"><img src="https://img.shields.io/badge/Lang-%E4%B8%AD%E6%96%87-red?style=for-the-badge" alt="中文"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.ur-pk.md"><img src="https://img.shields.io/badge/Lang-%D8%A7%D8%B1%D8%AF%D9%88-green?style=for-the-badge" alt="اردو"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.es.md"><img src="https://img.shields.io/badge/Lang-Espa%C3%B1ol-orange?style=for-the-badge" alt="Español"></a>
</p>
**Der sich selbst verbessernde KI-Agent, entwickelt von [Nous Research](https://nousresearch.com).** Er ist der einzige Agent mit einer eingebauten Lernschleife — er erstellt Fähigkeiten aus Erfahrung, verbessert sie während der Nutzung, stößt sich selbst dazu an, Wissen zu bewahren, durchsucht seine eigenen vergangenen Gespräche und baut über Sitzungen hinweg ein immer tieferes Modell davon auf, wer du bist. Betreibe ihn auf einem 5-Dollar-VPS, einem GPU-Cluster oder einer serverlosen Infrastruktur, die im Leerlauf nahezu nichts kostet. Er ist nicht an deinen Laptop gebunden — sprich mit ihm über Telegram, während er auf einer Cloud-VM arbeitet.
Verwende jedes Modell, das du möchtest — [Nous Portal](https://portal.nousresearch.com), OpenRouter, OpenAI, deinen eigenen Endpunkt und [viele weitere](https://hermes-agent.nousresearch.com/docs/integrations/providers). Wechsle mit `hermes model` — keine Codeänderungen, keine Bindung.
<table>
<tr><td><b>Eine echte Terminal-Oberfläche</b></td><td>Vollständige TUI mit mehrzeiliger Bearbeitung, Autovervollständigung für Slash-Befehle, Gesprächsverlauf, Unterbrechen-und-Umleiten sowie Streaming-Tool-Ausgabe.</td></tr>
<tr><td><b>Lebt, wo du lebst</b></td><td>Telegram, Discord, Slack, WhatsApp, Signal und CLI — alles aus einem einzigen Gateway-Prozess. Transkription von Sprachnachrichten, plattformübergreifende Gesprächskontinuität.</td></tr>
<tr><td><b>Eine geschlossene Lernschleife</b></td><td>Vom Agenten kuratiertes Gedächtnis mit regelmäßigen Anstößen. 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. Dialektische Nutzermodellierung mit <a href="https://github.com/plastic-labs/honcho">Honcho</a>. Kompatibel mit dem offenen Standard <a href="https://agentskills.io">agentskills.io</a>.</td></tr>
<tr><td><b>Geplante Automatisierungen</b></td><td>Eingebauter Cron-Scheduler mit Zustellung an jede Plattform. Tägliche Berichte, nächtliche Backups, wöchentliche Audits — alles in natürlicher Sprache, unbeaufsichtigt ausgeführt.</td></tr>
<tr><td><b>Delegiert und parallelisiert</b></td><td>Erzeuge isolierte Subagenten für parallele Arbeitsströme. Wähle in Desktop unter Einstellungen → Modell → Subagenten deren Anbieter, Modell und Limits und wende dann die vollständige Route an. Schreibe Python-Skripte, die Tools per RPC aufrufen und mehrstufige Pipelines in Züge ohne Kontextkosten verwandeln.</td></tr>
<tr><td><b>Läuft überall, nicht nur auf deinem Laptop</b></td><td>Sieben Terminal-Backends — lokal, Docker, SSH, Singularity, Modal, Daytona und Vercel Sandbox. Daytona und Modal bieten serverlose Persistenz — die Umgebung deines Agenten schläft im Leerlauf ein und erwacht bei Bedarf, was zwischen Sitzungen nahezu nichts kostet. Betreibe ihn auf einem 5-Dollar-VPS oder einem GPU-Cluster.</td></tr>
<tr><td><b>Forschungsbereit</b></td><td>Batch-Trajektoriengenerierung, Trajektorienkompression für das Training der nächsten Generation von Tool-Calling-Modellen.</td></tr>
</table>
---
## Schnellinstallation
### Linux, macOS, WSL2
```bash
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 obige Linux/macOS-Einzeiler auch dort. Einen Fehler gefunden? Bitte [reiche Issues ein](https://github.com/NousResearch/hermes-agent/issues).
Führe dies in PowerShell aus:
```powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```
Der Quell-Installer delegiert Python 3.14, Node.js, npm, ripgrep, FFmpeg
und Python-Abhängigkeiten an PM. Wenn Git fehlt, legt er das verifizierte Git
for Windows-Archiv im Tool-Store von Hermes ab. Er ersetzt nicht dein System-Git.
Siehe [Installationsmethoden](https://hermes-agent.nousresearch.com/docs/getting-started/installation)
für das separate MSIX/App Installer-Paket und dessen Update-Verantwortung.
> **Android / Termux:** Für aarch64-Geräte ist ein signiertes APT-Repository verfügbar, mit einem `stable`-Kanal (getaggte Releases) und einem Vorab-`canary`-Kanal. Das Paket enthält Python, Node.js und die TUI. Verwende die [Termux-Anleitung](https://hermes-agent.nousresearch.com/docs/getting-started/termux), nicht das Desktop-/Server-Installationsskript.
>
> **Windows:** Natives Windows wird vollständig unterstützt — der obige PowerShell-Einzeiler installiert alles. Wenn du lieber WSL2 verwendest, funktioniert der Linux-Befehl auch dort. Die native Windows-Installation liegt unter `%LOCALAPPDATA%\hermes`; WSL2-Installationen liegen wie unter Linux unter `~/.hermes`.
Nach der Installation:
```bash
source ~/.bashrc # reload shell (or: source ~/.zshrc)
hermes # start chatting!
```
### Fehlerbehebung
#### Windows Defender oder Antivirus meldet `uv.exe` als Malware
Wenn Ihr Antivirus (Bitdefender, Windows Defender usw.) `uv.exe` aus dem Hermes-`bin`-Ordner (`%LOCALAPPDATA%\hermes\bin\uv.exe`) in Quarantäne verschiebt, handelt es sich um einen **Fehlalarm**. Die Datei ist Astrals `uv` — der Rust-Paketmanager für Python, den Hermes mitliefert, um seine Python-Umgebung zu verwalten. ML-basierte Antivirus-Engines melden häufig unsignierte Rust-Binärdateien, die Pakete herunterladen und installieren.
**So überprüfen Sie, ob Ihre Kopie authentisch ist:**
```powershell
# Install GitHub CLI if needed
winget install --id GitHub.cli
# Login to GitHub
gh auth login
# Run verification
$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“ meldet und die letzte Zeile `True` ausgibt, ist alles in Ordnung.
**So setzt du Hermes auf die Whitelist:**
- **Windows Defender:** PowerShell als Administrator ausführen → `Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"`
- **Bitdefender:** Eine Ausnahme in der Bitdefender-Konsole hinzufügen (Protection > Antivirus > Settings > Manage Exceptions)
- Setze den **Ordner** auf die Whitelist, nicht den Datei-Hash — Hermes aktualisiert `uv`, und der Hash ändert sich mit jeder Version
Für mehr Kontext siehe die Upstream-Berichte von Astral: [astral-sh/uv#13553](https://github.com/astral-sh/uv/issues/13553), [astral-sh/uv#15011](https://github.com/astral-sh/uv/issues/15011), [astral-sh/uv#10079](https://github.com/astral-sh/uv/issues/10079).
---
## Erste Schritte
```bash
hermes # Interactive CLI — start a conversation
hermes model # Choose your LLM provider and model
hermes tools # Configure which tools are enabled
hermes config set # Set individual config values
hermes config get # Print individual config values
hermes gateway # Start the messaging gateway (Telegram, Discord, etc.)
hermes setup # Run the full setup wizard (configures everything at once)
hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
hermes update # Update to the latest version
hermes doctor # Diagnose any issues
```
📖 **[Vollständige Dokumentation →](https://hermes-agent.nousresearch.com/docs/)**
---
## Das Sammeln von API-Schlüsseln überspringen — Nous Portal
Hermes funktioniert mit jedem Anbieter, den du möchtest — das ändert sich nicht. Aber wenn du lieber nicht fünf separate API-Schlüssel für das Modell, die Websuche, die Bilderzeugung, TTS und einen Cloud-Browser sammeln möchtest, deckt **[Nous Portal](https://portal.nousresearch.com)** alle diese Bereiche mit einem einzigen Abonnement ab:
- **300+ Modelle** — wähle ein beliebiges davon mit `/model <name>`
- **Tool Gateway** — Websuche, Bilderzeugung (FAL), Text-to-Speech (OpenAI), Cloud-Browser (Browser Use), alles über dein Abonnement geleitet. Keine zusätzlichen Konten.
Ein Befehl nach einer Neuinstallation:
```bash
hermes setup --portal
```
Damit meldest du dich per OAuth an, legst Nous als deinen Anbieter fest und aktivierst das Tool Gateway. Prüfe jederzeit mit `hermes portal info`, was eingerichtet ist. Vollständige Details findest du auf der [Tool Gateway-Dokumentationsseite](https://hermes-agent.nousresearch.com/docs/user-guide/features/tool-gateway).
Du kannst weiterhin jederzeit eigene Schlüssel pro Tool verwenden — das Gateway ist pro Backend, nicht alles oder nichts.
---
## CLI vs. Messaging Kurzreferenz
Hermes hat zwei Einstiegspunkte: Starte die Terminal-UI mit `hermes` oder führe das Gateway aus und kommuniziere darüber per Telegram, Discord, Slack, WhatsApp, Signal oder E-Mail. Sobald du dich in einer Unterhaltung befindest, werden viele Slash-Befehle in beiden Schnittstellen gemeinsam genutzt.
| Aktion | CLI | Messaging-Plattformen |
| ------------------------------ | --------------------------------------------- | -------------------------------------------------------------------------------- |
| Chat starten | `hermes` | Führe `hermes gateway setup` + `hermes gateway start` aus und sende dem Bot dann eine Nachricht |
| Neue Unterhaltung starten | `/new` oder `/reset` | `/new` oder `/reset` |
| Modell ändern | `/model [provider:model]` | `/model [provider:model]` |
| Eine Persönlichkeit festlegen | `/personality [name]` | `/personality [name]` |
| Letzten Turn wiederholen oder rückgängig machen | `/retry`, `/undo` | `/retry`, `/undo` |
| Kontext komprimieren / Nutzung prüfen | `/compress`, `/usage`, `/insights [--days N]` | `/compress`, `/usage`, `/insights [days]` |
| Skills durchsuchen | `/skills` oder `/<skill-name>` | `/<skill-name>` |
| Aktuelle Arbeit unterbrechen | `Ctrl+C` oder eine neue Nachricht senden | `/stop` oder eine neue Nachricht senden |
| Plattformspezifischer Status | `/platforms` | `/status`, `/sethome` |
Die vollständigen Befehlslisten findest du im [CLI-Leitfaden](https://hermes-agent.nousresearch.com/docs/user-guide/cli) und im [Messaging Gateway-Leitfaden](https://hermes-agent.nousresearch.com/docs/user-guide/messaging).
---
## Dokumentation
Die gesamte Dokumentation befindet sich unter **[hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs/)**:
| Abschnitt | Behandelte Inhalte |
| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [Quickstart](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) | Installation → Einrichtung → erstes Gespräch in 2 Minuten |
| [CLI-Nutzung](https://hermes-agent.nousresearch.com/docs/user-guide/cli) | Befehle, Tastenkürzel, Persönlichkeiten, Sitzungen |
| [Konfiguration](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) | Konfigurationsdatei, Anbieter, Modelle, alle Optionen |
| [Messaging-Gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) | Telegram, Discord, Slack, WhatsApp, Signal, Home Assistant |
| [Sicherheit](https://hermes-agent.nousresearch.com/docs/user-guide/security) | Befehlsfreigabe, DM-Pairing, Container-Isolierung |
| [Tools & Toolsets](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) | 40+ Tools, Toolset-System, Terminal-Backends |
| [Skills-System](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) | Prozedurales Gedächtnis, Skills Hub, Skills erstellen |
| [Gedächtnis](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) | Persistentes Gedächtnis, Benutzerprofile, Best Practices |
| [MCP-Integration](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) | Beliebigen MCP-Server für erweiterte Funktionen anbinden |
| [Cron-Planung](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) | Geplante Aufgaben mit Zustellung über Plattformen |
| [Kontextdateien](https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files) | Projektkontext, der jedes Gespräch prägt |
| [Architektur](https://hermes-agent.nousresearch.com/docs/developer-guide/architecture) | Projektstruktur, Agent-Loop, zentrale Klassen |
| [Mitwirken](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) | Entwicklungsumgebung, PR-Prozess, Code-Stil |
| [CLI-Referenz](https://hermes-agent.nousresearch.com/docs/reference/cli-commands) | Alle Befehle und Flags |
| [Umgebungsvariablen](https://hermes-agent.nousresearch.com/docs/reference/environment-variables) | Vollständige Referenz der Umgebungsvariablen |
---
## Migration von OpenClaw
Wenn Sie von OpenClaw kommen, kann Hermes Ihre Einstellungen, Erinnerungen, Skills und API-Schlüssel automatisch importieren.
**Beim erstmaligen Einrichten:** Der Einrichtungsassistent (`hermes setup`) erkennt `~/.openclaw` automatisch und bietet die Migration an, bevor die Konfiguration beginnt.
**Jederzeit nach der Installation:**
```bash
hermes claw migrate # Interactive migration (full preset)
hermes claw migrate --dry-run # Preview what would be migrated
hermes claw migrate --preset user-data # Migrate without secrets
hermes claw migrate --overwrite # Overwrite existing conflicts
```
Was importiert wird:
- **SOUL.md** — Persona-Datei
- **Memories** — Einträge aus MEMORY.md und USER.md
- **Skills** — benutzerdefinierte Skills → `~/.hermes/skills/openclaw-imports/`
- **Command-Allowlist** — Genehmigungsmuster
- **Messaging-Einstellungen** — Plattformkonfigurationen, erlaubte Benutzer, Arbeitsverzeichnis
- **API-Schlüssel** — freigegebene Secrets (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
- **TTS-Assets** — Audiodateien im Workspace
- **Workspace-Anweisungen** — AGENTS.md (mit `--workspace-target`)
Siehe `hermes claw migrate --help` für alle Optionen oder nutze den Skill `openclaw-migration` für eine interaktive, agentengesteuerte Migration mit Dry-Run-Vorschauen.
---
## Mitwirken
Wir freuen uns über Beiträge! Siehe den [Contributing Guide](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) für die Entwicklungsumgebung, den Code-Stil und den PR-Prozess.
Beginne mit dem [PM-Entwickler-Workflow](https://github.com/nousresearch/hermes-agent/blob/main/website/docs/reference/package-management.md#developer-workflow)
für Aktivierung, tägliche Nutzung, Abhängigkeitsänderungen und das Verlassen der Umgebung.
[Development Setup](https://github.com/nousresearch/hermes-agent/blob/main/CONTRIBUTING.md#development-setup) behandelt die separate Testumgebung und die Verifikationsbefehle.
---
## Community
- 💬 [Discord](https://discord.gg/NousResearch)
- 📚 [Skills Hub](https://agentskills.io)
- 🐛 [Issues](https://github.com/NousResearch/hermes-agent/issues)
- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — MCP-Server zur Linux-Desktop-Steuerung für Hermes und andere MCP-Hosts, mit AT-SPI-Accessibility-Bäumen, Wayland/X11-Eingabe, Screenshots und Compositor-Fenster-Targeting.
- 🔌 [HermesClaw](https://github.com/AaronWong1999/hermesclaw) — Community-WeChat-Bridge: Hermes Agent und OpenClaw im selben WeChat-Konto ausführen.
---
## Lizenz
MIT — siehe [LICENSE](https://github.com/nousresearch/hermes-agent/blob/main/LICENSE).
Entwickelt von [Nous Research](https://nousresearch.com).