kikiri-tts-german-wyoming

kikiri-tts-german-wyoming

Docker app from Marco T's Repository

Overview

Lokaler deutscher Text-to-Speech-Server für Home Assistant auf Basis von Kikiri/Kokoro mit Wyoming-Unterstützung. Funktionen: • Deutsche Text-to-Speech-Ausgabe • Wyoming-Protokoll für Home Assistant • Stimmen Martin und Victoria • Automatischer Download fehlender Sprachmodelle • Persistente Speicherung der Modelle außerhalb des Containers • Unterstützung zusätzlicher Stimmen • Einstellbare CPU-Thread-Anzahl • OpenAI-kompatible TTS-API Fehlende Modelle werden beim Start automatisch heruntergeladen. Die Modelle werden persistent unter /app/models gespeichert und bleiben bei Container-Updates erhalten. Weitere Informationen und die Anleitung zum Hinzufügen zusätzlicher Stimmen befinden sich in der README auf GitHub.

Kikiri TTS German + Wyoming

Kikiri TTS

Lokaler deutscher Text-to-Speech-Server auf Basis von Kikiri/Kokoro mit Wyoming-Unterstützung für Home Assistant.

Funktionen

  • Deutsche TTS-Ausgabe
  • Wyoming-Protokoll für Home Assistant
  • OpenAI-kompatible TTS-API
  • Stimmen Martin und Victoria
  • Automatischer Download fehlender Sprachmodelle
  • Modelle werden außerhalb des Docker-Images gespeichert
  • Zusätzliche Stimmen können über Variablen ergänzt werden
  • Für CPU-Betrieb geeignet, unter anderem Intel N100
  • Nicht-streamende Wyoming-TTS-Ausgabe

Ports

Port Funktion
10203 Wyoming TTS
8881 Interner TTS-Server

Für Home Assistant wird normalerweise nur Port 10203 benötigt.

Modelle

Die Modelle sind absichtlich nicht Bestandteil dieses Git-Repositories.

Beim Start prüft download_models.py, ob die benötigten Modelle vorhanden sind. Fehlende Modelle werden automatisch von Hugging Face heruntergeladen.

Standardmäßig stehen folgende Stimmen zur Verfügung:

  • martin
  • victoria

Die Modelle befinden sich im Container unter /app/models.

Für eine dauerhafte Speicherung sollte /app/models als Volume eingebunden werden.

Unraid-Beispiel:

/mnt/user/appdata/kikiri-tts-german-wyoming/models -> /app/models

Umgebungsvariablen

Standardwerte:

KOKORO_THREADS=4
KOKORO_PRELOAD=martin,victoria
KOKORO_VOICES=martin,victoria
KOKORO_EXTRA_VOICES=
WYOMING_TTS_CONCURRENT_REQUESTS=1

Docker Build

docker build -t kikiri-tts-german-wyoming:latest .

Docker Start

docker run -d \
  --name kikiri-tts-german-wyoming \
  --restart unless-stopped \
  -p 10203:10203 \
  -v /mnt/user/appdata/kikiri-tts-german-wyoming/models:/app/models \
  -e KOKORO_THREADS=4 \
  -e KOKORO_PRELOAD=martin,victoria \
  -e KOKORO_VOICES=martin,victoria \
  kikiri-tts-german-wyoming:latest

Home Assistant

Den Container über die Wyoming-Integration hinzufügen.

Host: IP-Adresse des Unraid-Servers
Port: 10203

Anschließend sollten die verfügbaren TTS-Stimmen über Wyoming erkannt werden.

Projektstruktur

.
├── Dockerfile
├── README.md
├── download_models.py
├── german_text_rules.py
├── server.py
├── start.sh
├── icons/
│   └── kikiri-tts.png
├── kokoro/
├── training/
└── wyoming_patch/

Hinweis

Dieses Projekt verwendet Komponenten aus Kikiri/Kokoro sowie weiteren Open-Source-Projekten. Die jeweiligen Lizenzen und Bedingungen der verwendeten Modelle und Abhängigkeiten sind zu beachten.

Credits & Upstream-Projekte

Kikiri TTS German + Wyoming ist ein unabhängiges Community-Projekt und baut auf mehreren Open-Source-Projekten auf.

Besonderer Dank gilt:

Die jeweiligen Komponenten, Modelle und Sprachressourcen unterliegen den Lizenz- und Copyright-Bedingungen ihrer jeweiligen Upstream-Projekte.

Kikiri TTS German + Wyoming ist ein unabhängiges Community-Projekt und ist nicht mit Kikiri, Kokoro, Home Assistant oder Unraid verbunden oder von diesen offiziell unterstützt.

Install kikiri-tts-german-wyoming on Unraid in a few clicks.

Find kikiri-tts-german-wyoming in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for kikiri-tts-german-wyoming Review the template variables and paths Click Install

Requirements

Unraid with Docker support. Network access is required for the initial download of voice models.

Related apps

Explore more like this

Explore all

Details

Repository
ghcr.io/marco-taylor/kikiri-tts-german-wyoming:latest
Last Updated2026-09-28
First Seen2026-09-28

Runtime arguments

Network
bridge
Shell
sh
Privileged
false

Template configuration

Wyoming-PortPorttcp

Wyoming-Protokoll-Port für Home Assistant

Target
10203
Default
10203
Value
10203
Kikiri-ModellePathrw

Persistenter Speicher für heruntergeladene Kikiri-Sprachmodelle

Target
/app/models
Default
/mnt/user/appdata/kikiri-tts-german-wyoming/models
Value
/mnt/user/appdata/kikiri-tts-german-wyoming/models
CPU-ThreadsVariable

Anzahl der von Kokoro verwendeten CPU-Threads

Target
KOKORO_THREADS
Default
4
Value
4
Installierte StimmenVariable

Verfügbare Stimmen. Fehlende Modelle werden automatisch heruntergeladen.

Target
KOKORO_VOICES
Default
martin,victoria
Value
martin,victoria
Vorgeladene StimmenVariable

Stimmen, die beim Start des TTS-Servers direkt in den Speicher geladen werden

Target
KOKORO_PRELOAD
Default
martin,victoria
Value
martin,victoria
Zusätzliche StimmenVariable

Zusätzliche Stimmdefinitionen im Format name|repository|model|voice. Mehrere Stimmen werden durch Semikolon getrennt.

Target
KOKORO_EXTRA_VOICES
Gleichzeitige TTS-AnfragenVariable

Maximale Anzahl gleichzeitig verarbeiteter Wyoming-TTS-Anfragen

Target
WYOMING_TTS_CONCURRENT_REQUESTS
Default
1
Value
1
OpenMP-ThreadsVariable

Anzahl der OpenMP-CPU-Threads

Target
OMP_NUM_THREADS
Default
4
Value
4
MKL-ThreadsVariable

Anzahl der MKL-CPU-Threads

Target
MKL_NUM_THREADS
Default
4
Value
4
OpenBLAS-ThreadsVariable

Anzahl der OpenBLAS-CPU-Threads

Target
OPENBLAS_NUM_THREADS
Default
4
Value
4
NumExpr-ThreadsVariable

Anzahl der NumExpr-CPU-Threads

Target
NUMEXPR_NUM_THREADS
Default
4
Value
4