# ACE-Step 1.5 XL SFT: isolierter Athena-Test

Dieser Compose-Dienst ist absichtlich noch nicht Teil des produktiven Stacks.
Er startet nicht automatisch, bindet die Testoberflaeche nur an localhost und
kann mitsamt seinem Container entfernt werden, ohne Router oder Hermes zu
veraendern. Gewichte und Ergebnisse liegen getrennt unter `/data`.

Das offizielle Image ist auf den am 8. September 2026 geladenen Digest
`sha256:95652cd780c78a1b1a7f6f0335530430f0ae53d96c7c12d59f9f39fa23d38567`
fixiert.

## Persistente Qualitaetsvorgaben

Die Weboberflaeche besitzt keine einzelne INI-Datei. Ihre Vorgaben kommen aus
Python-Modulen und teilweise aus dem Browser-`localStorage`. Deshalb bindet der
Compose-Dienst vier kleine, versionierte Overrides aus `./overrides` read-only
in den Container ein. Sie setzen fuer das XL-SFT-Modell:

- 50 DiT-Schritte, Guidance 7, ODE/Euler und CFG-Intervall 0 bis 1 (Upstream-Defaults)
- Shift 1 statt des fehlerhaften UI-Werts 3
- ADG aus, keine benutzerdefinierten Timesteps
- FLAC als verlustfreie Standardausgabe
- 320 kbit/s als MP3-Ausweichwert
- Batchgroesse 1 fuer einen einzelnen Qualitaetslauf
- Normalisierung an bei -1 dB, kein Fade, Latent Shift 0, Latent Rescale 1

Die Preference-Schema-Version wurde auf 2 angehoben. Alte, im Browser
gespeicherte MP3/128-kbit/s-Werte werden dadurch einmalig verworfen; danach
bleiben bewusst vorgenommene Aenderungen wieder im jeweiligen Browser erhalten.
Beim Wechsel des gepinnten Image-Digests muessen die Overrides gegen die neue
Upstream-Fassung geprueft werden.

## Start

Vor dem Start muessen das aktive llama.cpp-Profil und Qwen3-TTS beendet sein.
Die RTX 5080 wird ueber ihre UUID exklusiv an den Container uebergeben.

```bash
export ACESTEP_GPU_UUID="GPU-..."
docker compose --profile music-test up -d music-worker
docker compose logs -f music-worker
```

Die lokale Oberflaeche kann vom Mac aus ueber einen SSH-Tunnel erreicht werden:

```bash
ssh -L 7861:127.0.0.1:7861 root@athena.scc.kit.edu
```

Danach im Browser `http://127.0.0.1:7861` aufrufen.

## Beenden

```bash
docker compose --profile music-test down
```

Der Befehl entfernt nur den Testcontainer und das Testnetz. Caches,
Modellgewichte und Ausgaben bleiben fuer reproduzierbare Messungen erhalten.
Sie werden erst nach dokumentierter Ablehnung gezielt geloescht.