Hermes Agent Install: Schritt-für-Schritt-Anleitung

Hermes Agent ist ein modularer, ter­mi­nal­ba­sier­ter Open-Source-KI-Agent von Nous Research mit per­sis­ten­tem Ge­dächt­nis. Er verbindet LLM-Provider, Werkzeuge, Skills und Au­to­ma­ti­sie­run­gen in einer lokalen oder ser­ver­ba­sier­ten Umgebung. Der Hermes Agent Install erfolgt in wenigen Schritten.

Schritt 1: Sys­tem­vor­aus­set­zun­gen und Ab­hän­gig­kei­ten prüfen

Bevor Sie Hermes Agent in­stal­lie­ren, sollten Sie prüfen, ob Ihr System die grund­le­gen­den Vor­aus­set­zun­gen erfüllt. Der of­fi­zi­el­le Installer des KI-Agenten richtet viele Ab­hän­gig­kei­ten au­to­ma­tisch ein, darunter Python, Node.js, uv, ripgrep und ffmpeg. Manuell sollten vor allem Git, curl und unter Linux be­zie­hungs­wei­se WSL2 zu­sätz­lich xz-utils verfügbar sein.

Folgende Vor­aus­set­zun­gen sollten Sie also über­prü­fen, bevor Sie mit dem Hermes Agent Install fort­fah­ren:

Unter Debian, Ubuntu oder WSL2 in­stal­lie­ren Sie die wich­tigs­ten Ba­sis­werk­zeu­ge mit:

sudo apt update
sudo apt install -y git curl xz-utils

Prüfen Sie an­schlie­ßend, ob Git und curl er­reich­bar sind:

git --version
curl --version

Unter macOS ist Git häufig bereits über die Apple Command Line Tools verfügbar. Falls Git noch nicht in­stal­liert ist, starten Sie die In­stal­la­ti­on mit:

xcode-select --install

Schritt 2: Hermes Agent unter Linux und macOS in­stal­lie­ren

Für Linux und macOS verwenden Sie den of­fi­zi­el­len One-Line-Installer im nativen Terminal. Öffnen Sie dazu ein Ter­mi­nal­fens­ter und führen Sie folgenden Befehl aus:

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

Der Installer lädt das Projekt herunter, richtet die virtuelle Umgebung ein, in­stal­liert benötigte Ab­hän­gig­kei­ten und legt den globalen Befehl hermes an. Stan­dard­mä­ßig wird Hermes im Be­nut­zer­ver­zeich­nis in­stal­liert, ty­pi­scher­wei­se unter ~/.hermes/. Der aus­führ­ba­re Befehl wird als Symlink unter ~/.local/bin/hermes ein­ge­rich­tet.

Nach Abschluss der In­stal­la­ti­on 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:

source ~/.bashrc

oder unter zsh, wie auf vielen macOS-Systemen:

source ~/.zshrc

Prüfen Sie an­schlie­ßend, ob Hermes korrekt im Terminal gefunden wird:

command -v hermes

Wenn der Befehl einen Pfad wie ~/.local/bin/hermes ausgibt, wurde Hermes er­folg­reich re­gis­triert. Zu­sätz­lich können Sie die Hil­fe­an­sicht öffnen, um zu prüfen, ob Hermes korrekt startet und welche Optionen und Un­ter­be­feh­le über die Kom­man­do­zei­le verfügbar sind:

hermes --help

Schritt 3: Hermes Agent unter Windows in­stal­lie­ren

Al­ter­na­tiv können Sie die Software auch unter Windows in­stal­lie­ren. Das Microsoft-System un­ter­stützt den Hermes Agent Install nativ. Öffnen Sie hierzu die Power­Shell und nutzen Sie folgenden Befehl:

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

Danach prüfen Sie, ob die In­stal­la­ti­on er­folg­reich war:

hermes

Falls Sie lieber in einer Linux-Umgebung arbeiten, können Sie Hermes Agent al­ter­na­tiv auch innerhalb von WSL2 in­stal­lie­ren. Dort erfolgt die Ein­rich­tung identisch zur Linux-Version:

1. Öffnen Sie Power­Shell als Ad­mi­nis­tra­tor. In­stal­lie­ren Sie WSL mit der Stan­dard­dis­tri­bu­ti­on Ubuntu: wsl --install -d Ubuntu
2. Starten Sie Windows neu, falls Sie dazu auf­ge­for­dert 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-Be­nut­zer­na­men und ein Passwort fest.
4. Ak­tua­li­sie­ren Sie die Pa­ket­quel­len und in­stal­lie­ren Sie die Ba­sis­werk­zeu­ge mit sudo apt update und sudo apt install -y git curl xz-utils.
5. Führen Sie nun in der Ubuntu-Shell den of­fi­zi­el­len 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

Schritt 4: Initiales Setup und Funk­ti­ons­prü­fung

Nach der In­stal­la­ti­on richten Sie Hermes Agent in­ter­ak­tiv ein. Starten Sie dafür den Setup-As­sis­ten­ten mit un­ten­ste­hen­dem Befehl:

hermes setup

Der Assistent führt Sie durch die wich­tigs­ten Ein­stel­lun­gen. Dazu gehört ins­be­son­de­re die Auswahl eines LLM-Providers. Open­Rou­ter oder Anthropic sind na­he­lie­gend, weil Sie dort einen API-Key hin­ter­le­gen und an­schlie­ßend ein un­ter­stütz­tes Modell auswählen können. Während der Ein­rich­tung werden Sie ty­pi­scher­wei­se nach folgenden Punkten gefragt:

• ge­wünsch­ter LLM-Provider
• API-Key oder OAuth-Login
• Modell-Auswahl
• ak­ti­vier­te Werkzeuge und Toolsets
• optionale Gateway- oder Messaging-Funk­tio­nen

Wenn Sie Open­Rou­ter verwenden, benötigen Sie einen Open­Rou­ter-API-Key. Benutzen Sie Anthropic, benötigen Sie entweder einen passenden Anthropic-Zugang oder einen API-Key. Kopieren Sie API-Keys aus Si­cher­heits­grün­den nur in Ihre eigene lokale Shell und ver­öf­fent­li­chen Sie diese niemals in Screen­shots, Logs oder gemeinsam genutzten Do­ku­men­ten.

Neben klas­si­schen API-Providern wie Open­Rou­ter oder Anthropic un­ter­stützt Hermes Agent in­zwi­schen auch den of­fi­zi­el­len Schnell­start über den Nous Portal Flow. Mit dem folgenden Befehl au­then­ti­fi­zie­ren Sie sich per OAuth direkt über den Nous Portal Account:

hermes setup --portal

Dabei wird au­to­ma­tisch ein kom­pa­ti­bles Modell aus­ge­wählt, der LLM-Provider kon­fi­gu­riert und das Tool Gateway aktiviert (Websuche, Bild­ge­ne­rie­rung, TTS und Browser-Au­to­ma­ti­on). Dieser Ansatz ist mitt­ler­wei­le die emp­foh­le­ne Stan­dard­in­stal­la­ti­on, 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:

hermes

Al­ter­na­tiv können Sie die TUI-Ansicht (Terminal User Interface) starten. Dabei handelt es sich um eine text­ba­sier­te Be­nut­zer­ober­flä­che, die direkt im Terminal aus­ge­führt wird und eine kom­for­ta­ble­re Bedienung als die reine Eingabe einzelner Befehle er­mög­licht.

hermes --tui

Geben Sie zum Testen eine kurze, eindeutig über­prüf­ba­re Anfrage ein, zum Beispiel:

Antworte nur mit: Hermes ist einsatzbereit.

Zum Abschluss sollten Sie die Sys­tem­ge­sund­heit mit folgendem Befehl über­prü­fen:

hermes doctor

Dieser Befehl dia­gnos­ti­ziert typische Probleme wie fehlende Kon­fi­gu­ra­ti­ons­wer­te, veraltete Ein­stel­lun­gen oder nicht korrekt ein­ge­rich­te­te 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-Modell wechseln möchten, müssen Sie Hermes nicht neu in­stal­lie­ren. Starten Sie statt­des­sen die Provider-Kon­fi­gu­ra­ti­on erneut:

hermes model

Für eine voll­stän­di­ge Neu­kon­fi­gu­ra­ti­on des Open-Source-Agenten können Sie jederzeit wieder den Setup-As­sis­ten­ten ausführen.