This release is a pre-release and may not be stable for production use.
phoonnx
Multilingual phonemization and Text-to-Speech using ONNX models. phoonnx loads
and runs TTS voices from several ecosystems (native phoonnx, Piper, Mimic3, Coqui, MMS,
Transformers) through one onnxruntime-based interface, and ships a training pipeline for
building your own voices.
It reaches 1000+ languages and voices across the bundled voice indexes. See the full list in VOICES.md.
30-second quickstart
pip install phoonnx
Download a voice and synthesize a WAV from the command line:
# populate the local voice catalog, then fetch one voice
phoonnx-voices update-cache
phoonnx-voices download OpenVoiceOS/phoonnx_pt-PT_miro_tugaphone
The same thing from Python:
import wave
from phoonnx.voice import TTSVoice
voice = TTSVoice.load("model.onnx", "model.json")
with wave.open("hello.wav", "wb") as wav_file:
voice.synthesize_wav("Hello world!", wav_file)
New here? Start with the Quickstart — it downloads a voice and speaks a sentence end-to-end.
Train your own voice in an afternoon
Record (or obtain) a single-speaker dataset, preprocess it, train a VITS model on one GPU,
export to ONNX, and load it back — all with the bundled phoonnx_train toolkit. Follow the
golden path in docs/training/quickstart.md.
Features
| Capability | Where |
|---|---|
| Run ONNX voices on CPU or GPU (CUDA/ROCm/DirectML/CoreML/OpenVINO) | Usage · Configuration |
| ~40 phonemizer backends across many languages | Phonemizers |
| Load Piper / Mimic3 / Coqui / Transformers / MMS voices | Architecture |
| 14 synthesis engines behind one adapter registry | Engines |
| Zero-shot voice cloning (YourTTS, StyleTTS2, ZipVoice, F5-TTS, Chatterbox) | Cloning |
| Low-latency streaming for VITS voices | Streaming |
| Optional 48 kHz audio super-resolution over synthesized audio | OVOS plugin |
| Download and cache voices from HuggingFace and other sources | Voice manager |
| Train and fine-tune new voices | Training |
| Drop-in OpenVoiceOS TTS plugin | OVOS plugin |
Documentation
The docs are organized around three reader paths — see the documentation index:
- Use a voice — Installation → Quickstart → Usage
- Train a voice — Training quickstart → Datasets → Export
- Understand the internals — Architecture → Phonemizers → Engines
OpenVoiceOS plugin
phoonnx ships the ovos-tts-plugin-phoonnx TTS plugin. Configure it in mycroft.conf:
"tts": {
"module": "ovos-tts-plugin-phoonnx",
"ovos-tts-plugin-phoonnx": {
"voice": "OpenVoiceOS/phoonnx_pt-PT_miro_tugaphone"
}
}
Full options in docs/ovos_plugin.md.
Docker / TTS server
docker compose up
See docs/docker.md. For running it as a public or long-lived service, see docs/deployment.md.
Related projects
phoonnx is part of the OpenVoiceOS ecosystem:
- ovos-core — the voice assistant that loads this plugin
- ovos-plugin-manager — the plugin framework
ovos-tts-plugin-phoonnxregisters against - ovos-tts-server — a standalone HTTP server for any OVOS TTS plugin, including this one
License and credits
phoonnx is licensed under Apache-2.0. Copyright Casimiro Ferreira.
It builds on the work of others, including jaywalnut310/vits (the VITS backbone), and interoperates with the Piper, Mimic3, Coqui, MMS and Transformers voice formats. Language-specific components are credited on the Phonemizers page.
The SuperTonic inference code (phoonnx/engines/supertonic.py) is adapted from Supertone
Inc.'s MIT-licensed reference implementation. SuperTonic model weights
(Supertone/supertonic-3) are licensed OpenRAIL-M, not Apache-2.0 — review the model's
license before commercial use.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file phoonnx-1.91.1a1.tar.gz.
File metadata
- Download URL: phoonnx-1.91.1a1.tar.gz
- Upload date:
- Size: 9.7 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
46b9551cf1dcad449da2d3d4d08daa58beae7a4b7c3afed4ba19581e551f3419
|
|
| MD5 |
3200856366bfda2e18b332807cba101b
|
|
| BLAKE2b-256 |
fd7e09edffc32f53fff4663c419960f013dd4da2804bc7c20750f1288519ac2d
|
File details
Details for the file phoonnx-1.91.1a1-py3-none-any.whl.
File metadata
- Download URL: phoonnx-1.91.1a1-py3-none-any.whl
- Upload date:
- Size: 10.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e812c8cfc58c22c4d3e938a326c79d5f815ff677dff407c85dba0a826dde3dbf
|
|
| MD5 |
5a1a072e3bdefd14889bf3f1f8e0daa9
|
|
| BLAKE2b-256 |
330450f17544c247b89eef1765d7c59321c1259b05afd3bd6bc3b289cc9d412d
|
