diff --git a/docs/BEDIENUNG.md b/docs/BEDIENUNG.md index 4879330..502b72f 100644 --- a/docs/BEDIENUNG.md +++ b/docs/BEDIENUNG.md @@ -6,14 +6,21 @@ > Im Alltag fasst du MC kaum an: `model: auto` + Auto-Swap laden Modelle selbst. Du öffnest es, um ein > Modell zu installieren/tauschen, die Auslastung zu prüfen, Gedächtnis zu pflegen oder ein Tool zu verbinden. -## Die 7 Bereiche -- **Zentrale** — Live CPU/RAM/GPU-Auslastung und Updates auf einen Blick. -- **Modell-Zentrale** — installierte Modelle + neue finden/laden + Gateway-Routing (auto-Rolle). -- **Diagnose** — Live-Dienste, Metriken, detaillierte Auslastung und System-Logs. -- **Gedächtnis** — geteilte Fakten/Regeln, die ALLE Tools (Hermes, IDEs) via MCP lesen/schreiben. -- **Verbinden** — fertige Konfig-Snippets für deine IDEs (Roo Code, Zed, etc.). -- **Hermes** — Agent-Status + „Hermes öffnen". -- **Anleitung** — Schritt-für-Schritt Einrichtung für Vibe-Coding auf deinem PC. +## Die Bereiche (Sidebar, Stand 09.07.2026) +- **Cockpit** — deine Box auf einen Blick (Status, Leistung, Morgenlage, Erinnerungen). +- **Auftragsbuch** — Vorschläge der Box (Werkstatt/Orchestrator/Traum) per Ein-Klick annehmen/ablehnen. +- **Modelle** — Speicherleiste, installierte Modelle + neue finden/laden, Rollen (hermes/fast/heavy/…). +- **Gedächtnis** — geteilte Fakten/Regeln, die ALLE Tools (Hermes, Desktop, PC) via MCP lesen/schreiben. +- **Wissen** — Lucys Wissens-Vault (Traum-Notizen, `[[verlinkt]]` navigierbar). +- **Chronik** — was die Box von allein getan hat + Zeitmaschine (Ein-Klick-Restore). +- **Verbinden** — fertige Anbindungs-Snippets (Hermes Desktop · Kilo Code · Claude Code). +- **Hermes** — Agent-Status & Verdrahtung; „Hermes-GUI öffnen" zeigt die eingebaute Weboberfläche. +- **Konsole** — direkte Box-Shell (SSH-artig) im Browser. +- **Anleitung** — Schritt-für-Schritt-Einrichtung. + +> **Zum Arbeiten mit dem Agenten** (Coding, Projekte, lange Threads) nutzt du die +> **Hermes-Desktop-App am PC** — MC2 ist der Maschinenraum der Box. Wie die App andockt: +> `docs/HERMES_SETUP.md`, Abschnitt „Hermes Desktop (PC) anbinden". ## Modell installieren **Tab „Modelle & Routing" → „Modelle finden":** @@ -29,9 +36,12 @@ - **Kontext** ändern: auf die Kontext-Zahl (✎) klicken. **Entfernen:** 🗑 (GGUF-Datei bleibt erhalten). - „Auto-Swap" = llama-swap lädt automatisch, was gerade angefragt wird; du musst nichts laden/entladen. -## IDE verbinden (Vibe Coding am eigenen PC) -„Verbinden" → Tool wählen (Roo Code/OpenCode/Zed/Continue) → Snippet kopieren. Zeigt auf -`http://192.168.178.151:9001/v1`, Modell **`auto`**. Memory-MCP-Snippet separat einfügen → geteiltes Gedächtnis. +## Agent/IDE verbinden (Arbeiten am eigenen PC) +„Verbinden" → Eintrag wählen → Snippet/Anleitung kopieren. **Hermes Desktop** (Standard) dockt +remote an die Box an (Gateway-URL über den MC2-Proxy, Token liegt auf der Box — +siehe `docs/HERMES_SETUP.md`). **Kilo Code** und **Claude Code** zeigen auf +`http://192.168.178.151:9001/v1`. Memory-MCP-Snippet separat einfügen → geteiltes Gedächtnis. +(Zed ist abgeschafft — Hermes Desktop hat die IDE-Rolle übernommen, 09.07.2026.) ## Gedächtnis pflegen „Gedächtnis": Fakt/Regel hinzufügen (Kategorie wählen), suchen/filtern, **🧹 Aufräumen** entfernt Dubletten. diff --git a/docs/DISASTER_RECOVERY.md b/docs/DISASTER_RECOVERY.md index a1aa0a9..bf46f19 100644 --- a/docs/DISASTER_RECOVERY.md +++ b/docs/DISASTER_RECOVERY.md @@ -120,7 +120,9 @@ Legende Restore-Quelle: 📦 = aus Backup-Tarball · ⬇️ = Re-Download/Instal | Checkpoints (optional) | `~/.hermes/checkpoints/` (existiert nicht) | ⏭️ skip | nein | | **Token-/Ersparnis-Statistik** | `~/.hermes/token_stats.json` | 📦 | **nein → Anhang B** | | Dienst `hermes-gateway` (`:8642`) | systemd-User | ⬇️ | nein | -| Hermes-Terminal (ttyd → `hermes chat`, `:7681`) | systemd-User `hermes-terminal` | ⬇️ deploy.sh (+ttyd apt) | nein | +| Desktop-Gateway `hermes-builtin-ui` (`:9119`) | systemd-User | ⬇️ deploy.sh | nein | +| Desktop-Gateway-Token-Drop-in | `~/.config/systemd/user/hermes-builtin-ui.service.d/session-token.conf` | 🔑 neu erzeugen (Wert auch in `~/.hermes/desktop-gateway-token`, chmod 600) | **nein** | +| Desktop-Gateway-Token-Kopie | `~/.hermes/desktop-gateway-token` (chmod 600) | 🔑 | **nein** | ### H · MCP-Server (4) | Komponente | Ort | Quelle | Im Backup? | @@ -146,7 +148,7 @@ Legende Restore-Quelle: 📦 = aus Backup-Tarball · ⬇️ = Re-Download/Instal | Komponente | Ort | Quelle | Im Backup? | |---|---|---|---| | PC-Executor (Windows) | `client/hermes-pc/` → Scheduled Task | 🌐 Git + Task | n/a (anderer Host) | -| Hermes-WebUI (nesquena, optional, `:8787`) | `~/hermes-webui` | ⬇️ git clone | nein | +| Hermes Desktop (Windows-App) | `%LOCALAPPDATA%\hermes` + `connection.json` in `%APPDATA%\Hermes\` | ⬇️ Hermes-Setup.exe + Remote-URL/Token neu eintragen | n/a (anderer Host) | --- @@ -178,7 +180,7 @@ MC2 erkennt unkonfigurierten Zustand → Frontend-Route `/setup` statt Dashboard (📦 Referenz-Audio zurück, oder neu aufnehmen/hochladen). 8. **Modelle** — aus llama-swap-Manifest automatisch nachladen (`POST /api/models/install`, Fortschritt `GET /api/jobs`) ODER geführte Discover-Neuauswahl. Reihenfolge: Brain → heavy → Rest. -9. **Externe Checkliste** — PC-Executor (Windows-Task), Hermes-WebUI als Haken. +9. **Externe Checkliste** — PC-Executor (Windows-Task), Hermes Desktop (App + Token) als Haken. 10. **Verifikation & Abschluss** — `stack-postcheck.sh` + `hermes-postcheck.sh` → grün/rot-Liste → Dashboard. **Technik:** neuer Router `backend/routers/setup.py` diff --git a/docs/HERMES_SETUP.md b/docs/HERMES_SETUP.md index 3f27c83..83e3e1a 100644 --- a/docs/HERMES_SETUP.md +++ b/docs/HERMES_SETUP.md @@ -22,20 +22,32 @@ Aliase sauber: `fast` (Qwen3.6-35B-A3B), `heavy` (Qwen3.5-122B-A10B), `coder`, ` **Ko-Residenz** (optional): Gruppe `swap:false` für `hermes`+`fast` → beide warm; `heavy`/`vision` on-demand. GTT beobachten (~124 GB Limit). -## 3. hermes-webui installieren (nesquena, standalone) +## 3. Hermes Desktop (PC) anbinden — die Agent-Oberfläche +> Historie: früher lief hier das nesquena-hermes-webui (:8787), danach der „Hermes GUI"-Tab in +> MC2. Beides ist seit 09.07.2026 abgebaut — die Agent-Oberfläche ist die **Hermes-Desktop-App** +> am Windows-PC; auf der Box bleibt nur `hermes-builtin-ui` (:9119, loopback) als **Desktop-Gateway** +> (Unit kommt aus `deploy/deploy.sh`). + +**Auf der Box (einmalig):** statischer Session-Token, damit die App Dienst-Neustarts/Deploys übersteht: ```bash -cd ~ && git clone https://github.com/nesquena/hermes-webui && cd hermes-webui -python3 bootstrap.py # erkennt hermes-agent, baut venv, installiert Deps -mkdir -p ~/.config/environment.d -echo 'HERMES_WEBUI_PASSWORD=' > ~/.config/environment.d/hermes-webui.conf -# Unit deploy/hermes-webui.service → ~/.config/systemd/user/ (HOST=0.0.0.0, PORT=8787) -systemctl --user enable --now hermes-webui -loginctl enable-linger hitonabi +mkdir -p ~/.config/systemd/user/hermes-builtin-ui.service.d +# session-token.conf: [Service] + Environment=HERMES_DASHBOARD_SESSION_TOKEN= +# Wert zusätzlich nach ~/.hermes/desktop-gateway-token legen (chmod 600 auf beide Dateien) +systemctl --user daemon-reload && systemctl --user restart hermes-builtin-ui ``` -Zugriff vom Windows-PC: `http://192.168.178.151:8787` (mit Passwort). MC2-Unit -`HERMES_WEBUI_URL=http://192.168.178.151:8787` setzen → „Hermes öffnen" zeigt darauf. -**Danach das alte offizielle Dashboard stilllegen** (eine WebUI): -`systemctl --user disable --now hermes-dashboard` (:9119). + +**Am PC:** `Hermes-Setup.exe` (hermes-assets.nousresearch.com) installieren, dann in +`%APPDATA%\Hermes\connection.json` den Remote-Modus setzen: +```json +{ "mode": "remote", + "remote": { "url": "http://192.168.178.151:9001/hermes-ui", + "authMode": "token", + "token": { "encoding": "plain", "value": "" } } } +``` +Die URL läuft über den **bestehenden MC2-Proxy** (`/hermes-ui/*` inkl. WebSockets) — kein neuer +Port, keine neue Firewall-Freigabe. Alternativ in der App: Settings → Gateway. Desktop-Sessions +nutzen das volle `cli`-Toolset; die schlanke `api_server`-Lane (Lucy/Voice) bleibt unberührt. +Token-Werte gehören NIE in Doku/Git — nur die Pfade. ## 4. Hermes-Hirn = dediziertes Hermes-4-14B + Delegation (NICHT model:auto) In `~/.hermes/config.yaml`: