← Zurück zur Startseite
Hermes Agent · Self Hosted KI

Hermes
lokal und bei Hostinger betreiben

Hermes Agent ist ein quelloffener, selbst hostbarer KI-Agent von Nous Research. Hermes Workspace setzt eine Weboberfläche davor und macht daraus eine Arbeitsumgebung mit Chat, persistentem Gedächtnis, Skills, Terminal und Multi-Agent-Orchestrierung. Diese Seite dokumentiert beide Wege: Installation auf dem eigenen Rechner und Betrieb online auf einem Hostinger-VPS.

Lokale Installation Hostinger Online-Betrieb Offizielle Installation
$ hermes desktop ✓ Agent gestartet ✓ Skills geladen ✓ Memory aktiv Gateway: 127.0.0.1:8642 Dashboard: 127.0.0.1:9119

Was ist Hermes?

Ein Open-Source-KI-Agent, der Aufgaben ausführen, Werkzeuge nutzen, eigene Skills aufbauen und mit dauerhaftem Kontext arbeiten kann.

Warum selbst hosten?

API-Keys, Konfigurationen und Projektdaten bleiben unter eigener Kontrolle. Das ist besonders wichtig bei internen Workflows und Kundendaten.

Wofür Hostinger?

Ein VPS macht Hermes Workspace dauerhaft online erreichbar. Praktisch für Webzugriff, Teamtests und einen stabil laufenden Agent-Dienst.

Welche Variante ist richtig?

Die lokale Installation ist ideal für Entwicklung, Tests und private Nutzung. Hostinger ist sinnvoll, wenn Hermes dauerhaft online laufen oder von mehreren Geräten erreichbar sein soll.

Lokal einfach starten

  • Gut für Windows-PC, Notebook, WSL, Linux oder macOS.
  • Keine öffentlichen Ports nötig.
  • Beste Wahl für erste Tests und vertrauliche lokale Projekte.

Hostinger VPS online

  • Gut für dauerhaften Betrieb mit Browserzugriff.
  • Empfohlen mit Ubuntu 24.04, Node.js 22+, Python 3.11+ und mindestens 2 GB RAM.
  • Erfordert Absicherung mit starkem Passwort, HTTPS, Firewall und sauberer API-Key-Verwaltung.

Lokale Installation

Für den Einstieg reicht der Hermes-Agent. Die Desktop-App ist der komfortabelste Weg; alternativ kann Hermes per CLI installiert werden.

1. Voraussetzungen

  • Ein Rechner mit Windows, macOS, Linux oder WSL.
  • Ein API-Key für den gewünschten KI-Provider, zum Beispiel OpenAI, Anthropic oder einen anderen unterstützten Anbieter.
  • Terminal-Zugriff: PowerShell unter Windows, Bash unter Linux/macOS/WSL.

2. Windows per PowerShell installieren

PowerShell als normaler Benutzer starten und den offiziellen Installer ausführen:

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

3. Linux, macOS oder WSL installieren

In Bash den offiziellen Installer starten:

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

4. Desktop starten

Nach der CLI-Installation kann die Desktop-Oberfläche mit diesem Befehl gestartet werden:

hermes desktop

5. Installation prüfen

hermes --version hermes
Hermes legt Konfigurationen und lokale Daten typischerweise unter ~/.hermes ab. Dieser Ordner sollte regelmäßig gesichert werden, wenn produktive Skills, Memory oder Provider-Konfigurationen darin liegen.

Sicherheitsregeln für lokal

  • API-Keys nie in Screenshots, Git-Repositories oder öffentlichen Notizen speichern.
  • Lokale Ports nicht ins Internet freigeben, solange keine Authentifizierung und HTTPS davorliegen.
  • Für Kundendaten getrennte Projektordner, getrennte Keys und klare Backups verwenden.

Hermes Workspace lokal

Hermes Workspace ist die Weboberfläche für Hermes Agent. Sie bringt Chat, Dashboard, Skills, Terminal und Gateway zusammen. Diese Variante ist nützlich, wenn man Hermes nicht nur im Terminal, sondern als Web-App nutzen will.

1. Benötigte Komponenten

  • Node.js 22 oder neuer.
  • Python 3.11 oder neuer.
  • pnpm als Paketmanager.
  • Hermes Agent installiert und konfiguriert.

2. Workspace installieren

curl -fsSL https://raw.githubusercontent.com/outsourc-e/hermes-workspace/main/install.sh | bash

3. API-Server absichern

Ein geheimes Token erzeugen und sowohl im Hermes-Agent als auch im Workspace eintragen:

openssl rand -hex 32 nano ~/.hermes/.env # API_SERVER_ENABLED=true # API_SERVER_KEY=dein_langes_geheimnis nano ~/hermes-workspace/.env # HERMES_API_TOKEN=dein_langes_geheimnis

4. Gateway, Dashboard und Workspace starten

cd ~/hermes-workspace npx concurrently --names "gateway,dashboard,workspace" --prefix-colors "blue,green,yellow" "hermes gateway run" "hermes dashboard" "pnpm dev"

5. Lokale Ports

DienstStandard-PortZweck
Hermes Gateway8642API-Brücke zwischen Workspace und Agent.
Hermes Dashboard9119Status und Agent-Verwaltung.
Workspace Web-App3000Browseroberfläche für die Arbeit mit Hermes.

6. Health Checks

curl http://127.0.0.1:8642/health curl http://127.0.0.1:9119/api/status

Online bei Hostinger

Für den Online-Betrieb empfiehlt sich ein Hostinger-VPS. Der Vorteil: Hermes Workspace läuft dauerhaft und ist per Browser erreichbar. Wichtig ist dabei eine saubere Absicherung, weil ein KI-Agent mit Tools und API-Keys arbeitet.

Variante A: Hostinger Docker-Template

  1. Im Hostinger hPanel einen VPS anlegen oder einen vorhandenen VPS auswählen.
  2. Bei den Betriebssystem-Templates das Hermes-Workspace-Docker-Template wählen.
  3. Workspace-Passwort und API-Key eintragen.
  4. Deployment starten und danach den Container im Docker Manager öffnen.
  5. Direkt nach dem ersten Start Passwort, Provider-Key und öffentliche Erreichbarkeit prüfen.
Achtung: Wird auf einem bestehenden VPS das Betriebssystem neu installiert, werden vorhandene Daten gelöscht. Vorher immer Backup erstellen.

Variante B: Manuelle VPS-Installation

Empfehlung: Ubuntu 24.04, mindestens 2 GB RAM, SSH-Zugriff und ein nicht-öffentlich dokumentierter Admin-Zugang.

sudo apt update sudo apt install -y curl git curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs sudo npm install -g pnpm node -v python3 --version pnpm -v

Danach Hermes Workspace installieren und konfigurieren:

curl -fsSL https://raw.githubusercontent.com/outsourc-e/hermes-workspace/main/install.sh | bash openssl rand -hex 32 nano ~/.hermes/.env # API_SERVER_ENABLED=true # API_SERVER_KEY=dein_langes_geheimnis nano ~/hermes-workspace/.env # HERMES_API_TOKEN=dein_langes_geheimnis

Dauerhaft laufen lassen

Für Tests reicht tmux. Für produktiven Betrieb ist ein systemd-Service oder ein sauber verwalteter Docker-Container besser.

sudo apt install -y tmux tmux new -s hermes cd ~/hermes-workspace npx concurrently --names "gateway,dashboard,workspace" --prefix-colors "blue,green,yellow" "hermes gateway run" "hermes dashboard" "pnpm dev"

Domain, HTTPS und Zugriff

  • Workspace nur per HTTPS veröffentlichen, zum Beispiel hinter Nginx/Reverse Proxy.
  • Gateway-Port möglichst nicht öffentlich freigeben. Wenn Zugriff von außen nötig ist: nur mit Token, Firewall und HTTPS.
  • Für private Nutzung ist Tailscale oder ein VPN oft sicherer als ein offener Admin-Zugang im Internet.
  • API-Keys in `.env` halten, niemals in das Webverzeichnis oder in Git legen.

Betrieb und Wartung

Backups

  • `~/.hermes` sichern.
  • Workspace-Ordner und `.env` getrennt sichern.
  • API-Keys dokumentieren, aber niemals unverschlüsselt teilen.

Updates

  • Vor Updates Backup erstellen.
  • Hermes Agent, Workspace und Node-Abhängigkeiten kontrolliert aktualisieren.
  • Nach Updates Health Checks und Login testen.

Fehlerbilder

ProblemWahrscheinliche UrsachePrüfung
Workspace erreicht Agent nichtGateway läuft nicht oder Token stimmt nicht.`curl http://127.0.0.1:8642/health` und `.env` prüfen.
Dashboard bleibt leerDashboard-Dienst nicht gestartet.`curl http://127.0.0.1:9119/api/status` testen.
Login oder Provider-Aufruf schlägt fehlAPI-Key fehlt, ist falsch oder hat kein Guthaben.Provider-Key neu setzen und klein testen.
Von außen nicht erreichbarFirewall, Reverse Proxy oder DNS zeigt falsch.DNS, Nginx, SSL und VPS-Firewall prüfen.

Start-Checkliste

Hermes Agent installiert und mit Provider-Key getestet.
Workspace-Token erzeugt und in beiden `.env` Dateien identisch gesetzt.
Gateway, Dashboard und Workspace starten ohne Fehler.
Health Checks liefern erfolgreiche Antworten.
Bei Hostinger: HTTPS, Passwort, Firewall und Backup eingerichtet.
API-Keys liegen nicht im Webverzeichnis und nicht in Git.

Quellen und weiterführende Links