# Barby-Studio Session-Doku: Fehler, Learnings, Architektur (2026-07-21)

## A) Fehler + Learnings heute (2026-07-21)

### 45-Sekunden-Regel strukturell gelöst
Barby-PseudoWatcher (Scheduled Task, läuft jede Minute) fängt Pseudo-/Fehl-Ergebnisse ab
(leer/stumm/<720px/Job-Error) und schreibt nur ins Log — **kein Matrix-Spam**. Der
Matrix-Watcher postet ausschließlich aus `B:\_approved` (Master-Gate). Damit kommen keine
kaputten Zwischenstände mehr im Matrix-Raum an, nur geprüfte Endergebnisse.

### Multi-Agenten + Multi-Modell-Orchestrierung
Master delegiert, Modell wird pro Aufgabe gewählt:
- **Opus** — Studio-Content-Jobs (Bild/Video/Lip-Sync/TTS/3D)
- **Sonnet** — Infra/Code/Diagnose
- **Haiku** — reine Lookups

**Master-Gate:** Der Master prüft Screenshots/Videos/Frames SELBST, bevor etwas als „fertig"
gemeldet wird — nicht auf Worker-Behauptungen verlassen.

### Barby-Studio-Fehler heute (Root-Cause + Fix je Punkt)
1. **Model-Aliase → HTTP 400.** Aliase zeigten auf nicht-existente Checkpoints.
   Fix: Aliase auf echte, tatsächlich vorhandene M:-Modelle gemappt.
2. **Galerie verlor Bilder.** Las flüchtige ComfyUI-`/history`-Einträge (werden von ComfyUI
   selbst rotiert/geleert) statt den Dateien. Fix: dateibasiertes Listing (liest aus dem
   Output-Verzeichnis, nicht aus der API-History).
3. **Cartoon-Look statt Fotoreal.** Ursache: ponyRealism/Pony-Checkpoint kombiniert mit zu
   wenig Foto-Prompt-Anteil. Fix: Fotoreal-Checkpoint + RAW-Photo-Rezept + Anti-Cartoon-
   Negatives + CFG ~4.5 + IPAdapter gegen einen Foto-Master-Referenzbild.
4. **Video-Cartoon-Look.** Ursache: Wav2Lip lief nur mit 96px-Auflösung intern. Fix: neue
   Pipeline Wan2.2 (720p) → MuseTalk → GFPGAN → Real-ESRGAN → Ton-Mux, Ergebnis verifiziert
   in HD 1440×2560.
5. **GPU-Anzeige zeigte „VM aus", obwohl VM302 lief.** Portal fragte die tote VMID 200 ab
   statt der echten VMID 302, zusätzlich ein Encoding-Crash im Status-Handler. Fix: Portal
   auf VMID 302 umgestellt + Encoding-Fehler behoben.
6. **NPM zeigte „0 Hosts".** Portal hatte ein falsches, hartkodiertes NPM-Passwort hinterlegt.
   Korrektes Login: `matthias@consoro.eu` / `ymALqp!?`. Fix im Portal-Code hinterlegt.
7. **Externer :8502-Studio-Button entfernt.** Studio-Zugriff läuft jetzt ausschließlich
   inline im Chat, kein separater externer Port/Button mehr.
8. **Wan-Modell lud über Netzwerk (Z:/R:-Freigaben) statt lokal → langsamer Kaltstart.**
   Fix: alle KI-Modelle konsequent nach `M:\` (echtes lokales Laufwerk auf VM302) verschoben —
   deckt sich mit der bestehenden Golden Rule „Modelle nur lokal auf M:, nie Netzwerkshares".
9. **cloud_fallback-Pfad geprüft und bestätigt sicher deaktiviert.** Video-Generierung läuft
   ausschließlich lokal (Wan2.2/A40) — keine Cloud-Video-Fallbacks (Mammouth sora/veo/kling,
   fal, Runway), deckt sich mit der Golden Rule „Video nur lokal".

### Inhalts-Grenze (bewusst eingehalten)
Entkleiden/Face-Swap-Nudify wurde **nicht gebaut** — das bleibt Bärs eigener Bereich.
Gebaut wurde ausschließlich SFW: text2img, barby-Charakter-Generierung, Galerie, Video.

## B) Barby-Studio-Architektur (Stand 2026-07-21)

| Komponente | Ort | Details |
|---|---|---|
| UI / Portal-Endpoints | VM201 | `/opt/gpu1-status/app.py`, öffentlich über `cp.go-ki.eu` (NPM-Proxy, intern `10.10.10.5`) |
| Orchestrator | VM302 | `B:\barby\orchestrator\main.py`, Port `:8197` |
| ComfyUI-Engine + Custom-Node-Stacks | VM302 | `M:\ComfyUI`, Port `:8188`, 21 Custom-Nodes, alle Checkpoints/Modelle auf `M:\` |
| Wav2Lip | VM302 | Port `:8193`, on-demand gestartet |
| Proxy-Kette | VM201 → VM302 | `/api/studio/*` auf VM201 wird zu VM302 durchgereicht, inkl. URL-Rewrite |

**Video-Pipeline (aktuell):** Wan2.2 (720p Bewegungs-Generierung) → MuseTalk (Lip-Sync) →
GFPGAN (Gesichtsrestaurierung) → Real-ESRGAN (Hochskalierung) → Ton-Mux. Verifiziertes
Endergebnis: HD 1440×2560, mit Ton.

## C) Zusatz-Check: Rezepte docs.consoro.it (ANLEITUNG.md) vs. Realität

Geprüft via `curl -H "X-API-Key: ..." https://docs.consoro.it/anleitung.md` (13.070 Zeilen,
Stand 21.07.2026 20:01 CEST):
- **Kein „Virginia bleibt"-Verweis gefunden** — nicht (mehr) vorhanden, kein Korrekturbedarf.
- **Keine veralteten Modell-Pfade `R:\`/`Z:\` für VM302 gefunden.** Zeile 12196 dokumentiert
  bereits korrekt: „Modelle → `M:\`, App-Configs → `D:\<app>\`, `C:\` nur System/Programme."
  Die einzigen noch vorhandenen `D:\ComfyUI`-Pfade beziehen sich auf einen ANDEREN Host
  (GPU-Shadow `100.87.122.111`, REZEPT A2/C2) — das ist korrekt so, keine Verwechslung mit VM302.
- Neuer Eintrag **REZEPT AE1** (dieses Dokument, gekürzt) wurde ergänzt: Barby-Studio-
  Fehler+Fixes 2026-07-21 + Architektur-Übersicht, plus Index-Zeile im Funktions-Index.

### PWA-Bridges (Suno & Co.) — Zielzustand-Korrektur
Die Annahme „ein anderer Agent migriert Suno gerade nach nas2" ist laut aktueller Quelle
**nicht (mehr) zutreffend**: Sowohl `docs.consoro.it` (REZEPT AD1) als auch das frische
Obsidian-Dokument `PWA-Bridges-Umzug-go2ki-2026-07-21.md` (21.07., 12:30) beschreiben den
tatsächlichen Zielzustand: `keys-bridges` (Playwright-Container für Qolaba/Gemini/Mammouth/
Nimbus + Suno-CDP) wurde vom Hub auf **go2ki.eu** (Tailscale `100.125.242.12`) umgezogen,
**nicht auf nas2**. Suno läuft dort weiterhin per CDP-Tunnel zu `gpu-pc` (100.109.177.88),
Login-Status zum Zeitpunkt der Migration: `logged_in:true`. Offene Punkte laut dieser Quelle:
Mammouth flappt gelegentlich zu `/login` (Workaround: einmal per noVNC neu einloggen),
`/gemini/image` liefert noch `timeout` (DOM-Bild-Erkennung nicht fertig), Suno-Captcha bei
jeder Generierung (Folgeschritt: Umstieg auf Container-Playwright-Bridge mit Residential-Proxy
statt CDP prüfen). Diese Doku überschreibt NICHT die Arbeit des migrierenden Agenten — sie
referenziert nur dessen bereits verifizierten Endstand.