# Kokoro (lokale Stimme)

Kokoro ist der kostenfreie Standard für Voice First: **Kokoro-82M** (Apache 2.0) läuft lokal über [Kokoro-FastAPI](https://github.com/remsky/Kokoro-FastAPI) — keine ElevenLabs/OpenAI/Cartesia-Keys nötig.

## Schnellstart

```bash
docker run -p 8880:8880 ghcr.io/remsky/kokoro-fastapi-cpu:latest
```

Optional auf dem EvOo-Server (wenn Kokoro woanders läuft):

```bash
export KOKORO_BASE_URL=http://127.0.0.1:8880
```

## In EvOo verbinden

1. **Voice** in den Einstellungen öffnen.
2. **Kokoro** wählen (erster Eintrag).
3. **Connect local Kokoro** — prüft `GET /v1/audio/voices`, speichert einen Platzhalter-Token (`local-kokoro`), kein API-Key.
4. Stimme wählen (z. B. `af_heart`) und **Hear a sample** testen.
5. Voice First / CallView nutzt dann `POST /v1/audio/speech` (OpenAI-kompatibel, `stream: false`).

## Fehler

| Meldung | Ursache |
|---------|---------|
| *Kokoro lokal nicht erreichbar…* | Kokoro-FastAPI läuft nicht oder `KOKORO_BASE_URL` stimmt nicht. |

API-Dokumentation nach Start: `http://127.0.0.1:8880/docs`