https://github.com/thewh1teagle/kokoro-onnx
TTS with kokoro and onnx runtime
https://github.com/thewh1teagle/kokoro-onnx
kokoro onnxruntime python tts
Last synced: 29 days ago
JSON representation
TTS with kokoro and onnx runtime
- Host: GitHub
- URL: https://github.com/thewh1teagle/kokoro-onnx
- Owner: thewh1teagle
- License: mit
- Created: 2025-01-03T14:59:41.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-09-01T20:26:36.000Z (3 months ago)
- Last Synced: 2026-10-14T17:16:55.845Z (about 1 month ago)
- Topics: kokoro, onnxruntime, python, tts
- Language: Python
- Homepage: https://pypi.org/project/kokoro-onnx
- Size: 438 KB
- Stars: 2,783
- Watchers: 18
- Forks: 304
- Open Issues: 81
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- voiceai - Kokoro 82M (kokoro-onnx) - licensed Kokoro model that tops community ELO arenas; runs on CPU (the upstream weights have not changed since 2025). (🗣️ 4. Text-to-speech (TTS) / Open source)
README
# kokoro-onnx

[](https://pypi.org/project/kokoro-onnx/)
[](https://github.com/thewh1teagle/kokoro-onnx/releases)
[](https://github.com/thewh1teagle/kokoro-onnx/blob/main/LICENSE)
[](https://github.com/thewh1teagle/kokoro-onnx/stargazers)
[](https://pypi.org/project/kokoro-onnx/)
[](https://github.com/microsoft/onnxruntime)


TTS with onnx runtime based on [Kokoro-TTS](https://huggingface.co/spaces/hexgrad/Kokoro-TTS)
🚀 Version 1.0 models are out now! 🎉
## Features
- Supports multiple languages
- Fast performance near real-time on macOS M1
- Offer multiple voices
- Lightweight: ~300MB (quantized: ~80MB)
## Setup
```console
pip install -U kokoro-onnx
```
Instructions
1. Install [uv](https://docs.astral.sh/uv/getting-started/installation) for isolated Python (Recommend).
```console
pip install uv
```
2. Create new project folder (you name it)
3. Run in the project folder
```console
uv init -p 3.12
uv add kokoro-onnx soundfile
```
4. Paste the contents of [`examples/save.py`](https://github.com/thewh1teagle/kokoro-onnx/blob/main/examples/save.py) in `hello.py`
5. Download the files [`kokoro-v1.0.onnx`](https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.1/kokoro-v1.0.onnx), and [`voices-v1.0.bin`](https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.1/voices-v1.0.bin) and place them in the same directory.
6. Run
```console
uv run hello.py
```
You can edit the text in `hello.py`
That's it! `audio.wav` should be created.
## Examples
See [examples](examples)
## Voices
See the latest voices and languages in [Kokoro-82M/VOICES.md](https://huggingface.co/hexgrad/Kokoro-82M/blob/main/VOICES.md)
Note: It's recommend to use misaki g2p package from v1.0, see [examples](examples)
## Contribute
See [CONTRIBUTE.md](CONTRIBUTE.md)
## License
- kokoro-onnx: MIT
- kokoro model: Apache 2.0