diff --git a/docs/CURRENT_RUNTIME_NOTES.md b/docs/CURRENT_RUNTIME_NOTES.md index 123a7fa..1df6cb1 100644 --- a/docs/CURRENT_RUNTIME_NOTES.md +++ b/docs/CURRENT_RUNTIME_NOTES.md @@ -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 diff --git a/docs/IMAGE_RESTORATION.md b/docs/IMAGE_RESTORATION.md new file mode 100644 index 0000000..052669b --- /dev/null +++ b/docs/IMAGE_RESTORATION.md @@ -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. diff --git a/integrations/hermes-athena-image/README.md b/integrations/hermes-athena-image/README.md index 3016375..4d03e32 100644 --- a/integrations/hermes-athena-image/README.md +++ b/integrations/hermes-athena-image/README.md @@ -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: