Built: 2026-10-11T04:20:13Z
Beginner installation guide

Install KokoroTTS

Answer six short questions. We will turn your choices into one exact path and explain every step in plain language.

Stable v1.0 or rolling latest
Choose rolling latest for current updates, or stable v1.0 locked to its published SHA-256 digest for a repeatable install.

Tell us about this computer

Your answers stay in this browser. Nothing is submitted or stored on our server.

Operating system
Computer hardware
Download size
Release track
Image source
Who should be able to open it?

Install Docker

Download Docker Desktop from the official guide, run the installer with the recommended WSL 2 option, then open Docker and wait for the engine to start: Docker Desktop for Windows ↗.

Open the command window

Select the Windows Search button on the taskbar, type PowerShell, and open Windows PowerShell: .

Paste this first check and press Enter:

Check Docker
docker version

You should see both Client and Server sections. If Server is missing, open Docker and wait for it to finish starting.

Create a safe place for settings and downloaded files

Docker calls this a volume. It keeps important application files when you replace or update the container.

Create persistent storage
docker volume create kokorotts_data

Download and start KokoroTTS

Copy the complete one-line command, paste it into the same window, and press Enter. The first download can be large, so leave the window open.

Generated command
docker run -d --name kokorotts --restart unless-stopped -p 127.0.0.1:7860:7860 --gpus all -v kokorotts_data:/app/persistent hangrylabs/kokorotts:latest

Open KokoroTTS

Wait until the application reports that it is ready, then select this button:

Open KokoroTTS at localhost:7860 ↗

Open Generate, type a sentence, choose a voice, and select Generate. Use Stream for cancellable synthesis, API for integration status, and System for model-pack and GPU controls.

If the page does not open yet, give the first startup another minute and try again.

Useful commands for later

Open PowerShell or Terminal again whenever you need one of these.

Stop
docker stop kokorotts
Start again
docker start kokorotts
Watch startup messages
docker logs -f kokorotts
What did the choices change?

The full image includes model assets and is the easiest offline-friendly choice after the first pull. The tiny image downloads models during first use. Docker Hub and GHCR are official sources; 1ms is an optional third-party mirror. Local-only binds to 127.0.0.1; home-network access publishes the port on every interface and belongs only on a trusted private network.