So installierst du Hermes Agent auf einem VPS (Schritt-für-Schritt-Anleitung 2026)

Das solltest du wissen:

• Hermes Agent ist der Open-Source, selbstlernende KI-Agent von Nous Research, gebaut für den Betrieb auf der Kommandozeile und die Kommunikation über Messaging-Apps.
• Installiere ihn auf jedem Linux-, macOS- oder WSL2-Host mit Git und Python 3.11+. Der One-Line-Installer geht am schnellsten auf einem VPS.
• Ein kleiner VPS mit 1 vCPU und 1 GB RAM reicht, wenn das LLM über eine API läuft. Plane 2 GB oder mehr ein für lokale Tools oder Memory. Ein Cloud VPS 10 von Contabo ist mehr als ausreichend zum Starten.
• Docker wird unterstützt mit dem Ein-Container-pro-Profil-Muster und ist für Produktion empfohlen.
• Verbinde Telegram, Discord, Slack, WhatsApp, Signal oder E-Mail über das Gateway, damit der Agent auch außerhalb des Terminals erreichbar ist.
• Hermes Agent betreibt jedes Hermes-AI-Modell mit einem 64.000-Token-Kontextfenster, einschließlich der Hermes-3- und Hermes-4-Familien.

Die Installation von Hermes Agent auf einem VPS gibt dir einen selbstlernenden KI-Agenten, der auf deinem Server lebt, Kontext über Sessions hinweg behält und über Telegram, Discord oder Slack erreichbar ist. Diese Anleitung führt dich durch die Installation von Anfang bis Ende auf einem frischen Contabo VPS mit Ubuntu: Docker, der Setup-Wizard, ein LLM-Provider und eine systemd-Unit. Plane etwa 15 Minuten ein, von einer frischen SSH-Session bis zum laufenden Agenten.

Vor der Installation: Hermes Agent in 60 Sekunden

Hermes Agent ist der Open-Source autonome KI-Agent von Nous Research. Er läuft als CLI, stellt einen OpenAI-kompatiblen API-Server bereit und bringt integrierte Tools für Terminalzugriff, Dateioperationen, Websuche, persistenten Speicher und ein selbstlernendes Skills-System mit.

Was ist Hermes Agent AI?

Hermes Agent AI ist der Begriff von Nous Research für den Agenten plus seine vollständige Runtime: die CLI, den Memory Store, das Skills-System und das Gateway, das ihn mit deinen Messaging-Apps verbindet. Du bringst dein eigenes LLM mit; Hermes liefert alles, was dieses LLM in einen persistenten, selbstlernenden Agenten verwandelt.

Was den Hermes-KI-Agenten von einem Chatbot-Wrapper unterscheidet, ist der geschlossene Lernkreislauf. Er kuratiert seinen eigenen Speicher, behält Skills über Sessions hinweg und baut über Honcho-basiertes User Modeling ein Modell von dir und deiner Arbeit auf. Je länger er auf deinem VPS läuft, desto nützlicher wird er.

Hermes Agent Systemanforderungen 2026

Das Hermes-AI-Agent-Framework selbst ist leichtgewichtig; die eigentlichen Ressourcenkosten entstehen durch das LLM, den Memory Store und lokales Tooling. Ein kleiner VPS mit 1 vCPU und 1 GB RAM reicht für den API-only-Pfad. Für ein lokales LLM mit Ollama auf derselben Maschine plane mehr RAM und idealerweise eine GPU ein.

Der Hermes-KI-Agent funktioniert mit jedem Modell, das ein 64.000-Token-Kontextfenster unterstützt, einschließlich der Hermes-3-AI- und Hermes-4-AI-Familien. Ein Einsteiger-Contabo-Cloud-VPS deckt das API-only-Setup ab. Für ein lokales Modell daneben kannst du einen leistungsstärkeren Plan mit genug Ressourcen für ein leichtes Ollama-Modell wählen.

Schritt 1: VPS-Umgebung vorbereiten

Stelle einen frischen Ubuntu-VPS bereit, dann verbinde dich per SSH als Root und aktualisiere das System. Die meisten Installationsprobleme entstehen durch einen veralteten Paketindex oder eine fehlende Abhängigkeit.

Per SSH verbinden und Pakete aktualisieren

ssh root@your-vps-ip
apt update && apt upgrade -y
apt install -y git curl ca-certificates

Git ist erforderlich. ‚curl‘ und ‚ca-certificates‘ übernehmen den Installer und HTTPS-Aufrufe an deinen LLM-Provider. Python 3.11+ wird benötigt, aber der Installer stellt ein verwaltetes Python über uv bereit. Wenn du den Hermes-Agent-AI-Docker-Pfad nutzen willst, folge stattdessen Schritt 2.

Einen Non-Root-Nutzer erstellen und SSH härten

Führe Hermes Agent nicht als Root aus. Erstelle einen sudo-Nutzer und wechsle dann zu ihm:

adduser hermes
usermod -aG sudo hermes
rsync --archive --chown=hermes:hermes ~/.ssh /home/hermes
su - hermes

Verwende SSH-Key-only-Login, deaktiviere Passwort-Authentifizierung in <wpml_ignored_tag wpml_name=“code“ wpml_value=“L2V0Yy9zc2gvc3NoZF9jb25maWc=“ wpml_attrs=““/> und stelle sicher, dass eine Firewall aktiv ist. Serverhygiene wird wichtig, sobald ein autonomer Hermes-KI-Agent in deinem Namen handelt.

Schritt 2: Docker für Hermes Agent installieren

Du hast zwei Wege für die Hermes-Agent-Installation auf einem VPS: nativ mit dem One-Line-Script oder ein Hermes-Agent-AI-Docker-Deployment. Docker ist das empfohlene Muster für Produktion, weil es den Agenten isoliert und das Profil-Management sauberer macht.

Docker Engine aus dem offiziellen apt-Repository installieren:

1. Dockers GPG-Key und apt-Quelle hinzufügen.
2. Den Paketindex aktualisieren.
3. Installiere docker-ce, docker-ce-cli, containerd.io und docker-compose-plugin.
4. Deinen Nutzer zur Docker-Gruppe hinzufügen: sudo usermod -aG docker $USER.
5. Abmelden und wieder anmelden, dann bestätigen mit docker --version.

Wähle Docker für Produktion; der native Installer in Schritt 3 ist schneller für den persönlichen Gebrauch. Wenn dein Contabo VPS mit dem Docker-Add-On ausgeliefert wurde, ist dieser Schritt bereits erledigt.

Schritt 3: Hermes Agent mit dem offiziellen Installer deployen

Hermes Agent wird mit einem offiziellen One-Line-Installer ausgeliefert, der von Nous Research gepflegt wird. Er stellt Python über uv bereit, installiert Node.js, lädt Abhängigkeiten herunter und erstellt den hermes-CLI-Befehl. Der Quellcode liegt im Hermes-GitHub-Repository.

Option A: One-Line-curl-Installer (Nativ)

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes --version

Der erste Befehl installiert die Hermes-Agent-AI-Runtime vollständig, heruntergeladen aus dem Hermes-GitHub-Repo. Das Source-Reload macht hermes in der aktuellen Shell verfügbar. Um den Wizard zu überspringen, übergib -s -- --skip-setup.

Option B: Docker-Deployment (Empfohlen)

Für ein Hermes-Agent-AI-Docker-Deployment empfiehlt Nous Research einen Container pro Profil statt des eingebauten Multi-Profil-Features.

docker run -d \
  --name hermes-agent \
  --restart unless-stopped \
  -v hermes-data:/home/hermes/.hermes \
  -e HERMES_PROFILE=default \
  nousresearch/hermes-agent:latest

Das benannte Volume bewahrt Memory, Skills und Credentials zwischen Neuerstellungen. Pinne den Image-Tag für Produktion.

Schritt 4: Setup-Wizard ausführen und LLM-Provider konfigurieren

Hermes Agent braucht ein LLM dahinter. Der Setup-Wizard übernimmt die Provider-Auswahl, die API-Key-Eingabe und das Standardmodell:

hermes setup

Der Wizard fragt nach:

• Hermes Agent AI LLM — das Modell, mit dem der Agent denkt.
• LLM-Provider — OpenRouter, MiniMax, Nous Portal, Anthropic, OpenAI, ein lokaler Ollama-Endpoint oder ein anderer unterstützter Provider.
• API Key — lokal gespeichert unter ~/.hermes.
• Modell — muss mindestens ein 64.000-Token-Kontextfenster unterstützen.
• Tools — Terminalzugriff, Dateioperationen, Websuche und Memory ein-/ausschalten.
• Profilname — nützlich, wenn du mehrere Profile auf einem Host betreibst.

Der Hermes KI-Agent liest seine Konfiguration beim Start neu, sodass du jeden Abschnitt mit hermes setup model, hermes setup tools oder hermes config set.

Schritt 5: Prüfen, ob Hermes Agent läuft

Bevor du ein Messaging-Gateway verbindest, stelle sicher, dass der Agent funktioniert:

hermes doctor
hermes --version
hermes

Der Doctor-Befehl prüft Abhängigkeiten, Python-Version, Modell-Kontextfenster und API-Konnektivität. Der dritte Befehl öffnet eine interaktive Session, in der ein kurzes ‚hello‘ den LLM-Roundtrip bestätigt. Behebe alles, was hermes doctor meldet, bevor du weitermachst.

Schritt 6: Messaging-Gateway verbinden (Telegram, Discord, Slack)

Ein Hermes-Agent-AI-Assistent auf einem VPS lohnt sich erst, wenn du ihn von überall erreichen kannst. Das integrierte Gateway verbindet den Agenten mit Telegram, Discord, Slack, WhatsApp, Signal oder E-Mail.

Telegram ist der häufigste Startpunkt, weil Telegram-Bots am schnellsten einzurichten sind. Der allgemeine Ablauf:

1. Einen Bot auf der Plattform erstellen (Telegram BotFather, Discord Developer Portal, Slack App).
2. Den Bot-Token und alle erforderlichen IDs kopieren.
3. Hinzufügen mit hermes config set oder deiner Environment-Datei.
4. Das Gateway starten mit hermes gateway.
5. Eine Testnachricht senden und bestätigen, dass Hermes antwortet.

Hermes-KI-Agent Telegram-Integration

Für Telegram macht das Gateway Hermes zu einem privaten Bot, den du per DM von deinem Telefon aus erreichst. Slack und Discord funktionieren genauso: Der Agent lebt in einem Kanal oder einer DM und respektiert die Berechtigungen, die du beim App-Setup vergibst. Behandle Bot-Tokens als Produktions-Secrets.

Schritt 7: Hermes Agent als 24/7-Service betreiben

Ein VPS ist nur nützlich, wenn der Agent auch nach Neustarts online bleibt. Bei einer Docker-Installation erledigt die Restart-Policy das:

docker update --restart unless-stopped hermes-agent

Bei einer nativen Installation registriere Hermes als systemd-Service:

# /etc/systemd/system/hermes.service
[Unit]
Description=Hermes Agent
After=network-online.target

[Service]
Type=simple
User=hermes
WorkingDirectory=/home/hermes
ExecStart=/home/hermes/.local/bin/hermes gateway
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Dann aktivieren und starten:

sudo systemctl daemon-reload
sudo systemctl enable --now hermes

Das ist die systemd-Konfiguration, die Hermes-Agent-AI-Automatisierung über Neustarts hinweg zuverlässig macht. Restart=always bringt den Agenten nach einem Absturz zurück; nur systemctl stop hält ihn absichtlich an.

Hermes-Agent-Installations-Checkliste

Ein schnelles Post-Install-Audit:

• VPS auf einem unterstützten OS (Linux oder WSL2)
• Systempakete aktualisiert; git, curl, ca-certificates installiert
• Non-Root-Nutzer erstellt; SSH-Key-only-Login
• Docker installiert (oder für native übersprungen)
• Hermes Agent via Script oder Docker-Image installiert
• hermes --version gibt die erwartete Version zurück
• Setup-Wizard abgeschlossen mit LLM-Provider, API Key und Modell
• Gewähltes Modell unterstützt ein 64.000-Token-Kontextfenster
• hermes doctor meldet sauber und der Hermes-KI-Agent hat einen Test-Prompt beantwortet
• Mindestens ein Messaging-Gateway verbunden und getestet
• systemd-Unit oder Docker-Restart-Policy eingerichtet
• Memory-Volume (~/.hermes) gesichert

Häufige Hermes-Agent-Installationsfehler, die du vermeiden solltest

• Installationsversuche auf nativem Windows. Hermes Agent läuft nicht auf nativem Windows. Verwende WSL2 oder einen Linux-VPS.
• Falsche Python-Version. Der Installer erwartet Python 3.11+ über uv. System-Python 3.10 oder 3.9 verursacht stumme Abhängigkeitsfehler.
• Modelle mit zu kleinem Kontextfenster. Alles unter 64.000 Token verliert den Kontext mitten in der Aufgabe.
• Als Root ausführen. Hermes hat Terminalzugriff als eingebautes Tool. Gib ihm einen unprivilegierten Nutzer.
• hermes doctor überspringen. Die meisten Installationsprobleme tauchen dort zuerst auf.
• ~/.hermes nicht persistieren. Dort liegen Memory, Skills und Credentials.
• Das eingebaute Multi-Profil-Feature innerhalb eines Hermes-Agent-AI-Docker-Containers verwenden. Nous Research empfiehlt einen Container pro Profil.
• Das Gateway ungesichert lassen. Behandle Bot-Tokens und den API Key als Produktions-Secrets.

Warum ein Contabo VPS/VDS gut zu Hermes Agent passt

Hermes Agent läuft komfortabel auf kleiner Hardware, wenn das LLM gehostet wird, und skaliert sauber für lokale Modelle. Ein einfacher Cloud VPS deckt den API-only-Pfad zum Preis ab, den die meisten Anbieter für die Hälfte der Ressourcen verlangen. Für ein lokales LLM neben dem Agenten bietet ein leistungsstärkerer VPS oder VDS mehr Ressourcen für leichte Inferenz oder Produktions-Workloads.

Portabilität zählt ebenfalls. Derselbe Installer und dasselbe Docker-Image funktionieren auf allen Contabo-VPS-Optionen, du kannst also klein anfangen und später hochskalieren. Das gilt auch für das breitere Open-Source-Agent-Ökosystem: Wenn du ein Hermes-KI-Agent-Setup mit Alternativen wie OpenClaw vergleichen willst, kannst du eines daneben auf demselben Server hochziehen.

Du kannst Hermes ganz einfach mit einem Klick über dein Customer Control Panel auf einem Contabo VPS installieren. Installiere den Server einfach neu mit Hermes Agent als ausgewählter Anwendung.

FAQ: Hermes Agent auf einem VPS installieren