selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

kokoro-web logo

Self-host kokoro-web

v0.1.3

Open-source AI text-to-speech with OpenAI-compatible API

BetaOpen SourceMIT
Updatedlast year
LanguageTypescript
Setup difficultyEasy
ThemeDark mode
Stars
760
Port
3000 (Web UI and OpenAI-compatible API)
Docker
ghcr.io/eduardolat/kokoro-web
Install with Docker Compose
Kokoro Web demo showing the web UI for text-to-speech generation

What is kokoro-web?

Kokoro Web is a free, open-source AI text-to-speech tool that runs in the browser or self-hosted via Docker. It uses the Kokoro-82M model from Hugging Face to produce natural voices across English (US/UK), Japanese, Chinese, Spanish, Hindi, Italian, and Portuguese (Brazil). The self-hosted edition exposes an OpenAI-compatible endpoint at /api/v1, letting existing apps swap in this service without code changes. The web interface offers dozens of voice profiles, speed adjustment, synthetic pause tags, WebGPU acceleration, and multiple model quantization levels. Optional API key authentication is controlled by an environment variable. The project is MIT licensed and maintained by Eduardo Lat.

Should you self-host kokoro-web?

kokoro-web scores 47/100 on selfhost.directory (how scoring works) and ranks #8 of 9 in Text to Speech. It has 760 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is OmniVoice-Studio (94/100, 92 781 stars). It scores higher overall, so compare the two before you pick. See kokoro-web vs OmniVoice-Studio side by side.

Features

  • Browser-Based UI
  • Model quantization options
  • Multiple Language Support
  • Multiple voice options
  • OpenAI Compatible API
  • Optional API key authentication
  • Profile Management
  • Speed Control
  • Synthetic pauses
  • Text-to-speech generation
  • Theme System
  • WebGPU acceleration

kokoro-web README

How to install kokoro-web

Install kokoro-web with Docker Compose

Environment variables
KW_SECRET_API_KEY, KW_PUBLIC_NO_TRACK

services: kokoro-web: image: ghcr.io/eduardolat/kokoro-web:latest ports: - "3000:3000" environment: - KW_SECRET_API_KEY=your-api-key volumes: - ./kokoro-cache:/kokoro/cache # Cache downloaded models and voices restart: unless-stopped

Adjust compose.yaml according to needs or use docker run directly

How to configure kokoro-web

  • KW_PUBLIC_NO_TRACKOpt out of anonymous usage analytics

    Opt out of anonymous usage analytics

  • KW_SECRET_API_KEYAPI key for authentication. If left blank, authentication will not be activated

    API key for authentication. If left blank, authentication will not be activated

kokoro-web releases & version history

More in Text to Speech

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…