Kokoro-FastAPI-zh

Kokoro-FastAPI-zh

Docker-Anwendung from hsiang's Repository

Übersicht

OpenAI-compatible TTS API based on Kokoro-82M-v1.1-zh. Default uses CPU image. For GPU: change Repository to ghcr.io/hsiang-han/kokoro-fastapi-zh-gpu:latest, set USE_GPU=true, and add Extra Parameters: --gpus=all --runtime=nvidia (do not set as default on CPU hosts).

Laufzeit-Argumente

Web-UI
http://[IP]:[PORT:8880]/web
Netzwerk
bridge
Shell
bash
Privilegiert
false

Konfiguration der Vorlage

WebUI PortPorttcp

Web/API exposed port

Ziel
8880
Standard
8880
Wert
8880
Models PathPathrw

Host path for model files

Ziel
/app/api/src/models
Standard
/mnt/user/appdata/kokoro-fastapi-zh/models
Wert
/mnt/user/appdata/kokoro-fastapi-zh/models
Voices PathPathrw

Host path for voice .pt files

Ziel
/app/api/src/voices
Standard
/mnt/user/appdata/kokoro-fastapi-zh/voices
Wert
/mnt/user/appdata/kokoro-fastapi-zh/voices
Python PathVariable

Python import path

Ziel
PYTHONPATH
Standard
/app:/app/api
Wert
/app:/app/api
Python UnbufferedVariable

Enable unbuffered Python logs

Ziel
PYTHONUNBUFFERED
Standard
1
Wert
1
Repo IDVariable

HuggingFace model repo

Ziel
REPO_ID
Standard
hexgrad/Kokoro-82M-v1.1-zh
Wert
hexgrad/Kokoro-82M-v1.1-zh
Default VoiceVariable

Default voice name

Ziel
DEFAULT_VOICE
Standard
zf_001
Wert
zf_094
Default Voice CodeVariable

Optional language code override. Set z to force zh pipeline.

Ziel
DEFAULT_VOICE_CODE
Standard
z
Wert
z
Model FileVariable

Model path relative to /app/api/src/models

Ziel
KOKORO_V1_FILE
Standard
v1_1_zh/kokoro-v1_1-zh.pth
Wert
v1_1_zh/kokoro-v1_1-zh.pth
Voices DirVariable

Voice directory in container

Ziel
VOICES_DIR
Standard
/app/api/src/voices/v1_1_zh
Wert
/app/api/src/voices/v1_1_zh
API Log LevelVariable

API logging level

Ziel
API_LOG_LEVEL
Standard
DEBUG
Wert
DEBUG
Use GPUVariable

CPU default=false. For NVIDIA GPU set true and switch Repository to *-gpu image.

Ziel
USE_GPU
Standard
false
Wert
false
NVIDIA Visible DevicesVariable

Only needed for GPU mode

Ziel
NVIDIA_VISIBLE_DEVICES
Standard
all
Wert
all
NVIDIA Driver CapsVariable

Only needed for GPU mode

Ziel
NVIDIA_DRIVER_CAPABILITIES
Standard
compute,utility
Wert
compute,utility

Einzelheiten

Repository
ghcr.io/hsiang-han/kokoro-fastapi-zh-cpu:latest
Zuletzt aktualisiert2026-06-02
Erstmals gesehen2026-03-11

Führen Sie Kokoro-FastAPI-zh auf Unraid aus.

Kokoro-FastAPI-zh ist gelistet in Community Apps für Unraid OS. Erkunden Sie Unraid, um einen flexiblen Heimserver, ein NAS oder ein Heimlabor aufzubauen.