# Athena-Betriebsmodi

Athena besitzt zwei gegenseitig exklusive Betriebsmodi:

- `llm`: ein llama.cpp-Profil und Qwen3-TTS laufen; ACE-Step ist gestoppt.
- `music`: ACE-Step 1.5 XL-SFT läuft; alle LLM-, Bild- und TTS-Worker 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 des Musikmodus wieder geladen.

## Bedienung

Im Athena-Dashboard stehen die Schaltflächen **LLM-Betrieb** und
**Musikstudio** bereit. Nach dem Start des Musikmodus öffnet **Studio öffnen**
die über den SSH-Tunnel bereitgestellte ACE-Step-Oberfläche.

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 llm
/athena status
```

Die HTTP-Schnittstelle verwendet authentifizierte Requests:

```text
GET  /mode
POST /mode  {"mode":"music"}
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` 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 der Musikmodus aktiv, startet er ACE-Step erneut. Beim
Wechsel zurück wird das gespeicherte LLM-Profil semantisch auf Alias und
Kontextfenster geprüft, bevor Chat-Anfragen wieder freigegeben werden.