# Athena-Betriebsmodi

Athena besitzt drei gegenseitig exklusive Betriebsmodi:

- `llm`: ein llama.cpp-Profil und Qwen3-TTS laufen; Spezialdienste sind gestoppt.
- `music`: ACE-Step 1.5 XL-SFT läuft; alle LLM-, Bild-, TTS- und Separator-Worker sind gestoppt.
- `separation`: wahlweise BS-RoFormer für Gesang/Instrumental oder Demucs für
  vier beziehungsweise sechs Spuren; LLM, Bild, TTS und ACE-Step sind gestoppt.

Die Zustandsmaschine lebt im Athena-Router. Das Dashboard und Chat-Clients wie
Hermes sind nur Bedienoberflächen derselben API. Der zuletzt aktive LLM-Modus
wird persistent gespeichert und beim Verlassen eines Spezialmodus wieder geladen.

## Bedienung

Im Athena-Dashboard stehen **LLM-Betrieb**, **Musikstudio** und
**Stimmen trennen** bereit. Im Musikmodus werden zwei Oberflächen angeboten:

- **Original UI · stabil** öffnet die zum laufenden ACE-Step-Image gehörende
  Gradio-Oberfläche. Sie ist für Cover, Remix und erweiterte Workflows der
  verbindliche Produktionspfad.
- **Community UI · experimentell** öffnet `fspecii/ace-step-ui`. Die
  CPU-leichte React/Express-Anwendung hält Bibliothek, Playlists und
  Einstellungen in `/data/music/ace-step-ui`. Ein noch nicht übernommener
  Upstream-Kompatibilitätsfix für die aktuelle 72-Felder-Gradio-API ist lokal
  zurückportiert; normale Generierung funktioniert, Cover und Remix gelten bis
  zu eigenen Ende-zu-Ende-Tests weiterhin als experimentell.

Die Community-Oberfläche ist im WireGuard-Netz unter
`http://192.168.1.212:7861`, die originale Gradio-Oberfläche unter
`http://192.168.1.212:7862` erreichbar. Beide Host-Ports bleiben zusätzlich
auf `127.0.0.1` gebunden und werden auf der Universitäts-Schnittstelle nicht
veröffentlicht. `ace-step-ui` ist reproduzierbar auf Commit
`a1fdf91829ec6f7b98844f80e323529cd155dbf2` fixiert und greift intern über das
Docker-Netz `mike-ai-music` auf `http://music-worker:7860` zu.

Im Trennmodus öffnet das Dashboard die private Athena-Oberfläche unter
`http://192.168.1.212:8007`. Sie nimmt WAV, FLAC, MP3, M4A und weitere
übliche Formate an und liefert verlustfreie FLAC-Spuren als ZIP. Verfügbar sind
die spezialisierte Gesangstrennung (`vocals`, `instrumental`), vier Spuren
(`vocals`, `drums`, `bass`, `other`) und experimentell sechs Spuren
(`vocals`, `drums`, `bass`, `guitar`, `piano`, `other`). Grundlage ist
`audio-separator` 0.47.0 mit BS-RoFormer Viperx 1297, `htdemucs_ft` und
`htdemucs_6s`.

Hermes benötigt dafür kein Plugin. Exakt eingegebene Steuerbefehle werden vom
Router lokal beantwortet, auch wenn gerade kein LLM geladen ist:

```text
/athena music
/athena stems
/athena llm
/athena status
```

Die HTTP-Schnittstelle verwendet authentifizierte Requests:

```text
GET  /mode
POST /mode  {"mode":"music"}
POST /mode  {"mode":"separation"}
POST /mode  {"mode":"llm"}
```

Der Wechsel läuft asynchron. Fortschritt und Fehler stehen unter `mode` in
`GET /status`. Der Profile-Controller akzeptiert ausschließlich den mit
`com.mike-ai.music-worker=acestep` beziehungsweise
`com.mike-ai.stem-separator=bs-roformer` markierten Container; freie
Container- oder Docker-Befehle werden nicht entgegengenommen.

## Wiederanlauf

Der Router speichert `mode`, `last_profile` und `return_profile` atomar. War
beim Router-Neustart ein Spezialmodus aktiv, startet er den passenden Worker erneut. Beim
Wechsel zurück wird das gespeicherte LLM-Profil semantisch auf Alias und
Kontextfenster geprüft, bevor Chat-Anfragen wieder freigegeben werden.