# Hermes Agent Install: Schritt-für-Schritt-Anleitung Hermes Agent ist ein modularer, terminalbasierter Open-Source-KI-Agent von Nous Research mit persistentem Gedächtnis. Er verbindet LLM-Provider, Werkzeuge, Skills und Automatisierungen in einer lokalen oder serverbasierten Umgebung. Der Hermes Agent Install erfolgt in wenigen Schritten. ## Schritt 1: Systemvoraussetzungen und Abhängigkeiten prüfen Bevor Sie [Hermes Agent](https://www.ionos.at/digitalguide/server/knowhow/was-ist-hermes-agent/) installieren, sollten Sie prüfen, ob Ihr System die grundlegenden Voraussetzungen erfüllt. Der offizielle Installer des [KI-Agenten](https://www.ionos.at/digitalguide/websites/web-entwicklung/ki-agenten/) richtet viele Abhängigkeiten automatisch ein, darunter Python, Node.js, `uv`, `ripgrep` und `ffmpeg`. Manuell sollten vor allem Git, `curl` und unter Linux beziehungsweise WSL2 zusätzlich `xz-utils` verfügbar sein. Folgende Voraussetzungen sollten Sie also überprüfen, bevor Sie mit dem Hermes Agent Install fortfahren:
Komponente Mindestanforderung Empfehlung
Betriebssystem Linux, macOS oder Windows nativ oder mit WSL2 Aktuelles Ubuntu LTS, aktuelles macOS auf Apple Silicon oder Ubuntu unter WSL2
Architektur x86\_64 oder aarch64 unter Linux/WSL2; Apple Silicon unter macOS 64-Bit-System mit aktuellem Paketmanager
Python Python 3.11+; nicht manuell installieren, vom Hermes-Installer via uv verwalten lassen
Node.js Erforderlich für Browser-Automatisierung (Playwright) und WhatsApp-Anbindung Nicht manuell erzwingen; vom Hermes-Installer bereitstellen lassen
uv Linux, macOS oder Windows mit WSL2 Automatisch durch den Installer einrichten lassen
Git `git --version` muss funktionieren Aktuelle Git-Version über den Paketmanager installieren
curl Für den One-Line-Installer erforderlich Vor der Installation mit `curl --version` prüfen
xz-utils Unter Linux/WSL2 erforderlich, da Node.js als `.tar.xz` geladen wird Unter Debian/Ubuntu vorab installieren
API-Zugang Mindestens ein LLM-Provider OpenRouter, Anthropic, Nous Portal oder ein OpenAI-kompatibler Endpoint
Hinweis Das ausgewählte Sprachmodell muss ein Kontextfenster von **mindestens 64.000 Token** unterstützen. Modelle mit kleinerem Kontextfenster werden von Hermes Agent nicht unterstützt und führen dazu, dass sich der Agent nicht starten lässt. Über den Eintrag `model.context_length` in der `config.yaml` lässt sich der Wert allerdings manuell überschreiben. Unter [Debian](https://www.ionos.at/digitalguide/server/knowhow/debian-die-universelle-system-software/), [Ubuntu](https://www.ionos.at/digitalguide/server/knowhow/ubuntu-das-linux-system-fuer-jedermann/) oder [WSL2](https://www.ionos.at/digitalguide/server/knowhow/wsl2-vorgestellt/) installieren Sie die wichtigsten Basiswerkzeuge mit: ```bash sudo apt update sudo apt install -y git curl xz-utils ``` Prüfen Sie anschließend, ob Git und `curl` erreichbar sind: ```bash git --version curl --version ``` Unter macOS ist Git häufig bereits über die Apple Command Line Tools verfügbar. Falls Git noch nicht installiert ist, starten Sie die Installation mit: ```bash xcode-select --install ``` ## Schritt 2: Hermes Agent unter Linux und macOS installieren Für Linux und macOS verwenden Sie den offiziellen One-Line-Installer im nativen Terminal. Öffnen Sie dazu ein Terminalfenster und führen Sie folgenden Befehl aus: ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` Der Installer lädt das Projekt herunter, richtet die virtuelle Umgebung ein, installiert benötigte Abhängigkeiten und legt den globalen Befehl `hermes` an. Standardmäßig wird Hermes im Benutzerverzeichnis installiert, typischerweise unter `~/.hermes/`. Der ausführbare Befehl wird als Symlink unter `~/.local/bin/hermes` eingerichtet. Nach Abschluss der Installation müssen Sie Ihre Shell neu laden, damit der Befehl `hermes` im `PATH` verfügbar ist. Verwenden Sie je nach Shell einen der folgenden Befehle: ```bash source ~/.bashrc ``` oder unter zsh, wie auf vielen macOS-Systemen: ```bash source ~/.zshrc ``` Prüfen Sie anschließend, ob Hermes korrekt im Terminal gefunden wird: ```bash command -v hermes ``` Wenn der Befehl einen Pfad wie `~/.local/bin/hermes` ausgibt, wurde Hermes erfolgreich registriert. Zusätzlich können Sie die Hilfeansicht öffnen, um zu prüfen, ob Hermes korrekt startet und welche Optionen und Unterbefehle über die Kommandozeile verfügbar sind: ```bash hermes --help ``` Tipp Neben der Installation über das Terminal stellt Nous Research auch einen offiziellen Hermes-Desktop-Installer für macOS und Windows bereit. Dieser installiert sowohl die Desktop-Anwendung als auch die Kommandozeilenversion automatisch und eignet sich insbesondere für Einsteigerinnen und Einsteiger. In diesem Artikel verwenden wir dennoch die Terminal-Installation, da sie **plattformübergreifend identisch funktioniert** und sich dadurch gleichermaßen für Linux, macOS und Windows (WSL2) eignet. Die Desktop-App unterstützt für macOS aktuell nur Apple-Silicon (arm64). ## Schritt 3: Hermes Agent unter Windows installieren Alternativ können Sie die Software auch unter Windows installieren. Das Microsoft-System unterstützt den Hermes Agent Install nativ. Öffnen Sie hierzu die PowerShell und nutzen Sie folgenden Befehl: ```powershell iex (irm https://hermes-agent.nousresearch.com/install.ps1) ``` Danach prüfen Sie, ob die Installation erfolgreich war: ```powershell hermes ``` Falls Sie lieber in einer Linux-Umgebung arbeiten, können Sie Hermes Agent alternativ auch innerhalb von WSL2 installieren. Dort erfolgt die Einrichtung identisch zur Linux-Version: 1. Öffnen Sie PowerShell als Administrator. Installieren Sie WSL mit der Standarddistribution Ubuntu: `wsl --install -d Ubuntu` 2. Starten Sie Windows neu, falls Sie dazu aufgefordert werden. 3. Öffnen Sie nun die Linux-Umgebung unter WSL2. Dies können Sie über den Eintrag „Ubuntu“ im Windows-Startmenü oder durch Eingabe von `wsl` im Windows Terminal tun. Legen Sie beim ersten Start einen Linux-Benutzernamen und ein Passwort fest. 4. Aktualisieren Sie die Paketquellen und installieren Sie die Basiswerkzeuge mit `sudo apt update` und `sudo apt install -y git curl xz-utils`. 5. Führen Sie nun in der Ubuntu-Shell den offiziellen Linux-Installer des Hermes Agenten aus: `curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash` 6. Laden Sie nun die Shell mit `source ~/.bashrc` neu, damit `hermes` im PATH verfügbar ist. 7. Prüfen Sie, ob Hermes gefunden wird: `command -v hermes` Hinweis Führen Sie den Linux-Installer nicht in [PowerShell](https://www.ionos.at/digitalguide/server/knowhow/windows-powershell/) aus, sondern innerhalb der Ubuntu-Shell aus. Nur dort stehen die Linux-Pfade, Paketmanager und Shell-Konfigurationen zur Verfügung, die der Installer erwartet. ## Schritt 4: Initiales Setup und Funktionsprüfung Nach der Installation richten Sie Hermes Agent interaktiv ein. Starten Sie dafür den Setup-Assistenten mit untenstehendem Befehl: ```bash hermes setup ``` Der Assistent führt Sie durch die wichtigsten Einstellungen. Dazu gehört insbesondere die Auswahl eines [LLM](https://www.ionos.at/digitalguide/server/knowhow/large-language-model/)-Providers. OpenRouter oder Anthropic sind naheliegend, weil Sie dort einen [API](https://www.ionos.at/digitalguide/websites/web-entwicklung/was-ist-eine-api/)-Key hinterlegen und anschließend ein unterstütztes Modell auswählen können. Während der Einrichtung werden Sie typischerweise nach folgenden Punkten gefragt: - gewünschter LLM-Provider - API-Key oder OAuth-Login - Modell-Auswahl - aktivierte Werkzeuge und Toolsets - optionale Gateway- oder Messaging-Funktionen Wenn Sie OpenRouter verwenden, benötigen Sie einen OpenRouter-API-Key. Benutzen Sie Anthropic, benötigen Sie entweder einen passenden Anthropic-Zugang oder einen API-Key. Kopieren Sie API-Keys aus Sicherheitsgründen nur in Ihre eigene lokale Shell und veröffentlichen Sie diese niemals in Screenshots, Logs oder gemeinsam genutzten Dokumenten. Neben klassischen API-Providern wie OpenRouter oder Anthropic unterstützt Hermes Agent inzwischen auch den offiziellen Schnellstart über den Nous Portal Flow. Mit dem folgenden Befehl authentifizieren Sie sich per OAuth direkt über den Nous Portal Account: ```bash hermes setup --portal ``` Dabei wird automatisch ein kompatibles Modell ausgewählt, der LLM-Provider konfiguriert und das Tool Gateway aktiviert (Websuche, Bildgenerierung, TTS und Browser-Automation). Dieser Ansatz ist mittlerweile die **empfohlene Standardinstallation**, da keine separaten API-Keys mehr benötigt werden und die komplette Toolchain in einem Schritt verfügbar ist. Nach dem Setup starten Sie Hermes im Terminal mit: ```bash hermes ``` Alternativ können Sie die TUI-Ansicht (Terminal User Interface) starten. Dabei handelt es sich um eine textbasierte Benutzeroberfläche, die direkt im Terminal ausgeführt wird und eine komfortablere Bedienung als die reine Eingabe einzelner Befehle ermöglicht. ```bash hermes --tui ``` Geben Sie zum Testen eine kurze, eindeutig überprüfbare Anfrage ein, zum Beispiel: ```bash Antworte nur mit: Hermes ist einsatzbereit. ``` Zum Abschluss sollten Sie die Systemgesundheit mit folgendem Befehl überprüfen: ```bash hermes doctor ``` Dieser Befehl diagnostiziert typische Probleme wie fehlende Konfigurationswerte, veraltete Einstellungen oder nicht korrekt eingerichtete Provider. Wenn `hermes doctor` Warnungen ausgibt, beheben Sie zuerst diese Punkte und testen Sie im Anschluss erneut eine einfache Hermes-Sitzung. Falls Sie später das [KI](https://www.ionos.at/digitalguide/online-marketing/verkaufen-im-internet/was-ist-kuenstliche-intelligenz/)-Modell wechseln möchten, müssen Sie Hermes nicht neu installieren. Starten Sie stattdessen die Provider-Konfiguration erneut: ```bash hermes model ``` Für eine vollständige Neukonfiguration des [Open-Source](https://www.ionos.at/digitalguide/server/knowhow/was-ist-open-source/)-Agenten können Sie jederzeit wieder den Setup-Assistenten ausführen. Hinweis Möchten Sie [Hermes Agent lokal betreiben](https://www.ionos.at/digitalguide/server/konfiguration/hermes-agent-lokal-betreiben/), können Sie die in diesem Artikel beschriebene Installation direkt auf Ihrem eigenen Rechner durchführen. Ebenso eignet sich derselbe Installationsweg, um Hermes Agent auf einem VPS einzurichten, beispielsweise auf einem Linux-Server in der [Cloud](https://www.ionos.at/digitalguide/server/knowhow/was-ist-eine-cloud/). Dadurch steht der KI-Agent unabhängig vom lokalen Gerät dauerhaft zur Verfügung und kann auch aus der Ferne genutzt werden. This is a markdown version of: [https://www.ionos.at/digitalguide/server/konfiguration/hermes-agent-installieren/](https://www.ionos.at/digitalguide/server/konfiguration/hermes-agent-installieren/) for AI/LLM consumption.