Files
AI-Profile-Router/docs/IMAGE_RESTORATION.md
T

2.4 KiB

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:

{
  "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:

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.