# LadyPoly YuE2 für Athena Deck

Die gepinnte LadyPoly-WebUI (Commit 3960afc309efcef5f4f570209cf01160b96b1ea3)
läuft separat ohne Torch, CUDA, Modellmounts oder Docker-Socket. Die schmale
Anbindung nutzt Decks authentifizierte Musik-API auf 127.0.0.1:8120.
Deck steuert audio.cpp, Gewichte und den exklusiven Musikmodus.

Auf Debian mit vorhandenem Docker, im Athena-Deck-Repository:

```sh
docker build -t athena-ladypoly:3960afc-deck1 deploy/ladypoly
sudo python3 deploy/ladypoly/install.py
```

Container: `athena-ladypoly`. Frei zu prüfender Port: **8127**, nur Host-Loopback.
Host-Netzwerk verbindet zur lokalen Deck-API; keine öffentliche Portfreigabe.
Labels: `io.athena-deck.managed=true`, `io.athena-deck.role=application`,
`io.athena-deck.application=ladypoly`. Diese machen ihn unter Weitere Dienste sichtbar.
Volume: `/opt/athena-ladypoly/data:/data:rw`, UID/GID 65534, Verzeichnis 0700.
Enthält Verbindungsdaten/Token (0600), UI-Einstellungen und generierte Musik.
Keine Modelle oder Runtime im Container. Image wird aus diesem Rezept gebaut;
noch kein öffentliches Registry-Image/Pull-Befehl verfügbar.

```sh
ssh -i ~/.ssh/athena_key -o BatchMode=yes -o ExitOnForwardFailure=yes -N -L 8127:127.0.0.1:8127 root@192.168.1.212
```

Dann http://127.0.0.1:8127/deck-connection öffnen. Eigenen Deck-API-Token und
exakten freigegebenen YuE2-Profilnamen eingeben. Die Verbindung wird gegen die
Musik-Modellliste geprüft. Bei Tokenwechsel hier erneut speichern.
In Deck auf Musik umschalten, anschließend in LadyPoly Stil und Liedtext
angeben und generieren. Deck-Endpunkt muss gestartet sein.

Unterstützt: Titel/Bibliothek, Liedtext, Stil, Seed, WAV-Erzeugung über Deck,
FLAC-Bibliothek und Wiedergabe. Derzeit Direct-Modus, bis 9000 semantische Tokens
und sechs Syntheseschritte. Kein Versprechen einer bestimmten Songdauer.
Writer, Cover-Erzeugung, Score, LoRA und Sampling-Overrides sind nicht angebunden;
die betreffenden Bedienelemente sind ausgeblendet/gesperrt. Abbruch eines laufenden
GPU-Jobs erfolgt in Deck; die WebUI ist kein zweiter Prozessmanager.

```sh
docker stop athena-ladypoly
docker start athena-ladypoly
```

Der Deck-Backuphelfer kennt das gepinnte Build-Rezept und sichert die beiden
Konfigurationsdateien im verschlüsselten Backup. Ergebnisse unter outputs sind
Nutzdaten und werden nicht exportiert. Beim Restore wird das Image wieder gebaut;
der Port muss frei sein. Deck-API-Portänderungen erfordern derzeit eine Anpassung
von `BASE` in bridge.py und einen Image-Neubau.

Upstream-Lizenz und Hinweise verbleiben unter /app im Image.