Zum Inhalt springen
Geprüft auf Hermes Agent v0.22.5 · 25.10.2026

Hermes Agent installieren: alle Wege, alle Befehle

Die Installation selbst dauert wenige Minuten. Plan rund eine halbe Stunde ein, bis Modell und erster Messenger laufen.

Welcher Weg passt zu dir?

Du willst einfach loslegen, Windows oder Mac Desktop-App Linux, Mac oder Windows mit WSL2, gern im Terminal Terminal-Installation Windows ohne WSL Windows nativ (PowerShell) Hermes soll rund um die Uhr laufen, auch für Telegram und Co. Server oder VPS Du arbeitest sowieso mit Containern Docker

1. Desktop-App (Windows und Mac)

Lade das Paket auf hermes-agent.nousresearch.com herunter. Es enthält den Agenten, Python und alle Abhängigkeiten, beim ersten Start wird nichts nachgebaut.

  • ✓Windows: die Datei .appinstaller öffnen. Windows installiert das signierte Paket und hält es aktuell.
  • ✓Mac: die DMG öffnen und Hermes.app in den Ordner Programme ziehen. Nur für Apple Silicon (M1 und neuer).

Hast du Hermes schon im Terminal installiert, startest du die App mit:

$ hermes desktop

2. Terminal: Linux, Mac und WSL2

Ein Befehl. Der Installer holt den Code, bringt seine eigene Python-Version mit (aktuell 3.14) und legt den Befehl hermes an. Voraussetzung sind nur Git, curl und tar.

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

Danach die Shell neu laden und starten:

$ source ~/.bashrc
$ hermes

Ubuntu, Debian und andere Distributionen funktionieren gleich. Fehlt auf einem schlanken System die Bibliothek libatomic, installiert der Installer sie nach und fragt dafür einmal nach deinem sudo-Passwort.

3. Windows nativ (PowerShell)

Ohne WSL, direkt in der PowerShell. Fehlt Git, bringt der Installer eine eigene Version mit.

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

Nativ oder WSL2? Nativ ist einfacher. WSL2 lohnt sich, wenn du ohnehin mit Linux-Werkzeugen arbeitest.

4. Server oder VPS: Hermes rund um die Uhr

Damit Hermes auch nachts Aufgaben erledigt und auf Telegram antwortet, braucht er einen Rechner, der immer läuft. Die Installation ist dieselbe wie unter Linux. Drei Dinge machen den Unterschied:

  1. Per SSH verbinden, nicht über die Browser-Konsole des Hosters. Die verändert beim Einfügen Zeichen und zerstört Befehle unbemerkt.
  2. Als eigener Benutzer installieren, unter dem Hermes später läuft, nicht als root.
  3. Den Dienst dauerhaft laufen lassen, auch wenn du dich abmeldest: Messenger einrichten, Gateway als Hintergrunddienst installieren, Status prüfen.
$ sudo loginctl enable-linger DEIN_BENUTZER
$ hermes gateway setup
$ hermes gateway install
$ hermes gateway status

Proxmox: eine VM oder ein LXC-Container mit Debian oder Ubuntu, darin die normale Linux-Installation.

5. Docker

Das offizielle Image heißt nousresearch/hermes-agent. Alle Daten (Einstellungen, Schlüssel, Chats, Skills) liegen in einem Ordner, den du nach /opt/data einbindest. Erst einrichten, dann dauerhaft starten:

$ mkdir -p ~/.hermes && docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup
$ docker run -d --name hermes --restart unless-stopped -v ~/.hermes:/opt/data nousresearch/hermes-agent gateway run

Updates im Container nicht mit hermes update, sondern mit docker pull nousresearch/hermes-agent:latest und einem Neustart des Containers. Die Desktop-App ist im Image nicht enthalten.

Nach der Installation: einrichten

Diese fünf Befehle brauchst du am Anfang. Der erste erledigt fast alles auf einmal.

$ hermes setup

Der Einrichtungs-Assistent: Modell, Werkzeuge und Messenger in einem Durchgang.

$ hermes model

Modell und Anbieter wählen oder später wechseln.

$ hermes config set display.language de

Oberfläche auf Deutsch umstellen.

$ hermes gateway setup

Telegram, WhatsApp, Slack oder andere Messenger anbinden.

$ hermes doctor

Gesundheitscheck: zeigt, was fehlt und wie du es behebst.

Abkürzung: Mit hermes setup --portal meldest du dich beim Nous Portal an. Ein Abo deckt dann viele Modelle plus Websuche, Bilder und Sprachausgabe ab. Bei Firmendaten vorher die Datenschutzbedingungen des Portals prüfen.

Wenn es hakt

hermes: command not found Shell neu laden mit source ~/.bashrc (oder ~/.zshrc) oder ein neues Terminal öffnen.
API key not set Mit hermes model einen Anbieter einrichten.
Einstellungen fehlen nach einem Update hermes config check, danach hermes config migrate.
Befehl kommt auf dem Server verstümmelt an Nicht die Browser-Konsole des Hosters nutzen, sondern per SSH verbinden. Browser-Konsolen verändern beim Einfügen Zeichen wie : oder @.

Aktualisieren geht später mit hermes update. Was beim Sprung auf 0.22 zu beachten ist, steht in der Update-Checkliste. Du kommst von OpenClaw? Dann lies den Vergleich mit Umzugsanleitung.

Lieber einrichten lassen?

Wir installieren Hermes als B.R.A.I.N. für dein Unternehmen: auf Managed Hosting bei Mittwald in Deutschland, mit deinen Mails, Terminen und deinem Wissen. Der Server gehört dir.

B.R.A.I.N. ansehen

Häufige Fragen

Wie installiere ich Hermes Agent?

Am einfachsten über die Desktop-App von der Hermes-Website (Windows und Mac). Im Terminal unter Linux, Mac oder WSL2 genügt ein Befehl: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash. Danach richtest du mit hermes setup Modell und Messenger ein.

Läuft Hermes Agent unter Windows?

Ja, auf zwei Wegen: nativ mit der Desktop-App oder dem PowerShell-Befehl iex (irm https://hermes-agent.nousresearch.com/install.ps1), oder unter WSL2 mit der Linux-Installation. WSL2 ist sinnvoll, wenn du ohnehin mit Linux-Werkzeugen arbeitest.

Läuft Hermes Agent auf einem Mac mit Intel-Prozessor?

Nein. Für macOS unterstützt Hermes nur Apple Silicon (M1 und neuer). Intel-Macs sind laut Dokumentation keine unterstützte Plattform.

Muss ich Python selbst installieren?

Nein. Der Installer bringt eine eigene, festgelegte Python-Version mit (aktuell 3.14), dazu Node.js, ripgrep und FFmpeg. Auf dem Rechner brauchst du für die Terminal-Installation nur Git, curl und tar.

Wie stelle ich Hermes Agent auf Deutsch um?

Mit hermes config set display.language de. Das stellt Menüs, Rückfragen und Hinweise auf Deutsch um. Auf Deutsch antworten tut Hermes, sobald du ihn auf Deutsch ansprichst.

Kann ich Hermes Agent auf Proxmox installieren?

Ja, über eine Linux-VM oder einen LXC-Container mit Debian oder Ubuntu. Darin läuft die normale Terminal-Installation oder Docker. Einen eigenen Proxmox-Weg gibt es nicht, und er ist auch nicht nötig.

Stand: 25.10.2026, Hermes Agent v0.22.5. Quelle: offizielle Dokumentation auf hermes-agent.nousresearch.com. Inoffiziell, nicht von Nous Research gesponsert. Zurück zum Hermes-Überblick