Document removal of photo restoration experiment

2026-09-08 10:56:30 +02:00
parent e82e0340e4
commit 5746ac0e2c
3 changed files with 69 additions and 1 deletions
@@ -1,6 +1,19 @@
 # Aktueller produktiver Laufzustand

-Stand: 7. September 2026
+Stand: 8. September 2026
+
+## Fotorestaurierung verworfen
+
+Der versuchsweise HYPIR-SD2-Restaurationspfad wurde vollständig aus Router,
+Compose und Hermes entfernt. HYPIR glättete beziehungsweise erfand beim realen
+Testfoto Details; ein isolierter SeedVR2-7B-FP8-Test bewahrte das Motiv besser,
+lieferte bei der starken Bewegungsunschärfe aber keinen ausreichenden
+Qualitätsgewinn. Athena veröffentlicht deshalb kein Modell `restauration` und
+Hermes besitzt keinen entsprechenden Skill mehr.
+
+FLUX.2 Klein 9B bleibt für Bildgenerierung und kreative Referenzbild-Edits
+aktiv. Details und Abnahmekriterien stehen in
+[IMAGE_RESTORATION.md](IMAGE_RESTORATION.md).

 ## FLUX.2 Klein 9B FP8 Beta

@@ -0,0 +1,49 @@
+# Bewertung lokaler Fotorestaurierung
+
+Stand: 8. September 2026
+
+## Entscheidung
+
+Athena betreibt derzeit **keinen separaten Fotorestaurationspfad**. Das
+virtuelle Hermes-/Router-Modell `restauration`, der HYPIR-Worker und der dafür
+angelegte Hermes-Skill wurden nach Ende-zu-Ende-Tests wieder entfernt.
+
+Die normale Bildgenerierung und kreative Referenzbildbearbeitung mit
+`FLUX.2-klein-9B-fp8-beta` bleiben davon unberührt. Sie sind jedoch kein Ersatz
+für eine originalgetreue Restaurierung beschädigter oder stark unscharfer
+Fotos.
+
+## Getestete Ansätze
+
+### HYPIR-SD2
+
+HYPIR lief technisch als eigener Worker und war über den Athena-Router sowie
+Hermes aufrufbar. Beim realen Testfoto wurden jedoch Strukturen geglättet oder
+neu gezeichnet, statt vorhandene Details zuverlässig wiederherzustellen. Die
+Identität und Geometrie kleiner Bildbereiche konnten driften. Das Ergebnis
+erfüllte damit die Anforderung „gleiches Foto, nur sauberer und schärfer“
+nicht.
+
+### SeedVR2 7B FP8
+
+SeedVR2 wurde isoliert auf Athena getestet, ohne es in Hermes oder den
+produktiven Router einzubauen. Der Lauf bei 2048 × 1536 Pixeln war technisch
+erfolgreich und bewahrte Komposition und Identität besser als HYPIR. Bei stark
+verrauschtem und bewegungsunscharfem Ausgangsmaterial stellte das Modell aber
+keine wesentlich brauchbareren Details her; Unschärfe und Rauschen blieben zu
+großen Teilen bestehen.
+
+## Konsequenz für die Architektur
+
+- kein `restauration`-Modell in `/v1/models`
+- kein Restaurationszweig im Profile Router
+- kein `restoration-worker` in Docker Compose
+- keine HYPIR- oder SeedVR2-Gewichte auf Athena
+- kein `image-restoration`-Skill und kein Restaurationsmodell in Hermes
+- Referenzbilder gehen weiterhin ausschließlich an FLUX und gelten als
+  kreative Bildbearbeitung
+
+Ein neuer Restaurationspfad soll erst wieder aufgenommen werden, wenn ein
+Kandidat am realen Testfoto einen klaren Qualitätsgewinn zeigt, Identität und
+Geometrie zuverlässig bewahrt und auf Athenas RTX 5080/RTX 3060-Konfiguration
+reproduzierbar läuft. Ein bloß technisch erfolgreicher Lauf reicht nicht.
@@ -7,6 +7,12 @@ unloads the active LLM and Qwen3-TTS, and restores both after generation.
 Reference-image requests use FLUX for creative edits. No second Hermes
 provider or desktop installation is required.

+There is deliberately no photo-restoration model or restoration skill in this
+provider. The former HYPIR experiment was removed after it redrew and smoothed
+details instead of preserving the source faithfully. See
+[`docs/IMAGE_RESTORATION.md`](../../docs/IMAGE_RESTORATION.md) for the recorded
+decision and the isolated SeedVR2 comparison.
+
 ## Gateway installation

 Install this directory on the Hermes gateway, not on each Desktop client: