Hermes AI unter Windows installieren: Desktop, PowerShell und WSL2

Hermes Agent unterstützt Windows 10 und Windows 11. Benutzern stehen drei Bereitstellungsszenarien zur Verfügung: die native Ausführung über PowerShell, die Desktop-Anwendung Hermes Desktop und die WSL2-Umgebung. Die Wahl hängt von Ihren erforderlichen Build-Tools, den Terminal-Anforderungen und der Dateisystemarchitektur ab.

Installationspfad wählen: Native Umgebung vs. WSL2

Vor der Installation ist es wichtig, den Ausführungskontext für Ihre Aufgaben festzulegen:

• Native PowerShell und Hermes Desktop nutzen dieselbe Datenstruktur: Quellcode und die virtuelle Umgebung befinden sich im Verzeichnis %LOCALAPPDATA%\hermes\hermes-agent, während Benutzereinstellungen, Sitzungsverlauf und Skills unter %LOCALAPPDATA%\hermes gespeichert werden. Die grafische Oberfläche und das Konsolen-CLI sind austauschbar und arbeiten auf exakt demselben Zustand.
• WSL2 isoliert die Umgebung innerhalb einer virtuellen Linux-Maschine und speichert die Konfiguration separat unter ~/.hermes.

Beispiele für die Architekturauswahl

1. Windows-zentrierte Projekte (PowerShell / .NET / System-Dienstprogramme): Wenn Sie Host-Workflows automatisieren, Hintergrund-Gateways für Telegram oder Discord über die Windows-Aufgabenplanung betreiben und mit lokalen Dateien auf einem NTFS-Laufwerk arbeiten, wählen Sie native PowerShell oder Hermes Desktop.
2. Projekte mit Linux-Stack (Docker, Make, POSIX-Skripte): Wenn Ihr Agent Linux-Binärdateien kompilieren, mit UNIX-Sockets interagieren oder Sitzungen über das integrierte Terminal des Web-Dashboards verwalten muss, stellen Sie den Agenten in WSL2 bereit. In nativen Windows-Builds unterstützt das Web-Dashboard Metriken und Konfiguration, aber der integrierte Terminal-Reiter /chat erfordert ein POSIX-PTY und ist nur unter WSL2 verfügbar.

---

Option 1: Native Installation über PowerShell

Der native Installer erfordert keine Administratorrechte und richtet automatisch den Paketmanager uv, eine isolierte Python 3.11-Laufzeitumgebung, Node.js für Browser-Automatisierungstools sowie PortableGit ein. Eine manuelle globale Python-Installation auf Ihrem System ist nicht erforderlich.

Öffnen Sie eine Standard-PowerShell-Konsole und führen Sie folgenden Befehl aus:

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

Das Skript fügt den Pfad %LOCALAPPDATA%\hermes\bin zur Umgebungsvariable PATH des aktuellen Benutzers hinzu. Schließen Sie nach Abschluss das Konsolenfenster und öffnen Sie ein neues Terminal, um den aktualisierten PATH zu übernehmen. Detaillierte Skriptparameter finden Sie im offiziellen Leitfaden zu Windows Native.

---

Option 2: Grafischer Client Hermes Desktop

Hermes Desktop bietet eine Fensteroberfläche mit einer Sitzungs-Seitenleiste, einem visuellen Skill-Graphen, Tab-Unterstützung und der Verwaltung paralleler Agenten.

1. Laden Sie den Installer von der Seite der Dokumentation zu Hermes Desktop herunter.
2. Führen Sie die Installationsdatei aus. Beim ersten Start führt die Anwendung automatisch das Skript zur Abhängigkeitseinrichtung im Verzeichnis %LOCALAPPDATA%\hermes aus.

Wenn Sie den Agenten bereits über PowerShell konfiguriert haben, übernimmt die Desktop-Anwendung bestehende API-Schlüssel und gespeicherte Konversationen sofort.

---

Option 3: Installation in WSL2

WSL2 bietet eine Standard-Linux-Umgebung (ext4-Dateisystem, POSIX-Signale, PTY-Unterstützung).

Schritt 1. WSL2 vorbereiten

Führen Sie in einer PowerShell-Konsole mit Administratorrechten (Als Administrator ausführen) folgenden Befehl aus:

wsl --install

Starten Sie den Computer neu, falls das System dies verlangt, und legen Sie anschließend Ihren Linux-Benutzernamen und Ihr Passwort fest. Überprüfen Sie danach die Distributionsversion:

wsl --list --verbose

Stellen Sie sicher, dass in der Spalte VERSION für die ausgewählte Distribution (standardmäßig Ubuntu) der Wert 2 angezeigt wird.

Schritt 2. Hermes Agent bereitstellen

Öffnen Sie Ihr Ubuntu-Terminal und führen Sie den Installationsbefehl gemäß der WSL2-Schnellstartanleitung aus:

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

Wichtig: Speichern Sie Arbeits-Repositories und Projektdateien innerhalb des Linux-Dateisystems (z. B. ~/projects/) und nicht auf einem eingebundenen Windows-Laufwerk (/mnt/c/). Umgebungsübergreifende Dateizugriffe über das 9P-Protokoll können zu langsameren I/O-Vorgängen und trägem git-Verhalten führen.

---

Umgebungsüberprüfung und erster Start

Diagnose und Ausführung müssen im jeweiligen Terminal der entsprechenden Umgebung durchgeführt werden: Verwenden Sie für native Installationen und Hermes Desktop die PowerShell und für WSL2 das Ubuntu-Terminal.

Öffnen Sie für native Installationen und Hermes Desktop eine neue PowerShell-Sitzung und führen Sie folgende Überprüfung durch:

Get-Command hermes
hermes --version
hermes doctor

Öffnen Sie für WSL2-Installationen das Ubuntu-Terminal und führen Sie die Diagnose aus:

command -v hermes
hermes --version
hermes doctor

Der Befehl hermes doctor prüft die Pfadauflösung für git, die Chromium-Browser-Engine und Hilfsbibliotheken.

Vor dem Starten eines Chats muss der Modell-Provider konfiguriert werden: Falls dies noch nicht geschehen ist, führen Sie zuerst hermes setup aus und wählen Sie Ihren Modell-Provider (in der PowerShell für die native Umgebung oder im Ubuntu-Terminal für WSL2).

Starten Sie nach der Konfiguration eine reguläre Konversation im entsprechenden Terminal und testen Sie diese mit einer Aufgabe, die keine Schreibzugriffe auf Dateien erfordert; beachten Sie, dass hermes chat keine Rechte-Isolation erzwingt:

hermes chat

Übergeben Sie als erste Anfrage eine Anweisung, die keine Schreibvorgänge auf die Festplatte erfordert (wie z. B. die Erklärung eines Architekturbegriffs). Das erwartete Ergebnis ist eine erfolgreiche Initialisierung des konfigurierten Modell-Providers und eine saubere Textausgabe im Streaming-Verfahren ohne Codierungsfehler.

Details zur optionalen Konfiguration einzelner Modelle finden Sie in der BetterToken-Dokumentation.

---

Häufige Probleme beheben

Beobachtetes Symptom	Ursache	Lösung
hermes: The term 'hermes' is not recognized	Die aktive Konsolensitzung hat den aktualisierten User PATH noch nicht neu geladen.	Starten Sie das PowerShell-Fenster neu oder rufen Sie die Binärdatei direkt auf: & "$env:LOCALAPPDATA\hermes\bin\hermes.exe".
Der /chat-Reiter im Web-Dashboard zeigt ein Fehlerbanner	Natives Windows verfügt über keine POSIX-PTY-Systemmechanismen.	Sitzungs- und Aufgabenverwaltung funktionieren nativ, für das Web-Terminal unter /chat führen Sie den Agenten jedoch über WSL2 aus.
WinError 193: %1 is not a valid Win32 application	Versuch, ein Skript direkt ohne den .cmd-Wrapper aufzurufen.	Führen Sie Node- und npm-Tools unter Windows mit expliziter Erweiterung aus (z. B. npx.cmd).
Fragezeichen (?) anstelle von Unicode-Zeichen im CLI	Veralteter Konsolen-Host ohne Unterstützung für CP 65001.	Verwenden Sie Windows Terminal. Stellen Sie sicher, dass die Umgebungsvariable HERMES_DISABLE_WINDOWS_UTF8 nicht auf 1 gesetzt ist.
Hohe Latenz bei git status in WSL2	Das Projekt-Arbeitsverzeichnis befindet sich unter /mnt/c/....	Verschieben Sie das Arbeits-Repository in das Home-Verzeichnis der Linux-Distribution (~/code/...), um die native ext4-Leistung zu nutzen.