Initial version of the Hermes self learning agent setup of JR IT Services.

2026-04-21 11:53:29 +02:00
commit 7f9b0e6c5f
31 changed files with 1966 additions and 0 deletions
@@ -0,0 +1,57 @@
+# Hermes in diesem Setup
+
+## Betriebsmodus
+
+Dieses Repo faehrt Hermes **im Container** als Gateway.
+
+Wichtige Daten landen in `./state/hermes`, das auf `/opt/data` im Container gemountet wird. Laut offizieller Doku ist `/opt/data` der Single Source of Truth fuer Config, Sessions, Skills, Memories und Logs.
+
+## Initialisierung
+
+1. `./scripts/alanctl bootstrap`
+2. `./scripts/alanctl init-hermes`
+3. `./scripts/alanctl up`
+
+`init-hermes` startet den offiziellen Setup-Wizard interaktiv.
+
+## Dashboard
+
+Optional:
+
+```bash
+./scripts/alanctl up --dashboard
+```
+
+Danach ist das Dashboard standardmaessig auf `http://127.0.0.1:19119` erreichbar.
+
+## Wichtige Hinweise
+
+- Nicht zwei Hermes-Gateway-Container gegen dasselbe Datenverzeichnis starten.
+- Falls du spaeter Messaging-Plattformen oder Provider-Keys nutzt, verwalte sie im Hermes-Datenordner bzw. in dessen `.env`.
+- Fuer Browser-Tools ist `shm_size=1g` gesetzt.
+
+
+## Update-Betrieb
+
+Empfohlener Alltag:
+
+```bash
+./scripts/alanctl pin-hermes stable
+./scripts/alanctl update-hermes
+```
+
+Gezieltes Upgrade auf einen bestimmten Tag:
+
+```bash
+./scripts/alanctl update-hermes v0.9.3
+```
+
+Der Update-Workflow macht automatisch:
+
+1. Backup des Hermes-State
+2. Pull des Ziel-Images
+3. Recreate des Containers
+4. Warten auf erfolgreichen Healthcheck
+5. automatisches Zurueckstellen auf den vorherigen Tag bei Fehlern
+
+Der zuletzt erfolgreiche Stand wird lokal gespeichert und kann mit `rollback-hermes` erneut ausgerollt werden.