Hermes ist ein lokaler Agenten-Stack, der sich sowohl auf kleinen Einplatinenrechnern als auch auf Desktop-PCs nutzen l\u00e4sst. Eine sinnvolle Arbeitsweise ist, das eigentliche Hermes\u2011Backend dauerhaft auf einem Raspberry Pi laufen zu lassen und von einem Laptop \u00fcber Hermes Desktop per Remote\u2011Gateway darauf zuzugreifen. So bleibt das Pi\u2011System immer verf\u00fcgbar f\u00fcr geplante Jobs, w\u00e4hrend der Laptop nur als Bedienoberfl\u00e4che dient. Nachfolgend die wichtigsten Schritte und Hinweise f\u00fcr die Einrichtung.<\/p>\n
Ein Raspberry Pi eignet sich als \u201ealways\u2011on\u201c-Knoten: geringe Leistungsaufnahme, Platz f\u00fcr Agenten, Speicher, Jobs und Werkzeuge. Durch das Auslagern des Backends bleiben die Agenten vom prim\u00e4ren Laptop getrennt \u2014 das erh\u00f6ht die Kontrolle \u00fcber lokale Systemzugriffe und erm\u00f6glicht geplante oder lang laufende Abl\u00e4ufe, auch wenn der Laptop ausgeschaltet ist.<\/p>\n
Hermes verwendet Basic\u2011Auth\u2011Zugangsdaten f\u00fcr das Dashboard bzw. die Verbindung vom Desktop. Legen Sie im Hermes\u2011Konfigurationsverzeichnis auf dem Raspberry Pi (~\/.hermes\/.env) mindestens diese drei Eintr\u00e4ge an:<\/p>\n
HERMES_DASHBOARD_BASIC_AUTH_USERNAME=admin\nHERMES_DASHBOARD_BASIC_AUTH_PASSWORD=YOUR_STRONG_PASSWORD\nHERMES_DASHBOARD_BASIC_AUTH_SECRET=YOUR_RANDOM_SECRET<\/code><\/pre>\nErsetzen Sie YOUR_STRONG_PASSWORD und YOUR_RANDOM_SECRET durch sichere Werte. Das Secret sollte zuf\u00e4llig und lang genug sein; ein Passwortgenerator oder Schl\u00fcsselwerkzeug hilft dabei. Diese Zugangsdaten ben\u00f6tigt sp\u00e4ter Hermes Desktop, um sich mit dem Pi\u2011Backend zu verbinden.<\/p>\n
Backend starten: hermes serve<\/h2>\n
Auf dem Raspberry Pi startet das Backend mit dem Befehl:<\/p>\n
hermes serve --host 0.0.0.0 --port 9119<\/code><\/pre>\nDieser Prozess ist ein headless Backend; er stellt keine Browser\u2011UI bereit. Hermes Desktop kommuniziert mit diesem Dienst \u00fcber HTTP(S) auf dem angegebenen Port. Solange der Prozess l\u00e4uft, kann Hermes Desktop verbinden und die auf dem Pi verwalteten Agenten, Jobs, Memory\u2011Daten und Tools benutzen.<\/p>\n
Pr\u00fcfen Sie lokal auf dem Pi, dass auf Port 9119 ein Listener aktiv ist (z. B. mit ss oder netstat), bevor Sie versuchen, sich vom Laptop zu verbinden.<\/p>\n
Hermes Desktop installieren<\/h2>\n
Hermes bietet ein offizielles Installationsskript f\u00fcr die Desktop\u2011Komponente. Auf dem Laptop gen\u00fcgt der folgende, vom Projekt bereitgestellte Einzeiler:<\/p>\n
curl -fsSL https:\/\/hermes-agent.nousresearch.com\/install.sh | bash<\/code><\/pre>\nW\u00e4hrend der Installation werden Konfigurationsoptionen angeboten, etwa die Auswahl eines Terminal\u2011Backends (lokal, Docker, SSH etc.). Diese Auswahl betrifft, wie Hermes Shell\u2011Zugriffe auf Zielsysteme ausf\u00fchrt, ist aber unabh\u00e4ngig von der Remote\u2011Gateway\u2011Konfiguration, die sp\u00e4ter die Verbindung zum Raspberry Pi herstellt. F\u00fcr das vorgestellte Setup kann die Standardeinstellung beibehalten werden.<\/p>\n
Remote\u2011Gateway in Hermes Desktop einrichten<\/h2>\n
Starten Sie Hermes Desktop und \u00f6ffnen Sie die Einstellungen. Unter dem Punkt „Gateway“ w\u00e4hlen Sie die Remote\u2011Gateway\u2011Option und tragen als Remote\u2011URL die IP\u2011Adresse (oder den Hostnamen) des Raspberry Pi mit dem Port ein, z. B.:<\/p>\n
http:\/\/raspberrypi.local:9119<\/code><\/pre>\nNach dem Speichern verbindet sich Hermes Desktop mit dem entfernten Backend. Die Desktop\u2011App agiert dann als Bedienoberfl\u00e4che f\u00fcr den Hermes\u2011Server auf dem Pi; Modellauswahl oder andere serverseitige Einstellungen werden dabei vom Backend \u00fcbernommen, sofern Desktop keine lokale Modellkonfiguration \u00fcberschreibt.<\/p>\n
Daemonisierung: Hermes als systemd\u2011Dienst<\/h2>\n
Damit Hermes auf dem Pi automatisch beim Systemstart l\u00e4uft und nicht jedes Mal manuell gestartet werden muss, empfiehlt sich ein systemd\u2011Service. Legen Sie eine Datei wie \/etc\/systemd\/system\/hermes-server.service an und definieren Sie dort die wichtigsten Unit\u2011Eigenschaften: Abh\u00e4ngigkeit vom Netzwerk, Benutzer unter dem der Dienst laufen soll (z. B. pi), Pfad zur Environment\u2011Datei (~\/.hermes\/.env) und den ExecStart\u2011Befehl, der hermes serve mit Host und Port ausf\u00fchrt. Achten Sie darauf, den Pfad zum Hermes\u2011Binary korrekt anzugeben (z. B. \/home\/pi\/.local\/bin\/hermes).<\/p>\n
Nach dem Anlegen der Service\u2011Datei laden Sie systemd neu und aktivieren den Dienst sofort:<\/p>\n
sudo systemctl daemon-reload\nsudo systemctl enable --now hermes-server\nsudo systemctl status hermes-server<\/code><\/pre>\nMit dieser Konfiguration startet das Hermes\u2011Backend automatisch bei jedem Boot und bleibt nach Abst\u00fcrzen dank Restart\u2011Optionen wieder aktiv.<\/p>\n
Sicherheits\u2011 und Netzwerkhinweise<\/h2>\n\n- Sch\u00fctzen Sie die im .env definierten Basic\u2011Auth\u2011Zugangsdaten. Verwenden Sie starke Passw\u00f6rter und ein zuf\u00e4lliges Secret.<\/li>\n
- Wenn Sie das Backend nur im lokalen Netzwerk nutzen wollen, ist es ausreichend, den Port intern freizugeben. \u00d6ffnen Sie Ports im Router nur, wenn Sie Remote\u2011Zugriff \u00fcber das Internet ben\u00f6tigen und sichern Sie die Verbindung (z. B. mit einem SSH\u2011Tunnel oder VPN).<\/li>\n
- Hermes Desktop verbindet sich als Client mit dem Backend; achten Sie darauf, dass das Backend keine unn\u00f6tigen Systemrechte erh\u00e4lt. Auf dem Pi sollten nur die notwendigen Verzeichnisse und Nutzerberechtigungen gesetzt sein.<\/li>\n<\/ul>\n
Praxisfazit<\/h2>\n
Die Kombination aus einem immer laufenden Hermes\u2011Backend auf dem Raspberry Pi und Hermes Desktop auf dem Laptop bietet eine flexible und praktikable L\u00f6sung f\u00fcr lokale KI\u2011Agenten\u2011Workflows. Sie trennt Ausf\u00fchrung und Bedienung, erm\u00f6glicht geplante Aufgaben und reduziert die Risiken, die entstehen, wenn Agenten direkt auf einem prim\u00e4ren Arbeitsrechner laufen. Die Einrichtung ist technisch \u00fcberschaubar: .env\u2011Konfiguration, hermes serve\u2011Start, Desktop\u2011Installation und optional systemd\u2011Automatisierung reichen aus, um in wenigen Schritten produktiv zu arbeiten.<\/p>\n
Wenn Sie tiefer einsteigen, lohnt sich das Testen von Netzwerk\u2011Szenarien (lokal vs. extern), das Absichern des Zugangs und das Anpassen von Nutzerrechten auf dem Pi. Hermes bleibt dabei die Schnittstelle zwischen lokalen Modellen, Tools und den Agenten, w\u00e4hrend der Laptop vor allem die Steuerung und Interaktion \u00fcbernimmt.<\/p>\n