Files
Athena-Deck/docs/NATIVE_APPLICATION_AUDIT.md

65 lines
5.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Athena-Anwendungen: native Laufzeiten und Docker
Geprüft am 28.09.2026: ausschließlich Container-Metadaten, Dockerfiles,
Compose-Buildpfade und gezielte Adapter-Quellstellen auf Athena. Keine Nutzerlogs,
Trainingsdaten, Stimmen, Prompts oder Medien gelesen. Keine Anwendung migriert.
Die folgende Einschätzung ist eine Quellcode-/Paketprüfung, kein nativer
Ende-zu-Ende-Test auf einem frischen Debian.
| Anwendung auf Athena | Native Ausführung | Besondere Anforderungen / Entscheidung |
|---|---|---|
| X-VC (`mike-ai-xvc-studio`) | Ja, Python-Umgebung samt eigener Gradio-GUI | Python, CUDA-PyTorch, FFmpeg, libsndfile. Bestehende Resemble-Enhance-Patches und abgestimmte NumPy/SciPy-Versionen übernehmen; eigene Umgebung. |
| OmniVoice / Voice Studio (`mike-ai-voice-studio`) | Ja, Python-Paket und `omnivoice-demo` | CUDA-PyTorch, torchaudio, omnivoice-triton, FFmpeg/libsndfile. Docker dient derzeit der Paketierung. |
| Applio/RVC, einschließlich Training (`mike-ai-applio-studio`) | Ja, eigene Python-Umgebung und `app.py` | Angepasste CUDA-12.8-PyTorch-Pakete, FFmpeg/PortAudio; persistente Stimmen- und Trainingsverzeichnisse. |
| Mikes-Applio-UI | Webserver ja; aktueller Worker-Adapter Docker-abhängig | FastAPI/Uvicorn plus statisches Frontend laufen nativ. `adapters/real_runner.py`, Realtime und Diagnostik verwenden derzeit `docker exec`. Für einen nativen Applio-Worker muss dieser Adapter ersetzt werden. |
| ACE-Step 1.5 | Ja, Python/uv, Gradio oder API | Der aktuelle Worker basiert auf dem Upstream-Image plus lokalem API-Routenpatch. Bei nativer Installation denselben Patch und die Version übernehmen. |
| ACE-Step Community UI | Ja, Node.js plus gebautes Frontend | Aktuell Node 22, React/Express und nginx. Native UI kann über HTTP auch einen Docker-Worker nutzen und umgekehrt. Lokale Kompatibilitätspatches beachten. |
| YuE2 + Community WebUI | Ja, Python-Paket/CLI und WebUI | YuE- und WebUI-Versionen sind getrennt gepinnt. SheetSage2 benötigt wegen Transformers/NumPy-Konflikten eine eigene Umgebung; keine gemeinsame globale Python-Installation. |
| Audio trennen (`mike-ai-stem-separator`) | Ja, Python/FastAPI | audio-separator, ONNX Runtime GPU, CUDA-PyTorch und FFmpeg; ClearVoice separat wegen NumPy-Konflikten. Kein eigenständiger Container namens „Audio Trainer“ gefunden; RVC-Training liegt bei Applio. |
| LTX-2 / LTX Desktop | Technisch auch nativ, aber deutlich aufwendiger als ein Webserver | Der konkrete Aufbau ist eine extrahierte AppImage plus Xvfb, Openbox, x11vnc, noVNC und Python-Backend. Für genau diese vollständige Desktop-GUI ist Docker als gekapselte Ausnahme sinnvoll. Ein nativer LTX-Worker mit Deck-GUI wäre eine andere Integration. |
## Konsequenz für Deck
Keine der geprüften Modelllaufzeiten ist grundsätzlich nur in Docker ausführbar.
Docker ist meistens das vorhandene Auslieferungsformat. Eine eigene GUI ist kein
Grund für eine Docker-Pflicht. Der konkrete Mikes-Applio-Adapter benötigt Docker,
bis er umgebaut wird; LTX Desktop ist eine sinnvolle optionale Container-Anwendung.
Native Komponenten erhalten jeweils eigene versionierte Python-/Node-Umgebungen,
Prozessverwaltung und persistente Datenpfade. Unterschiedliche Python-Versionen
(z. B. 3.12) müssen auch auf Debian 13 reproduzierbar bereitgestellt werden;
System-Python nicht überschreiben. UI, Worker und Betriebsart sind getrennte
Eigenschaften. Deck verwaltet GPU-Zugriffe gemeinsam über beide Betriebsarten.
Ein begrenzter Docker-Hilfsdienst darf nur registrierte Deck-Anwendungen steuern.
Der Webserver bekommt keinen freien Docker-Socket-/Rootzugriff.
Bestehende Anwendungen bleiben extern verwaltet, bis eine Übernahme ausdrücklich
beauftragt und je Anwendung getestet wurde. Native Rezepte sind noch nicht implementiert.
## Quellen
Die auf Athena vorhandenen Dockerfiles unter `/opt/mike-ai/xvc-studio`,
`omnivoice-studio`, `yue2-3b`, `stem-separator`, `acestep-test/worker`,
`acestep-test/ace-step-ui`, `Mikes-Applio-UI`, sowie
`stack/experiments/applio-rvc` und `stack/platform/ltx2-studio`.
Zusätzliche Upstream-Prüfung:
- [X-VC: native Conda-/Pip-Installation](https://github.com/Jerrister/X-VC/blob/main/README.md)
- [ACE-Step: Python/uv, Gradio und API](https://github.com/ace-step/ACE-Step-1.5/blob/main/docs/en/INSTALL.md)
- [Applio](https://github.com/IAHispano/Applio)
- [YuE2](https://github.com/multimodal-art-projection/YuE)
- [LTX Desktop](https://github.com/Lightricks/LTX-Desktop)
## In diesem Auftrag ausgeführte Änderungen
Der eindeutig der RTX 3060 zugeordnete Container `mike-ai-qwen3-tts` wurde
auf ausdrücklichen Nutzerauftrag regulär gestoppt. Die bisherige TTS-Ausgabe
ist damit vorerst nicht verfügbar. Keine Löschung, keine Änderung von
Restart-Policy, Treibern, WireGuard oder Hostkonfiguration.
Decks eigener Zwei-GPU-Bildtest: Qwen-Image-2.1 Q8_0, zugeordneter
INT8-Textencoder, 1024 × 1024, 25 Schritte, Seed 42. Zwei erfolgreiche
Durchläufe mit jeweils etwa 51 Sekunden. Synchron gemessene Spitzenwerte:
RTX 3060: 8065 MiB / 100 %, RTX 5080: 8842 MiB / 100 %. Nach dem Auftrag
wird der eigene Worker beendet. Testdaten liegen getrennt von Nutzeraufträgen.