fix+docs: Bug-Fixes, vollstaendige Dokumentation v8
Bug-Fixes: - hermes_agent.py: asyncio.get_event_loop() → get_running_loop() (Python 3.10+) - routers/hermes.py: Thread-Lock fuer Whisper-Init, HERMES_WINDOWS_USER Import, Piper stderr logging, __import__ Anti-Pattern entfernt - routers/memory.py: SQLite WAL-Mode, Kategorie-Enum-Validierung (user/instruction/stable/versioned/ephemeral) - HermesPanel.svelte: findLast() → reverse().find() (Browser-Kompatibilitaet) - ConnectPanel.svelte: Hardcoded Username durch Platzhalter ersetzt Docs: - CLAUDE.md: komplett aktualisiert (v7+v8, Hermes, Memory, alle Env-Vars) - ROADMAP.md: v7+v8 als erledigt, naechste Features (v8.1-v9.1) - README.md: komplett neu geschrieben (Agentic OS Konzept, alle Features) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Hitonabi
+64
-147
@@ -1,165 +1,82 @@
|
||||
# Mission Control - Roadmap v2
|
||||
# Mission Control — Roadmap
|
||||
|
||||
**Nordstern:** Den Bosgame nie wieder via SSH/Putty bedienen müssen. **100 % Automatisierung oder Klicki-Bunti.**
|
||||
**Nordstern:** Den Bosgame nie wieder via SSH/Putty bedienen. **100 % Automatisierung oder Klicki-Bunti.**
|
||||
**Größeres Ziel:** Mission Control als persönliches **Agentic OS** — lokaler, privater KI-Assistent der das gesamte Setup kennt und steuert.
|
||||
|
||||
---
|
||||
|
||||
## v8 — Hermes Agent / Agentic OS Kern (✅ UMGESETZT & live, Stand 2026-06-23)
|
||||
|
||||
**Hermes**: dauerhafter lokaler KI-Assistent auf dem Bosgame. Text + Voice, Tool Calling, Gedächtnis.
|
||||
|
||||
- **`hermes_agent.py`**: ReAct-Agent mit Tool-Set (read_file, list_dir, run_command, system_status, memory r/w, web_search). Modell-Routing: scout für einfache Tasks, coder für komplexe.
|
||||
- **`routers/hermes.py`**: WS `/chat` (streaming), POST `/transcribe` (Whisper STT, CPU), POST `/tts` (Piper TTS, weibliche Stimme Kerstin), GET `/status`, GET `/pubkey`.
|
||||
- **HermesPanel.svelte**: Chat-UI mit Token-Streaming, Tool-Anzeige, Mikrofon-Button (MediaRecorder), TTS-Wiedergabe, Setup-Wizard (Windows SSH + Piper-Anleitung).
|
||||
- **Setup-Wizard**: zeigt Schritt-für-Schritt Einrichtung für Piper + Windows OpenSSH.
|
||||
|
||||
**Offene Schritte (nicht Code, sondern Einrichtung):**
|
||||
- [ ] Piper Binary + Kerstin-Stimme auf dem Bosgame installieren (Befehle im Setup-Wizard)
|
||||
- [ ] Windows OpenSSH Server aktivieren (5 PowerShell-Befehle im Setup-Wizard)
|
||||
- [ ] SSH-Key auf Bosgame generieren: `ssh-keygen -t ed25519 -C "hermes-agent@bosgame" -f ~/.ssh/id_ed25519_hermes_agent -N ""`
|
||||
- [ ] `HERMES_WINDOWS_HOST` + `HERMES_WINDOWS_USER` in `mission-control.service` setzen
|
||||
|
||||
---
|
||||
|
||||
## v7 — Memory Layer / Gedächtnis (✅ UMGESETZT & live, Stand 2026-06-23)
|
||||
|
||||
Persistentes, tool-übergreifendes Gedächtnis für alle KI-Tools via MCP.
|
||||
|
||||
- **`routers/memory.py`**: SQLite CRUD + Export, WAL-Mode, 5 Kategorien mit Enum-Validierung.
|
||||
- **`mcp_memory.py`**: stdio-MCP-Server — Tools: get/add/search/update/delete_memory. Einmalig in Cline/OpenCode/Claude Code einbinden.
|
||||
- **MemoryPanel.svelte**: Gedächtnis-Tab mit Kategorie-Filter, Inline-Edit, Add-Formular.
|
||||
- **ConnectPanel.svelte**: Gedächtnis-MCP Setup-Guide mit Config-Snippets.
|
||||
- **5 Kategorien**: `user` (wer du bist) · `instruction` (Verhaltensregeln für alle Tools) · `stable` (Projektfakten) · `versioned` (Tech-Versionen) · `ephemeral` (7 Tage, dann weg).
|
||||
|
||||
---
|
||||
|
||||
## v6 — Workflow & Politur (✅ UMGESETZT & live, Stand 2026-06-21)
|
||||
|
||||
- **Dashboard/Toolbar:** „Dein Stack" zeigt echtes Modell hinter dem Alias; Top-News-Karte;
|
||||
Toolbar-Update-Badges (`/api/updates`: OS via apt + Modell-Upgrades).
|
||||
- **News & Guide entklobigt:** News als Magazin-Layout; Guide neu mit **Tutorials/Workflows**
|
||||
(erster Workflow, Kontext leeren, „brauche ich einen Agenten?", Auto-Swap, Tools nutzen) +
|
||||
kompakten Konzept-Karten.
|
||||
- **Cookbook smart:** Modelle **diversifiziert** best-in-class (Qwen3-Coder, Gemma 3, Mistral Small,
|
||||
DeepSeek-R1, Qwen3-VL) + neue Kategorie „Nachdenken & Logik"; „**Beste Wahl für dein System**"
|
||||
hervorgehoben (`recommended_id`); GGUF beim Install dynamisch aufgelöst.
|
||||
- **Erklärt:** Swapping/Spitzenbedarf-Klartext, „nur eins läuft gleichzeitig, kein Summieren".
|
||||
- Dashboard zeigt echtes Modell hinter dem Alias; Toolbar-Update-Badges (OS + Modell-Upgrades).
|
||||
- News als Magazin-Layout; Guide neu mit Tutorials/Workflows + Konzept-Karten.
|
||||
- Cookbook: Modelle diversifiziert (Qwen3/Gemma/Mistral/DeepSeek), „Beste Wahl für dein System".
|
||||
|
||||
---
|
||||
|
||||
## v5 — „Anfänger-Lotse" (✅ UMGESETZT & live, Stand 2026-06-21)
|
||||
## v5 — „Anfänger-Lotse" (✅ UMGESETZT & live)
|
||||
## v4 — „Der Lotse" (✅ UMGESETZT & live)
|
||||
## v3 — Redesign + Beginner-UX + Security (✅ UMGESETZT & live)
|
||||
|
||||
Wasserdicht erklären + aktualisieren + smart empfehlen (für blutige Anfänger).
|
||||
- **Erklären:** Swapping-Klartext + Spitzenbedarf pro Modell (nur eins läuft gleichzeitig, kein Summieren);
|
||||
Kontext-ⓘ-Tooltips; **Guides-Tab neu** (LLM/GGUF/Quant/Kontext/Swapping/MCP/Skills/Agenten).
|
||||
- **Aktualisieren:** Rezepte auf Juni-2026-Modelle (Qwen3-Coder-30B-A3B, Qwen3-8B/30B, Qwen2.5-VL-7B);
|
||||
GGUF-Datei beim Install **dynamisch aufgelöst** (`_pick_gguf`); „kein GGUF" entschärft + erklärt;
|
||||
**Empfohlene Tools** in Verbinden (OpenCode/Cline/Continue + MCP); **HF-Token** in Einstellungen.
|
||||
- **Smart:** News-Quellen aufgeräumt (Qualitäts-RSS statt Git-Tags); **Upgrade-Vorschläge**
|
||||
(„Modell X ersetzt dein Y, weil …" → 1-Klick-Tausch via `/install-model`, `UPGRADES`-Map in recipes.py).
|
||||
Details in Git-History.
|
||||
|
||||
---
|
||||
|
||||
## v4 — „Der Lotse" (✅ UMGESETZT & live, Stand 2026-06-21)
|
||||
## Nächste Features (Vorschläge)
|
||||
|
||||
Sprung vom Modell-*Manager* zum geführten *Berater*. Alles **automatisch aus Modellen + Hardware**.
|
||||
KISS/SoC blieb: je Bereich ein `routers/<x>.py` + `js/panels/<x>.js` + Nav-Eintrag, keine DB, keine
|
||||
schwere Lib. **Alle 4 Schritte sind live** — Checklisten unten erledigt.
|
||||
### v8.1 — Hermes Windows-SSH (Phase C)
|
||||
- [ ] Hermes kann Dateien auf Windows-PC lesen/schreiben via paramiko SSH
|
||||
- [ ] Tool: `read_file_windows(path)`, `write_file_windows(path, content)`, `run_command_windows(cmd)`
|
||||
- [ ] Hermes updated opencode.json / Zed-Settings automatisch wenn neue Modelle verfügbar
|
||||
- [ ] Mission Control Setup-Wizard: SSH-Test-Button mit grünem Haken
|
||||
|
||||
### 1. Optimale Kontextfenster (Fundament)
|
||||
- [x] `hw_math`: `max_ctx_for(params_b, quant, ram_gb)` — Umkehrfrage „welcher ctx passt noch?"
|
||||
(KV-Cache-Bedarf vs. freier Speicher).
|
||||
- [x] Pro Modell empfohlener ctx + Klartext-Begründung; Ein-Klick „optimal setzen" (nutzt `update_model`).
|
||||
- [x] Speist Cookbook (2.) + Modelle-Tab.
|
||||
### v8.2 — `.well-known/opencode` Remote Config
|
||||
- [ ] `GET /.well-known/opencode` — vollständige, dynamisch generierte OpenCode-Config (provider + models + MCP)
|
||||
- [ ] OpenCode Desktop lädt beim Start automatisch alle Configs von Mission Control
|
||||
- [ ] Einmalig: `OPENCODE_REMOTE_CONFIG=http://192.168.178.151:9000/.well-known/opencode` setzen
|
||||
|
||||
### 2. Cookbook 2.0 — Use-Case-getrieben
|
||||
- [x] Einstieg „Wofür?": Coding · Bilder verstehen · Allrounder/Chat · Lange Dokumente · Agenten/Tool-Use · Schnell & sparsam.
|
||||
- [x] Pro Use-Case ein kuratiertes **Setup/Stack** (mehrere Modelle/Rollen) statt Einzelmodell, mit
|
||||
Hardware-**Ampel pro Setup** (via `hw_math`) + vorgeschlagenem ctx. Rezepte als Daten (`recipes.py`).
|
||||
- [x] „Komplettes Setup installieren" — download + register aller Modelle in einem Rutsch.
|
||||
- [x] Roh-Suche bleibt als „Profi-Modus".
|
||||
### v9 — Agentic OS Orchestrierung
|
||||
- [ ] Hermes kann geplante Tasks ausführen (Cron-artig, z.B. täglich Modell-Updates prüfen)
|
||||
- [ ] Task-Queue: Aufgaben übergeben, Ergebnis später abholen
|
||||
- [ ] Push-Notifications: Hermes meldet sich wenn er fertig ist
|
||||
- [ ] Multi-Step-Workflows: "Recherchiere X, schreibe Zusammenfassung, speichere ins Gedächtnis"
|
||||
|
||||
### 3. Verbinden / Orchestrierung (neuer Tab, erweitert Guides)
|
||||
- [x] Geführter Assistent je Tool (OpenCode/Cline/Cursor/OpenWebUI) mit exakter Config.
|
||||
- [x] **„Verbindung testen"** — `routers/integration.py` `/api/integration/test` ruft llama-swap
|
||||
`/v1/models` (LAN-URL) und meldet Erfolg + Modell-Liste zurück.
|
||||
- [x] Bild-Eingaben für Fehleranalyse: erkennt Vision-Modell (sonst Hinweis „Vision installieren") +
|
||||
Copy-Snippet im OpenAI-Vision-Format. Auto-Swapping erklären.
|
||||
### v9.1 — Guides & Connect aktualisieren
|
||||
- [ ] Zed als primäre Editor-Empfehlung (Inline-Completion + Agent, lokal)
|
||||
- [ ] Antigravity entfernen oder als "Cloud-first, lokal wackelig" markieren
|
||||
- [ ] Continue als "unsichere Zukunft (Cursor-Akquisition)" markieren
|
||||
- [ ] `.well-known/opencode`-Snippet in Connect-Tab ergänzen
|
||||
|
||||
### 4. News-Board (neuer Tab)
|
||||
- [x] `routers/news.py`: kuratierte RSS/Atom-Feeds (HuggingFace-Blog, r/LocalLLaMA, llama.cpp-Releases,
|
||||
Ollama) via `httpx` + stdlib-`xml.etree` (kein neuer Dep), In-memory-Cache (~30 min TTL).
|
||||
- [x] `panels/news.js`: Karten (Titel/Quelle/Datum/Link), sanitisiert, LAN-only; Hardware-relevante
|
||||
Releases (gfx1151/ROCm) hervorheben.
|
||||
|
||||
---
|
||||
|
||||
## v3 — Redesign + Beginner-UX + Security (Stand 2026-06-21, live)
|
||||
|
||||
Nach der funktional kompletten v2 (unten) umgesetzt — Fokus: **schick, selbsterklärend, wasserdicht.**
|
||||
|
||||
- **Design-System:** EINE Akzentfarbe (Teal), Bento, Monospace-Zahlen, beschriftete Sidebar; Inline-Styles
|
||||
raus → alles über `components.css`. Mockup-getrieben (Übersicht + Cookbook).
|
||||
- **Beginner-UX:** Klartext-Microcopy, Fachbegriffe übersetzt, menschliches Hero-Urteil, geführte Aktionen,
|
||||
`confirmModal`/`promptModal` für heikle Aktionen, Fit-Ampel + Sortierung im Cookbook, Guides mit Kopier-Buttons.
|
||||
- **Security:** sudo-Passwort über **stdin** (kein Leak mehr im Job-Log/`ps`), ehrlicher Security-Chip
|
||||
(`status.secured`), WS-Token (Query). Bind bleibt `0.0.0.0` (LAN-only), Token optional.
|
||||
- **Self-Update:** Button „Mission Control aktualisieren" (`/api/self-update`: git pull → rsync → restart) —
|
||||
end-to-end verifiziert. `no-cache`-Middleware für sofortige UI-Wirkung nach Deploy.
|
||||
- **Infra geklärt:** llama-swap lauscht `*:8080` (LAN); `MC_UPDATE_CMD` = llama.cpp-Engine-Update (≠ MC selbst).
|
||||
|
||||
Details/Konventionen: **CLAUDE.md**. Modus jetzt: Feinschliff & Bug-Hunting.
|
||||
|
||||
---
|
||||
|
||||
## Projektstand v2 (Stand 2026-06-20)
|
||||
|
||||
**✅ Schritt 1 erledigt & live auf `:9000`** — *SoC-Refactor + Design 2.0 als Fundament* (Commit `3649394`).
|
||||
Backend in Helfer + `routers/*` zerlegt, Frontend in ES-Module (`js/core` + `js/panels`) + ausgelagertes
|
||||
CSS, neues Dashboard-Layout (Sidebar-Nav, Topbar, Alert-Banner, Hero, KPI-Kacheln, Health-Signale,
|
||||
Modell-Listen, Aktivitäts-Stream) angelehnt an `docs/mission-control-overview.png`. Bestehende Funktionen
|
||||
1:1 migriert, Endpoint-URLs unverändert. Architektur + Deploy-Weg stehen in **CLAUDE.md**.
|
||||
|
||||
**✅ Schritt 2 erledigt & live** — *Feature 3: Live-Auslastung*. `system.py` Router mit `psutil` und sysfs für CPU/RAM/Disk/GPU/Temp.
|
||||
|
||||
**Reihenfolge (abgestimmt):** Design/Architektur zuerst (✅), dann Quick Wins, Security-Brocken zuletzt:
|
||||
`1 (✅) Fundament → 2 (✅) Feature 3 Live-Auslastung → 3 (✅) Feature 6 Mehr LLM-Metriken → 4 (✅) Feature 1 Server-Management → 5 (✅) Feature 4 Cookbook → 6 (✅) Feature 7 Integrations-Anleitungen → 7 (✅) Feature 2 Live-Terminal`.
|
||||
|
||||
**Arbeitsweise je Schritt:** neuer `routers/<x>.py` + `js/panels/<x>.js` + Nav-Eintrag, sauber degradierend.
|
||||
Bauen + Smoke-Test auf Windows, dann push→pull→rsync→restart auf den Bosgame (CLAUDE.md „Entwickeln & Deployen").
|
||||
Ein Commit je Schritt. **Ich (KI) habe key-basierten SSH-Zugang zum Bosgame und kann selbst deployen+restarten.**
|
||||
|
||||
**→ Letzte Errungenschaften:**
|
||||
- **WebSockets:** `/api/system/stream` für super-fluide 2Hz System-Metriken (CPU/RAM/GPU) ohne HTTP-Overhead.
|
||||
- **Cookbook 2.0:** Suchergebnisse laden Metriken asynchron ("Lazy Loading"), inklusive Hardware-Fit-Berechnung. UI ist auf Premium-Niveau angehoben (Hover-Effekte, Badge-Colors).
|
||||
- **Log-Streaming:** `GET /running`-Polls werden herausgefiltert, Live-Konsolen sind sauber.
|
||||
|
||||
**→ Aktueller Modus = Wartung & Feinschliff.**
|
||||
- Die v2 Roadmap ist damit zu 100% umgesetzt.
|
||||
- Fokus liegt ab sofort auf Stabilität, Bug-Hunting und dem finalen "Polishing".
|
||||
|
||||
---
|
||||
|
||||
## Features
|
||||
|
||||
### 1. Server-Management ("Update-Panel 2.0") (✅ Erledigt)
|
||||
Aktuell gibt es nur "Container aktualisieren" + "Alles aus dem Speicher". Ziel: den kompletten Server aus der UI verwalten.
|
||||
- [x] OS-/Core-Updates (`apt update/upgrade`) per Knopf, mit Live-Output
|
||||
- [x] Dienste steuern (`llama-swap`, `mission-control`: Status, Restart)
|
||||
- [x] Reboot / Health-Übersicht
|
||||
- [x] Referenz: altes `ai-control`-Skript als Funktionsvorlage
|
||||
- ⚠️ **Scope-/Security-Sprung**: macht MC zum Server-Admin-Panel. Rechte minimal halten (sudoers-Whitelist für genau die erlaubten Befehle, statt Vollzugriff).
|
||||
|
||||
### 2. Live-Terminal / Log via SSH (✅ Erledigt)
|
||||
- [x] Unter "Server" -> "Console" kann man das Journal verfolgen.
|
||||
- [x] Simpler "Log" Endpunkt in `maintenance.py` (`journalctl -u llama-swap -n 100 -f` über Websockets).
|
||||
- [x] UI: Schwarze Konsole, umschaltbar zwischen `llama-swap` und `mission-control`.
|
||||
- ⚠️ **Security-kritisch**: Authentifizierung via Token als Query-Parameter, da Browser keine Custom Websocket-Header senden können.
|
||||
|
||||
### 3. Live-Auslastung im Dashboard (✅ Erledigt)
|
||||
- [x] CPU / RAM / GPU-VRAM+GTT / Temperatur live anzeigen
|
||||
- [x] Quellen: **sysfs + psutil** — `amd-smi`/`rocm-smi` sind auf dem Bosgame NICHT installiert!
|
||||
GPU-Mem: `/sys/class/drm/card1/device/mem_info_*`; Temp: hwmon-`name` `amdgpu`/`k10temp`.
|
||||
|
||||
### 4. Cookbook + "Modell holen" verschmelzen (✅ Erledigt)
|
||||
- Bisher: Textfelder für HuggingFace-Repo + Pfad unter "Modelle". Das ist super für Custom-Zeug.
|
||||
- [x] Neu: Ein Klick-Cookbook (Sidebar-Tab "Cookbook") mit kuratierter Liste (z.B. Qwen2.5-Coder 32B, Llama3 Vision, etc.) inkl. Hardware-Aware "What Fits" Logik (wie bei Odysseus).
|
||||
- [x] Klick auf Modellkarte im Cookbook triggert den Download via `/api/download`.
|
||||
- [x] UI-Aufräumen: "Modell holen" Panel wandert ins Cookbook, unter "Modelle" bleibt nur die Tabelle & Chat.
|
||||
|
||||
### 5. Design 2.0
|
||||
- [x] **Grundgerüst + Design-Sprache in Schritt 1 umgesetzt** (Sidebar-Nav, Topbar, Hero, getönte
|
||||
KPI-Kacheln, Health-Signale, Listen, Aktivitäts-Stream, Alert-Banner) — Tokens in `css/base.css`.
|
||||
- [x] Feinschliff pro Feature durchgeführt.
|
||||
|
||||
### 6. Mehr LLM-Metriken (✅ Erledigt)
|
||||
- [x] Fähigkeiten pro Modell anzeigen (Text / Bild / Code)
|
||||
- [x] Tokens/Sek, Kontextgröße, Quant, Dateigröße auf Platte
|
||||
- [x] Status pro Modell: geladen / idle / Ladezeit
|
||||
|
||||
### 7. Integrations-Anleitungen (Copy-Paste) (✅ Erledigt)
|
||||
- [x] Unter "Guides" (neuer Tab links) gibt es Copy-Paste Templates.
|
||||
- [x] Templates für die Integration von llama-swap/mission-control in:
|
||||
- Cline / Cursor
|
||||
- N8N / Zapier
|
||||
- OpenWebUI
|
||||
- LangChain / Python Code
|
||||
|
||||
---
|
||||
|
||||
## Tech-Leitplanken
|
||||
|
||||
- **KISS beibehalten** — kein schweres Framework, solange es ohne geht.
|
||||
- **Sicherheit zuerst** bei allem mit Shell-/SSH-Zugriff: LAN-only, Auth, minimale Rechte.
|
||||
- Backend-Logik in `app.py`, UI in `static/index.html` — Trennung sauber halten.
|
||||
### Langfristig
|
||||
- [ ] Hermes-Persönlichkeit konfigurierbar (Name, Tonalität) über Gedächtnis `instruction`-Einträge
|
||||
- [ ] Voice-to-Voice latency optimieren (Whisper ROCm wenn stable)
|
||||
- [ ] Mehrsprachige TTS-Stimmen (EN + DE umschaltbar)
|
||||
- [ ] Hermes kann Mission Control selbst weiterentwickeln (Agentic self-improvement)
|
||||
|
||||
Reference in New Issue
Block a user