Hermes
Einleitung und Rolle
Hermes ist einer der beiden Agenten auf dem VPS. Er stellt die lokale Agentenlaufzeit bereit, über die der Server selbst verwaltet, dokumentiert und erweitert werden kann. Hermes läuft nicht als Docker-Stack, sondern als User-Service unter dem Benutzer marco.
Zur Infrastruktur gehören zwei öffentlich geroutete Oberflächen:
| Route |
Zweck |
Zugriff |
api-hermes.marcosudau.com |
OpenAI-kompatibler API-Endpunkt / Hermes API |
eigene API-Absicherung über Hermes-Konfiguration |
dashboard-hermes.marcosudau.com |
Web-Dashboard für Hermes |
Hermes-eigene Oberfläche |
Hermes ist damit kein gewöhnlicher Dienst wie Portainer oder Uptime Kuma, sondern Teil der Administrations- und Automationsschicht. Die Dokumentation behandelt deshalb vor allem Laufzeit, Ports, Routen, persistente Daten und Abhängigkeiten.
Persistente Daten und Backup-Relevanz
| Pfad |
Bedeutung |
Backup-Relevanz |
/home/marco/.hermes/ |
Hermes Home, Konfiguration, Skills, Memory, Logs, Arbeitsdaten |
hoch |
/home/marco/.hermes/hermes-agent/ |
Hermes-Agent-Repository und Python-venv |
mittel bis hoch |
/home/marco/.config/systemd/user/hermes-gateway.service |
systemd-User-Service für Gateway/API |
hoch |
/home/marco/.config/systemd/user/hermes-dashboard.service |
systemd-User-Service für Dashboard |
hoch |
Konfigurationsdateien können sensible Werte enthalten. Secret-Werte werden nicht in dieser Dokumentation notiert.
Laufzeit, Prozesse und Ports
| Unit |
Prozess |
Zweck |
hermes-gateway.service |
python -m hermes_cli.main gateway run --replace |
Gateway/API-Server |
hermes-dashboard.service |
python -m hermes_cli.main dashboard --host 127.0.0.1 --port 9119 --no-open |
Web-Dashboard |
| Port |
Bindung |
Zweck |
127.0.0.1:8642 |
lokal |
Hermes API / Gateway |
127.0.0.1:9119 |
lokal |
Hermes Dashboard |
Routen und Caddy
| Registry-ID |
Hostname |
Typ |
Upstream |
hermes-api |
api-hermes.marcosudau.com |
reverse_proxy |
http://127.0.0.1:8642 |
hermes-dashboard |
dashboard-hermes.marcosudau.com |
reverse_proxy |
http://127.0.0.1:9119 |
Beim Dashboard setzt die Registry einen eigenen Upstream-Header (Host: 127.0.0.1:9119, X-Forwarded-Proto: https).
Zugehörige Dienste und Abhängigkeiten
| Abhängigkeit |
Rolle |
| Caddy |
HTTPS-Reverse-Proxy |
| systemd --user |
Prozessverwaltung |
| Python-venv |
Hermes-Laufzeitumgebung |
| Open WebUI |
kann Hermes als Backend/API-Endpunkt nutzen |
Secrets und Umgebungsvariablen
| Bereich |
Hinweis |
| Hermes-Konfiguration |
liegt unter /home/marco/.hermes/ |
| API-Keys / Provider |
nicht im Klartext dokumentieren |
| systemd-Umgebung |
HERMES_HOME=/home/marco/.hermes, VIRTUAL_ENV=/home/marco/.hermes/hermes-agent/venv |
Betrieb und Prüfung
systemctl --user status hermes-gateway.service
systemctl --user status hermes-dashboard.service
ss -tulpn | grep -E ':(8642|9119)'
curl -I https://api-hermes.marcosudau.com
curl -I https://dashboard-hermes.marcosudau.com