91 lines
4.0 KiB
Markdown
91 lines
4.0 KiB
Markdown
# ACE-Step 1.5 XL SFT: isolierter Athena-Test
|
|
|
|
Der GPU-Worker startet nur im Musikmodus und bindet seine rohe
|
|
Gradio-Oberflaeche nur an localhost. Die separate `fspecii/ace-step-ui`
|
|
bleibt als leichte React/Express-Oberflaeche aktiv; ihre SQLite-Datenbank,
|
|
Bibliothek und Uploads liegen persistent unter `/data/music/ace-step-ui`.
|
|
|
|
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:
|
|
|
|
- 80 DiT-Schritte, Guidance 8, Shift 3, ODE/Euler und CFG-Intervall 0 bis 1
|
|
- reine Stilreferenzen werden entsprechend der ACE-Step-API-Empfehlung automatisch mit Stärke 0,2 übertragen; Cover-/Quellaudio behält seine eigene Stärke
|
|
- 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.
|
|
|
|
## Zwei Musikoberflaechen
|
|
|
|
Die originale Gradio-Oberflaeche aus demselben ACE-Step-Image ist der stabile
|
|
Produktionspfad fuer Simple, Custom, Cover, Remix und Repaint. Sie ist im
|
|
WireGuard-Netz unter `http://192.168.1.212:7862` erreichbar.
|
|
|
|
`music-ui` baut [fspecii/ace-step-ui](https://github.com/fspecii/ace-step-ui)
|
|
reproduzierbar von Commit `a1fdf91829ec6f7b98844f80e323529cd155dbf2`.
|
|
Die Community-Oberflaeche verwendet nicht mehr das positionsabhaengige
|
|
Gradio-Schema. Ihr Express-Dienst ruft die offizielle `/release_task`-API mit
|
|
benannten Feldern auf; das kleine Worker-Derivat erweitert diese Route um die
|
|
im installierten `GenerationParams` bereits vorhandenen Felder fuer Referenz-,
|
|
Quell- und Coveraudio sowie XL-SFT-Parameter. Athena-spezifisch sind ausserdem
|
|
die persistente Ablage, die XL-SFT-Anzeige und die gemeldeten Laufzeitlimits.
|
|
Schlaegt bei einer spaeteren Upstream-Fassung ein Patch-Anker fehl, bricht der
|
|
Image-Build ab. Die Community-UI unter `http://192.168.1.212:7861` ist bis zu
|
|
vollstaendigen Ende-zu-Ende-Tests von Cover und Remix als experimentell
|
|
gekennzeichnet.
|
|
|
|
Die Community-UI startet XL-SFT mit 80 Schritten, Guidance 8, Shift 3, FLAC
|
|
und aktivem Thinking ueber den 1,7B-Planer. `AI Enhance` wird als `use_format`
|
|
uebertragen. Vor jedem Auftrag zeigt sie die tatsaechlich gesendeten Parameter
|
|
und faengt offensichtliche Widersprueche ab. Referenzaudio steuert nur Klang
|
|
und Produktion; nur **Quellaudio / Cover** erhaelt Melodie, Rhythmus und
|
|
Akkorde.
|
|
|
|
## 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-..."
|
|
export ACESTEP_UI_JWT_SECRET="$(openssl rand -hex 32)"
|
|
docker compose up -d music-ui
|
|
docker compose --profile music-test up -d music-worker
|
|
docker compose logs -f music-worker
|
|
```
|
|
|
|
Alternativ zum WireGuard-Zugriff lassen sich beide Oberflaechen per SSH-Tunnel
|
|
erreichen:
|
|
|
|
```bash
|
|
ssh -L 7861:127.0.0.1:7861 -L 7862:127.0.0.1:7862 root@athena.scc.kit.edu
|
|
```
|
|
|
|
`ace-step-ui` spricht den Worker ausschliesslich ueber das interne Docker-Netz
|
|
an. Dafuer startet ACE-Step mit aktivierten, benannten API-Endpunkten
|
|
(`--enable-api`).
|
|
|
|
## Beenden
|
|
|
|
```bash
|
|
docker compose --profile music-test stop music-worker
|
|
```
|
|
|
|
Der Befehl stoppt nur den GPU-Worker. Die Musikoberflaeche, ihre Bibliothek,
|
|
Caches, Modellgewichte und Ausgaben bleiben erhalten.
|