Files
2026-10-10 22:00:06 +00:00

55 lines
2.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: Hermes WebUI (Hermex-Backend)
category: systems
tags: [hermes, hermex, ios, webui, systemd, mobile]
created: "2026-10-10"
modified: "2026-10-10"
related: [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`