evOo-local/docs/kokoro-voice.md
cynarAI 6c7eed7580 Initial clean evOo-local from f00577b
Fresh history cut from cynarAI/evoo antigravity-handoff/project-timeline
(Voice First + project timeline). Brand docs/titles as evOo; keep @rakazo/*
packages as tech debt. Excludes node_modules, caches, secrets, voice blobs.
2026-09-20 17:15:16 +02:00

32 lines
1.0 KiB
Markdown

# 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`