Zum Inhalt springen
glowfish

Start · Hilfe · Hermes Agent installieren

Hermes Agent auf einem vServer installieren

Hermes Agent ist ein quelloffener KI-Agent von Nous Research (MIT-Lizenz). Er führt Aufgaben im Terminal aus, merkt sich Wissen über Sitzungen hinweg, legt sich für wiederkehrende Aufgaben eigene Skills an und lässt sich über Telegram, Discord, Slack, WhatsApp oder Signal bedienen. Auf einem vServer läuft er rund um die Uhr, auch wenn Ihr eigener Rechner aus ist.

Welcher Server geeignet ist

Das Sprachmodell läuft beim Anbieter, etwa Anthropic, OpenAI, OpenRouter oder Nous Portal. Auf dem Server läuft nur der Agent selbst: ein Python-Prozess, der Anfragen an die Schnittstelle des Anbieters schickt und die Antworten verarbeitet. Im Dauerbetrieb mit Telegram braucht er nach unserer Messung etwa 450 MB Arbeitsspeicher und kaum Rechenzeit.

  • Geeignet: vServer XS mit 1 vCPU, 2 GB RAM und 40 GB NVMe, als Container mit Debian 13 oder Ubuntu.
  • Mehr Speicher brauchen die Browser-Steuerung mit Chromium (einige hundert MB zusätzlich, solange sie läuft) und selbst betriebene Gedächtnisdienste mit eigener Datenbank.
  • Nicht für einen vServer gedacht sind lokale Sprachmodelle. Sie brauchen eine Grafikkarte mit mindestens 8 GB Speicher. Diese Anleitung nutzt deshalb die Schnittstelle eines Anbieters.

1. Server vorbereiten

Als root aktualisieren, die Voraussetzungen installieren und einen eigenen Benutzer für den Agenten anlegen. Der Agent führt Befehle aus. Mit eigenem Benutzer ohne Administratorrechte bleibt der übrige Server geschützt.

apt update && apt full-upgrade
apt install git curl libatomic1
adduser hermes
loginctl enable-linger hermes

loginctl enable-linger sorgt dafür, dass die Dienste des Benutzers nach dem Abmelden und nach einem Neustart weiterlaufen.

2. Hermes installieren

Als Benutzer hermes anmelden, zum Beispiel per SSH oder mit su - hermes, und das offizielle Installationsskript ausführen:

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

Das Skript bringt Python, Node.js und die übrigen Werkzeuge selbst mit und legt alles unter ~/.hermes ab. Wer die Browser-Steuerung nicht braucht, spart Platz mit:

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

3. Modell-Anbieter einrichten

hermes setup

Der Assistent fragt nach Anbieter, Modell und Zugangsschlüssel. Schlüssel und Tokens speichert Hermes in ~/.hermes/.env, alle übrigen Einstellungen in ~/.hermes/config.yaml. Den Anbieter wechseln Sie später mit hermes model. Mit hermes startet ein Chat im Terminal, damit lässt sich die Einrichtung gleich prüfen.

4. Über Telegram bedienen und dauerhaft betreiben

Das Gateway verbindet Hermes mit Telegram und den anderen Messengern. Die Einrichtung fragt nach dem Zugang, bei Telegram ist das der Bot-Token von @BotFather. Danach richtet install das Gateway als systemd-Dienst ein:

hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status

Das Protokoll zeigt journalctl --user -u hermes-gateway -f.

5. Mit Ihrem Glowfish-Kundenkonto verbinden

Über die KI-Schnittstelle (MCP) arbeitet Hermes mit Ihrem Kundenkonto: Zustand der Server, Webhosting, Domains, Postfächer, Spieleserver, Rechnungen und Support-Tickets. Die Schnittstelle ist für Kunden kostenlos.

  1. Im Kundenportal unter KI-Anwendungen einen Schlüssel anlegen. Bezeichnung, Rechte und Gültigkeit wählen, bei Nur von IP-Adressen die Adresse Ihres vServers eintragen. Der Schlüssel wird nur einmal angezeigt.
  2. Den Schlüssel in ~/.hermes/.env eintragen:
    GLOWFISH_MCP_TOKEN=IHR-SCHLUESSEL
  3. In ~/.hermes/config.yaml den Server ergänzen. Hermes setzt den Wert aus der .env selbst ein, der Schlüssel steht so nicht in der Konfiguration:
    mcp_servers:
      glowfish:
        url: "https://mcp.glowfish.de/mcp"
        headers:
          Authorization: "Bearer ${GLOWFISH_MCP_TOKEN}"
  4. Die Verbindung prüfen:
    hermes mcp test glowfish

Ein laufendes Gateway übernimmt die geänderte Konfiguration nach etwa einer Minute selbst. In einem offenen Chat lädt /reload-mcp die Server sofort neu.

Beispiele

  • „Wie geht es meinen Servern?“
  • „Welche Rechnungen sind offen?“
  • „Richte info@meine-domain.de ein.“
  • „Starte den Valheim-Server neu.“
  • „Schick mir jeden Morgen um 8 Uhr den Zustand meiner Server.“

Ändernde Aktionen bestätigen Sie im Chat. Bestellungen gehen nur mit SMS-Code, Kennwörter nie über den Chat. Jede Aktion steht im Protokoll unter KI-Anwendungen, dort trennen Sie die Verbindung jederzeit.

Aktualisieren

hermes update

Der Befehl holt die neueste stabile Version und startet das Gateway neu.

Häufige Fragen

Was kostet der Betrieb?
Der vServer XS kostet 6,00 € im Monat. Dazu kommen die Kosten des Modell-Anbieters nach Verbrauch oder Abo.
Container oder KVM?
Der Container reicht. KVM brauchen Sie nur für eigene Kernelmodule, etwa für ein VPN.
Kann Hermes meinen vServer bei Glowfish auch selbst einrichten?
Auf dem eigenen Server arbeitet Hermes direkt im Terminal. Über die KI-Schnittstelle kann er zusätzlich Befehle auf anderen Servern ausführen, wenn Sie diese im Kundenportal dafür freigeben.

Weiter: KI-Assistenten mit Glowfish verbinden Die ersten Schritte auf Ihrem vServer Debian-Server einrichten

vServer für Hermes mieten