knowledge-base/wiki/tools/hermes-desktop.md

244 lines
15 KiB
Markdown

---
created: 2026-06-22
updated: 2026-06-25
sources: [youtube/2026-06-22_jonas-keil-hermes-desktop.md, youtube/2026-06-24_alex-finn-hermes-agent-v0170-reach.md, youtube/2026-06-24_peter-yang-hermes-full-course.md]
tags: [tools, hermes-agent, hermes-desktop, nous-research, desktop-app, electron, react, gui, openclaw-migration, self-improving, v0.17.0, reach]
---
# Hermes Desktop — Native GUI für Hermes Agent
> **Quelle:**
> - YouTube-Video "Hermes DESKTOP ist der WAHNSINN!!" von [Jonas Keil](https://www.youtube.com/@JonasKeil) (AI Trainer), 22.06.2026 → [Raw-Datei](../../raw/youtube/2026-06-22_jonas-keil-hermes-desktop.md)
> - YouTube-Video "The new Hermes Agent update has me speechless...." von [Alex Finn](https://www.youtube.com/@AlexFinnOfficial), 24.06.2026 → [Raw-Datei](../../raw/youtube/2026-06-24_alex-finn-hermes-agent-v0170-reach.md)
> - YouTube-Video "Hermes Full Course: Build Your 24/7 AI Chief of Staff in 45 Minutes" von Peter Yang, 24.06.2026 → [Raw-Datei](../../raw/youtube/2026-06-24_peter-yang-hermes-full-course.md)
> **Offizielle Doku:** [hermes-agent.nousresearch.com/docs/user-guide/desktop](https://hermes-agent.nousresearch.com/docs/user-guide/desktop)
> **Background:** [Ewan Mak, Medium Juni 2026](https://medium.com/@tentenco/hermes-agent-desktop-app-everything-you-need-to-know-about-nous-researchs-self-improving-ai-agent-3cb59bd31e5f)
## Was ist Hermes Desktop?
[Hermes Agent](https://hermes-agent.nousresearch.com) von [Nous Research](https://nousresearch.com/) hat am **2. Juni 2026** seine offizielle Desktop-App veröffentlicht (Public Preview, v0.15.2). Sie ist eine native Applikation für **macOS, Windows und Linux**, gebaut auf **Electron + React** mit **Python-Backend**.
Die Desktop-App ist **kein separates Produkt** — sie nutzt denselben Agent-Core wie CLI und Gateway: same config, same API keys, same sessions, same skills, same memory. Was im Terminal eingerichtet wurde, erscheint in der Desktop-App und umgekehrt.
> **Hector-Einordnung:** *"Telegram tot, CLI tot, das ist die Zukunft"* — so beschrieb ein verlinktes Video den Paradigmenwechsel. Die Desktop-App rückt Hermes in Reichweite der nicht-terminal-affinen Nutzergruppe und positioniert es als ersten ernsthaften GUI-Konkurrenten zu Claude Code's VSCode-Integration.
---
## 🚀 Hermes v0.17.0 — "The Reach Release" (19. Juni 2026)
Am **19. Juni 2026** veröffentlichte Nous Research das Major-Update **v0.17.0** unter dem Codenamen **"The Reach Release"**. Der Fokus liegt auf der Ausweitung der Kanäle (Reach), in denen Hermes agieren kann, tieferer Werkzeugintegration und verbesserter Steuerung.
### Die wichtigsten Neuerungen in v0.17.0:
#### 1. Native iMessage Integration (via Photon Spectrum)
- **Kein Mac-Relay erforderlich:** Bisherige Lösungen wie BlueBubbles benötigten einen permanent laufenden Mac im Schrank.
- **Photon Spectrum:** Nutzt einen verwalteten Line-Pool von Photon. Die Anmeldung erfolgt direkt über `hermes photon login` via Device-Code.
- **Einfachheit:** Gratis Einstieg, keine eigene Hosting-Infrastruktur oder iMessage-Brücke notwendig. Hermes kann direkt in den blauen iMessage-Bubbles chatten und agieren.
#### 2. Background / Async Subagents (Asynchrones Arbeiten)
- **Parallele Tasks:** Über `delegate_task(background=true)` startet Hermes asynchrone Subagents, die im Hintergrund arbeiten.
- **Bypass Blocking:** Der Haupt-Agent (oder der Nutzer) kann parallel weiterarbeiten, anstatt auf die Fertigstellung eines langen Research-Dives oder Multi-Step-Builds zu warten.
- **Watch-Windows:** Die Desktop-App hat spezielle Live-Panes erhalten, in denen die Aktivität des Hintergrund-Subagents gestreamt wird. Das Ergebnis fließt nach Fertigstellung nahtlos als neuer Turn zurück in die Haupt-Konversation.
#### 3. Image-to-Image Editing in `image_generate`
- **Bildbearbeitung:** Das `image_generate`-Tool kann nun bestehende Bilder modifizieren statt sie nur neu zu generieren.
- **Prompts:** Anweisungen wie *"make this logo blue"* oder *"remove the background"* werden an die Edit-Endpunkte der unterstützten Bild-Provider (wie DALL-E 3 oder Gemini) geroutet.
#### 4. Automation Blueprints (Cron-freies Scheduling)
- **No-Code Automatisierung:** Statt komplexer Cron-Syntax (`0 8 * * *`) definieren Blueprints wiederkehrende Aufgaben (z.B. *"Tägliches News-Briefing um 8 Uhr"*).
- **Interaktiver Dialog:** Hermes erfragt alle notwendigen Parameter über native Formulare im Dashboard, Slash-Commands oder im normalen Chat.
#### 5. Cursor Composer via Grok-Subscription
- **High-Speed Coding:** `grok-composer-2.5-fast` (das Modell hinter Cursors Composer) ist nun direkt im xAI OAuth Model-Picker verfügbar.
- **Vorteil:** Nutzer mit einem bestehenden xAI Grok-Abonnement können das Modell mit vollem 200k-Kontextfenster im Hermes-Agent-Loop nutzen, ohne einen separaten API-Key zu benötigen.
#### 6. Atomares Memory-Upgrade
- **Batch-Edits:** Das `memory`-Tool unterstützt nun ein `operations`-Array für atomare Batch-Operationen (gleichzeitiges Hinzufügen, Ersetzen und Löschen).
- **Vorteil:** Verhindert das Scheitern von Speicher-Updates bei Budget-Limits. Ein Eintrag kann gelöscht und ein neuer hinzugefügt werden im exakt selben Call, ohne das Token-Limit zu sprengen.
#### 7. Weitere Kanal- & API-Upgrades
- **Raft Agent Network:** Bundled Raft-Adapter bindet Hermes an das Raft-Netzwerk ([raft.build](https://raft.build/)) an. Datensparsamkeit durch "Privacy-by-Contract" (Payloads tragen nur Event-IDs und Timestamps, keine Nachrichten-Bodys).
- **Offizielle WhatsApp Cloud API:** Neben der inoffiziellen Baileys-Brücke spricht Hermes nun nativ mit Meta's offizieller WhatsApp Business Cloud API (kein QR-Code scannen, stabiler Betrieb).
- **Telegram Rich Text (Bot API 10.1):** Automatische Formatierung der Antworten als Rich Messages (bessere Headers, Tabellen-Ersatz, Spoilers).
#### 8. Curation Cost Optimization
- Der Skill-Curator bereinigt inaktive Skills deterministisch und kostenlos. LLM-basierte Konsolidierungs-Passes (Zusammenfassung von Skills) sind nun standardmäßig deaktiviert und müssen explizit via `curator.consolidate: true` aktiviert werden, was Tokens und Kosten spart.
---
## Architektur
### Tech-Stack
| Komponente | Technologie |
|------------|-------------|
| **Shell** | Electron |
| **Frontend** | React (native chat surface) |
| **Backend** | Python (Hermes Agent runtime) |
| **Kommunikation** | `tui_gateway`/dashboard APIs (WebSocket) |
| **Install-Pfad** | `~/.hermes` (macOS/Linux), `%LOCALAPPDATA%\hermes` (Windows) |
### Backend-Resolution
Beim Start resolved die App den Hermes-Backend in folgender Priorität:
1. `HERMES_DESKTOP_HERMES_ROOT` (Umgebungsvariable)
2. Managed Install (wird bei erstem Launch angelegt)
3. `hermes` auf `PATH` (existierende CLI-Installation)
4. `HERMES_DESKTOP_HERMES` (expliziter Override, z. B. für Nix)
### Interoperabilität
- `hermes desktop` startet die App aus der CLI heraus
- Sessions, die in CLI/TUI begonnen wurden, können in der Desktop-App fortgesetzt werden und umgekehrt
- Profile sind isoliert (eigene Config, Skills, Sessions)
- Multi-Profile-Sessions: Sessions über mehrere Profile hinweg, Cross-Profile `@session`-Links
---
## Feature-Übersicht
### Chat
- **Streaming-Responses** mit Live-Tool-Activity und strukturierten Tool-Call-Summaries
- **Drag-and-drop** Datei-Anhänge
- **Right-hand preview rail** — rendert Web-Pages, Files und Tool-Outputs parallel zum Chat
- **Composer history** — Arrow-Up/Down recalls vorherige Prompts; Queue-Editing vor Versand
- **Per-session YOLO toggle** — Dangerous-command approval bypass per Session (siehe [Security → YOLO Mode](https://hermes-agent.nousresearch.com/docs/user-guide/security#yolo-mode))
### Model Picker
- Lebt im Composer (links vom Mikrofon)
- Sticky UI state — nie geschrieben ins Profile-Default
- Pro-Model effort/fast presets werden pro Modell gespeichert
- Default-Modell wird in Settings → Model gesetzt (per-Profile)
### File Browser
- Erkundet das Arbeitsverzeichnis ohne die App zu verlassen
- Init: `hermes desktop --cwd <path>` oder `HERMES_DESKTOP_CWD`
### Voice Mode
- Talk to Hermes, hear it back — gleiche Voice-Mode-Implementierung wie CLI
- macOS: einmaliger Microphone-Access-Prompt
### Settings & Onboarding
- **GUI-basierte Konfiguration** statt YAML-Editing
- Providers/Keys, Model Selection, Toolset Config, MCP Servers, Gateway, Session Management
- **First-run onboarding** — "Choose provider later" möglich, um direkt in die App zu kommen
- **Tool-backend installs** aus der GUI heraus (kein Terminal nötig)
- **Auxiliary-model warning** — warnt wenn Main- und Auxiliary-Tasks auf verschiedenen Providern landen
### Management Panes
- **Skills** — browsen, installieren, verwalten
- **Cron** — scheduled jobs, natural-language setup
- **Profiles** — isolierte Config/Skills/Sessions
- **Messaging** — Gateway-Channel-Setup
- **Agents** & **Command Center** — Multi-Agent-Orchestrierung
### Keyboard & Navigation
- **Command palette** — Cmd+K (macOS) / Ctrl+K (Win/Linux)
- **Rebindable shortcuts** — eigener Key-Mapping
- **Custom zoom** — half-step increments
- **UI language switcher** — inkl. zh-Hans (Simplified Chinese)
### Session Management
- **Session-list overhaul** — Archiving, Search by ID
- **Concurrent multi-profile sessions**
---
## Remote Backend
Die Desktop-App kann sich mit einem **remote Hermes-Backend** verbinden — einer `hermes dashboard`-Instanz auf VPS, Home-Server oder Mac Mini hinter Tailscale. Die App fungiert dann als grafischer Remote-Client. Auth-Gate, `/api/ws` chat socket und WebSocket close-code triage sind in der [Web-Dashboard-Doku](https://hermes-agent.nousresearch.com/docs/user-guide/features/web-dashboard) beschrieben.
---
## OpenClaw-Migration
Zegleich mit der Desktop-App erschien `hermes claw migrate` — ein eingebautes Migrationstool für [OpenClaw](../tools/openclaw.md)-Nutzer:
| Feature | Beschreibung |
|---------|-------------|
| **Dry-run** | Preview der Migration vor Ausführung |
| **Selective presets** | Auswählen, was migriert wird |
| **Conflict overwrite** | Steuerung bei Konflikten |
| **Auto-detect** | Erkennt `~/.openclaw` automatisch |
| **Non-destructive** | OpenClaw-Files werden gelesen, nie modifiziert |
### Was wird migriert?
- Configuration, Memory, Skills, API Keys, Messaging Platform Settings
- Simple Skills konvertieren sauber; komplexe Skills mit conditional logic brauchen manuelles Review
### Signal
Die Existenz des Migrationstools ist eine explizite Positionierung: Nous Research sieht OpenClaw-Nutzer als Migrationszielgruppe. Das YouTube-Video "you need to use Hermes RIGHT NOW!! (goodbye OpenClaw!!)" auf Jonas Keils Kanal unterstreicht diese Narrative.
---
## Hermes vs. OpenClaw — Architektur-Philosophie
| Dimension | [Hermes Agent](https://hermes-agent.nousresearch.com) | [OpenClaw](openclaw.md) |
|-----------|-------------|----------|
| **GitHub-Stars** | 180.000+ (in 4 Monaten seit Feb 2026) | 374.000+ |
| **Lizenz** | MIT | OSS |
| **Stärke** | **Learning Depth** — Closed Learning Loop, Self-Improvement | **Ecosystem Breadth** — 5.700+ Community Skills, ClawHub |
| **Skills** | ~118 built-in (selbstgenerierend via Self-Improvement) | 5.700+ Community Skills |
| **Memory** | Persistent cross-session, SQLite FTS + LLM Summarization | Flat-File + optionale Graph-DB (LanceDB→GBrain) |
| **Self-Improvement** | ✅ Evaluiert Outcomes, extrahiert Patterns → Skill-Files | ❌ (manuell) |
| **Efficiency Gain** | ~40% weniger Token/Zeit bei repetitiven Tasks (mit 20+ Skills, TokenMix bestätigt April 2026) | — |
| **Security CVEs** | 0 bekannt (Stand April 2026), built-in Prompt-Injection-Scanning + Credential Filtering | 9 CVEs in 4 Tagen (März 2026, max CVSS 9.9) |
| **Desktop-App** | ✅ Offiziell (2. Juni 2026, massiv ausgebaut in v0.17.0) | ❌ (CLI/Telegram-basiert) |
| **Migrationstool** | `hermes claw migrate` (eingebaut) | — |
| **Messaging** | Telegram, iMessage (Photon), WhatsApp, Raft, Discord, Slack, Signal, Email | 24+ Plattformen |
---
## Kostenstruktur
| Komponente | Kosten |
|------------|--------|
| **Hermes Agent** | MIT-Lizenz, gratis |
| **Nous Portal Free** | $0.10/monat Credit (nur Evaluation) |
| **Nous Portal Plus** | $20/monat — 300+ Models, built-in Tools (Web Search, Image Gen, TTS, Browser Automation) |
| **Alternative Provider** | 20+ (OpenRouter, Anthropic, OpenAI, Ollama, vLLM) — eigene Keys |
| **VPS** | Hetzner CX22 $4.35/monat (beliebt in Community) |
| **LLM-API** | ~$0.30 pro komplexem Task (Budget-Modelle) |
---
## Bekannte Limitationen
- **Windows-Installer** nicht code-signed → SmartScreen-Warnung
- **Linux** noch via Terminal-Installation (`curl` script mit `--include-desktop` flag)
- **Self-evolving Skills** = Black Box — Skill-Files sind Markdown (lesbar), aber die Decision-Logic für Skill-Retention/Modifikation hat keine Explainability-Schnittstelle
- **Nous Portal Free-Tier** nur für Evaluation; tägliche Nutzung braucht Plus oder eigene Keys
---
## CLI-Referenz
```bash
hermes desktop # Standard: install + build + launch
hermes desktop --skip-build # Vorhandene unpacked App starten
hermes desktop --force-build # Full rebuild erzwingen
hermes desktop --build-only # Build ohne Launch (für Updates)
hermes desktop --source # Dev-Mode via electron .
hermes desktop --cwd PATH # Initiales Project-Verzeichnis setzen
hermes desktop --ignore-existing # CLI auf PATH ignorieren
```
---
## Relevanz für RamaDama / OpenClaw
- **Konkurrenz-Analyse:** Hermes v0.17.0 ("Reach") weitet seine Präsenz drastisch aus. Vor allem die iMessage-Integration über Photon nimmt viel Reibung aus dem iMessage-Setup.
- **Asynchrones Arbeiten:** Mit Hintergrund-Subagents und dazugehörigen Watch-Windows in der Desktop-App hat Hermes einen extrem flüssigen Multitasking-Workflow etabliert.
- **Plattform-Verbreiterung:** Neben der WhatsApp Cloud API und dem Raft Agent Network ist auch die verbesserte Telegram Bot API 10.1 Rich Text Unterstützung ein direkter Angriff auf OpenClaws Messaging-Stärke.
- **Kosten-Sensibilität:** Die Abschaltung der LLM-Curator-Konsolidierung standardmäßig zeigt, dass auch Nous Research die Tokenkosten im Dauerbetrieb optimieren muss.
---
## Verwandte Wiki-Seiten
- [[../tools/openclaw.md]] — OpenClaw (Vergleichs-Framework)
- [[../concepts/llm/real-world-coding-showdown.md]] — Hermes Agent als Test-Framework für Coding-Modelle
- [[../tools/ecosystem-tools-april-2026.md]] — Hermes Atlas als Competitor (April 2026)
- [[../concepts/agents/ai-agents-2026.md]] — AI-Agent-Landschaft 2026
- [[../concepts/agents/subconscious-agent.md]] — Subconscious Agent (verwandte Self-Improvement-Architektur)
- [[../architecture/memory-system.md]] — Memory-Architektur-Vergleich