Files
memory/systems/hermes-webui.md
T
2026-10-10 22:00:06 +00:00

2.8 KiB
Raw Blame History

title, category, tags, created, modified, related
title category tags created modified related
Hermes WebUI (Hermex-Backend) systems
hermes
hermex
ios
webui
systemd
mobile
2026-10-10 2026-10-10
systems/hermes-agent-01
systems/sarah-hermes
reference/ip-map

Hermes WebUI (Hermex-Backend auf hermes-agent-01)

Third-Party-Server hermes-webui (github.com/nesquena/hermes-webui) als Backend für die iOS-App Hermex. NIEMALS verwechseln: Hermex spricht NICHT mit dem offiziellen hermes dashboard (:9119) — das ist ein anderes Protokoll.

Stack

Komponente Wert
Service systemd hermes-webui-dominik.service (system-weit, enabled)
Binary /opt/hermes-webui/server.py unter /home/debian/hermes-agent/venv/bin/python3 (Agent-Venv = Superset; Server importiert Agent-Module in-process)
Listen 0.0.0.0:8790 (LAN-only; Runner 10.0.30.230)
Auth HERMES_WEBUI_PASSWORD (1P Vault Hermes → Item dominik-hermes-webui, bgjgnoe57n2uteyqzqvoodgtqq); Signed-Cookie, Key auto-gen in ~/.hermes/webui/.signing_key
Agent-Integration HERMES_HOME=/home/debian/.hermes, HERMES_WEBUI_AGENT_DIR=/home/debian/hermes-agent (Checkout liegt NICHT unter ~/.hermes/hermes-agent!)
Cron KEIN Scheduler-Thread im WebUI-Prozess — Scheduler bleibt allein im Gateway, WebUI nur API-Zugriff auf jobs.json (Doppel-Feuer ausgeschlossen)
State WebUI-eigene Sessions in ~/.hermes/webui/; CLI/Telegram-Sessions via state.db-Bridge sichtbar (read-only für alte, materialisierbar)
Logs /var/log/hermes-webui/dominik.log, logrotate daily×7 (/etc/logrotate.d/hermes-webui; logrotate musste auf dem Runner nachinstalliert werden)

Hermex-Verbindungswerte (iOS-App)

  • Server-URL: http://10.0.30.230:8790
  • Passwort: 1Password Vault „Hermes" → dominik-hermes-webui

Unterwegs nur via VPN (WireGuard) erreichbar — bewusst kein Internet-Exposure.

API-Spickzettel

  • GET /health, GET /api/auth/status (password_auth_enabled)
  • POST /api/auth/login {password} → Cookie; falsches PW → 401
  • GET /api/sessions — Cold-Start 34–70 s (state.db-Scan), warm 0,2 s
  • POST /api/session/new → eigene hex-ID (mitgegebenes session_id-Feld wird IGNORIERT)
  • POST /api/chat {session_id, message} → {status:"done", answer} (Agent-Subprocess)
  • Chat auf fremde CLI/TG-Session-ID → KeyError/500 (read-only)

Pitfalls

  • op item view <id> --vault <v> existiert nicht → op read "op://Hermes/<id>/password"
  • Unit-Templating per sed-%-Format zerstört Unit (static, Garbage-PW) → Python-Substitution
  • Gateway-Self-Guard blockiert kombinierte Terminal-Commands mit state.db-Strings nearby (False-Positive) → aufteilen

Verwandt

  • Sarahs Instanz: systems/sarah-hermes (VM107, Docker-Variante :8787)
  • Solution Doc: docs/solutions/integrations/2026-10-10-hermex-ios-hermes-webui-backend.md