Add explicit HYPIR restoration profile

2026-09-07 22:52:59 +02:00
parent 2ae61baec7
commit 118e32005e
11 changed files with 593 additions and 32 deletions
@@ -0,0 +1,71 @@
+# GPU-Bildrestaurierung auf Athena
+
+Stand: 7. September 2026
+
+## Zweck
+
+Athena stellt zusätzlich zur kreativen FLUX-Bildgenerierung eine konservative
+Fotorestaurierung mit `HYPIR-SD2` bereit. HYPIR wird ausschließlich für
+Referenzbilder verwendet und soll Rauschen, Unschärfe und Kompressionsschäden
+reduzieren, ohne die Szene wie ein Text-zu-Bild-Modell vollständig neu zu
+erfinden.
+
+## Aufruf und Routing
+
+Der OpenAI-kompatible Endpunkt bleibt `/v1/images/edits`. Das gewünschte
+Backend wird über `model` gewählt:
+
+```json
+{
+  "model": "HYPIR-SD2",
+  "prompt": "Restauriere dieses Foto möglichst originalgetreu.",
+  "image_b64": "...",
+  "upscale": 1,
+  "patch_size": 512,
+  "stride": 256
+}
+```
+
+Hermes zeigt dafür das zusätzliche Chatmodell `restauration` neben
+`qwen-fast`, `qwen-medium`, `qwen-large` und `qwen-ultra`. Es verwendet
+`qwen-fast` als kurzes Anweisungsmodell und bindet das Bildwerkzeug fest an
+HYPIR. Die Formulierung des Prompts entscheidet nicht über das Backend.
+In jedem normalen Chatmodell bleiben Referenzbildänderungen bei FLUX.
+
+## Lebenszyklus
+
+1. Der Router merkt sich das aktive Qwen-Profil und wartet laufende Chats ab.
+2. Profile Controller stoppt Qwen und Qwen3-TTS.
+3. Der disposable `restoration-worker` lädt HYPIR auf der RTX 5080.
+4. Nach der Ausgabe wird der Worker beendet und sein CUDA-Kontext freigegeben.
+5. Qwen3-TTS und das zuvor aktive Qwen-Profil werden wiederhergestellt.
+
+FLUX- und HYPIR-Worker können durch dieselbe Docker-Label-Allowlist nie
+gleichzeitig mit einem Qwen-Profil laufen. Das Originalbild wird nicht
+überschrieben; Eingaben werden nur als temporäre Dateien im privaten
+`router-images`-Volume abgelegt und nach dem Auftrag entfernt.
+
+## Modelle und Lizenz
+
+- Code: `XPixelGroup/HYPIR`, Commit
+  `b61d107c6cef38f01a93c7833558869731cfa8c1`
+- Restaurationsgewicht: `lxq007/HYPIR/HYPIR_sd2.pth`
+- Basis: `LanguageMachines/stable-diffusion-2-1-base`, nur die benötigten
+  Diffusers-Komponenten
+- HYPIR ist ausschließlich für nichtkommerzielle Nutzung freigegeben.
+
+## Test
+
+Für die Produktionsprobe in Hermes zuerst `restauration` auswählen, dann ein
+Foto hochladen und beispielsweise `Mach das bitte schöner und schärfer`
+schreiben. Danach sind zu prüfen:
+
+```bash
+docker ps -a --filter name=mike-ai-restoration-worker \
+  --format '{{.Names}} {{.Status}}'
+nvidia-smi
+curl -fsS http://127.0.0.1:8081/status
+```
+
+Erwartet: Restaurations-Worker beendet, vorheriges Qwen-Profil und TTS gesund,
+Routerphase `idle`.