Add dual ACE-Step music studio interfaces

experiments/acestep15-xl-sft/README.md

@@ -1,9 +1,9 @@
 # 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`.
+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`
@@ -30,6 +30,23 @@ 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`.
+Ein lokaler Backport des noch offenen Upstream-PR
+[#109](https://github.com/fspecii/ace-step-ui/pull/109) gleicht das Frontend an
+das aktuelle 72-Felder-Gradio-Schema an. Athena-spezifisch sind nur 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.
+
 ## Start
 
 Vor dem Start muessen das aktive llama.cpp-Profil und Qwen3-TTS beendet sein.
@@ -37,24 +54,28 @@ 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
 ```
 
-Die lokale Oberflaeche kann vom Mac aus ueber einen SSH-Tunnel erreicht werden:
+Alternativ zum WireGuard-Zugriff lassen sich beide Oberflaechen per SSH-Tunnel
+erreichen:
 
 ```bash
-ssh -L 7861:127.0.0.1:7861 root@athena.scc.kit.edu
+ssh -L 7861:127.0.0.1:7861 -L 7862:127.0.0.1:7862 root@athena.scc.kit.edu
 ```
 
-Danach im Browser `http://127.0.0.1:7861` aufrufen.
+`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 down
+docker compose --profile music-test stop music-worker
 ```
 
-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.
+Der Befehl stoppt nur den GPU-Worker. Die Musikoberflaeche, ihre Bibliothek,
+Caches, Modellgewichte und Ausgaben bleiben erhalten.