# Kokoro (Cloud-Audio)

> Kokoro in der Cloud: ein offenes Sprachmodell für amerikanisches Englisch mit 20 Stimmen, sparsam mit deinem Kontingent, für Platzhalter- und Entwurfsdialoge im Spiel. Verbraucht dein Kontingent; dasselbe Modell läuft auch lokal.

- Id: `aigd.cloud-kokoro`
- Quelle: Offiziell (First-Party `aigd.*`)
- Kategorie: Audio
- Herausgeber: AI Game Dev (`aigd`), verifiziert
- Neueste Version: 0.1.3 (veröffentlicht am 2026-11-22)
- Lizenz: SEE LICENSE IN README.md
- Erfordert die AI Game Dev App: `>=0.25.11`
- Nativer Code: nein
- Bewertung: noch nicht bewertet
- HTML-Seite: https://ai-game.dev/de/packages/aigd.cloud-kokoro

## Installieren

Mit der gamedev CLI im Projektordner:

```bash
gamedev pkg add aigd.cloud-kokoro
```

In der Desktop-App: Öffne das Fenster Packages (das Paket-Symbol in der Statusleiste), wähle **Browse**, suche nach `aigd.cloud-kokoro` und klicke auf **Add to Project**. Mehr: https://ai-game.dev/docs/wiki/app/packages

## Versionen

| Version | Veröffentlicht | Erfordert App | Hinweise |
|---|---|---|---|
| 0.1.3 | 2026-11-22 | `>=0.25.11` | neueste |
| 0.1.2 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.1 | 2026-11-01 | `>=0.25.11` | - |

## Beschreibung

````markdown
# Kokoro — Cloud-Audio (`aigd.cloud-kokoro`)

hexgrads offenes Kokoro-Sprachmodell in der Cloud, ausgeführt vom AI Game Dev Agent: eine offene Stimme, die sparsam mit deinem Kontingent umgeht, für Platzhalter- und Entwurfsdialoge. Es liest Text in amerikanischem Englisch in einer von 20 Stimmen vor, bis zu 5000 Zeichen pro Anfrage. Passend, um einen Prototyp, einen Vertical Slice oder einen Skript-Probedurchlauf vor der finalen Vertonung zu vertonen. Verbraucht dein AI Game Dev Plan-Kontingent; dasselbe Modell läuft auch lokal mit dem [Kokoro-82M-Paket](https://ai-game.dev/packages/aigd.tts-kokoro).

## Was du tun kannst

- Sprich jede Zeile eines Prototyps ein, damit Playtester den Dialog hören.
- Lies ein Skript laut vor, um Tempo und Länge zu prüfen, bevor du aufnimmst oder finale Stimmen erstellst.
- Gib jedem NPC eine eigene Stimme aus 20 Stimmen für amerikanisches Englisch.
- Erstelle temporäre Tutorial-Narration und Sprachansagen für die UI.

## Beispielanfragen

- "Sprich alle Tutorial-Zeilen in `Docs/tutorial-script.md` mit Kokoro ein, Stimme af_heart."
- "Lies diese Wächter-Barks mit Kokoro vor, Stimme am_onyx."
- "Erstelle Entwurfsdialoge für die drei Dorfbewohner mit unterschiedlichen Kokoro-Stimmen."

## Varianten

| Variante | Name | Erzeugt | Grenzen | Schätzeinheit |
|---|---|---|---|---|
| `kokoro-american-english` | Amerikanisches Englisch | Sprache | 20 Stimmen, bis zu 5000 Zeichen | pro 1000 Zeichen |

Stimmen: af_heart (Standard), af_alloy, af_aoede, af_bella, af_jessica, af_kore, af_nicole, af_nova, af_river, af_sarah, af_sky, am_adam, am_echo, am_eric, am_fenrir, am_liam, am_michael, am_onyx, am_puck, am_santa. Die Stimmen `af_` sind weibliche Stimmen für amerikanisches Englisch, die Stimmen `am_` männliche Stimmen für amerikanisches Englisch. Ein Seed wird nicht verwendet.

Kokoro liegt in der niedrigsten Nutzungsstufe der Cloud-Sprachmodelle; für finalen Dialog bietet [ElevenLabs](https://ai-game.dev/packages/aigd.cloud-elevenlabs) Stufen mit höherer Qualität. Wenn du Zeilen stattdessen auf deinem eigenen Rechner sprechen lassen willst, nutze das lokale Paket [Kokoro 82M](https://ai-game.dev/packages/aigd.tts-kokoro), das keines deines Kontingents verbraucht.

## So funktioniert es

Läuft über [Cloud-Generierung](https://ai-game.dev/packages/aigd.cloud-media) (`aigd.cloud-media`, standardmäßig in jedem Chat aktiv): Der Agent wählt dieses Modell, wenn es zur Aufgabe passt oder wenn du es nennst. Aufträge innerhalb des Generierungsbudgets des Chats laufen ohne Rückfragen (*Vor jeder Operation fragen* fragt bei jedem einzelnen nach). Schätzungen sind ein Prozentsatz deines Kontingents, und ein fehlgeschlagener Auftrag zählt nicht gegen dein Kontingent. Ob dein Plan es nutzen kann, ergibt sich aus deinem Konto (der Tab Models, `audio_list_models`); eine Variante, die dein Plan nicht nutzen kann, wird gesperrt angezeigt. Die Datei wird als MP3 oder WAV in deinem Projekt gespeichert und überschreibt niemals eine vorhandene Datei.

Server-ID (`package_id` von `/api/media`, ihre Medienmodell-ID): `aigd.cloud.kokoro`.

Die Varianten, Modi und Grenzen stammen aus dem Katalog des Servers (`aigd.cloud.kokoro` in capabilities v2; `packages/core/test/cloud-media-manifests.test.ts` hält dieses Paket damit deckungsgleich). Der Server führt eine Variante erst aus, wenn ihre Provider-Route und ihre Kontingentnutzung verifiziert sind; eine geplante Variante wird als "Demnächst verfügbar" aufgeführt.

## Lizenz

Modell: Apache-2.0 (offene Gewichte). Das erzeugte Audio darfst du gemäß den Bedingungen des Anbieters für die jeweilige Variante nutzen. Dieses Paket ist reine Daten (kein Code), Apache-2.0.
````
