supertone-inc / supertonic
- ΡΠ΅ΡΠ²Π΅ΡΠ³, 14 ΠΌΠ°Ρ 2026β―Π³. Π² 00:00:04
Lightning-Fast, On-Device, Multilingual TTS β running natively via ONNX.
Supertonic is a lightning-fast, on-device text-to-speech system designed for local inference with minimal overhead. Powered by ONNX Runtime, it runs entirely on your deviceβno cloud, no API calls, no privacy concerns.
release/supertonic-2 branch.supertonic PyPI package! Install via pip install supertonic. For details, visit supertonic-py documentationInstall the Python SDK and generate speech immediately. On the first run, Supertonic downloads the model assets from Hugging Face automatically.
pip install supertonicfrom supertonic import TTS
# First run downloads the model from Hugging Face automatically.
tts = TTS(auto_download=True)
style = tts.get_voice_style(voice_name="M1")
text = "A gentle breeze moved through the open window while everyone listened to the story."
wav, duration = tts.synthesize(text, voice_style=style, lang="en")
tts.save_audio(wav, "output.wav")
print(f"Generated {duration:.2f}s of audio")First, clone the repository:
git clone https://github.com/supertone-inc/supertonic.git
cd supertonicBefore running the examples, download the ONNX models and preset voices, and place them in the assets directory:
Note: The Hugging Face repository uses Git LFS. Please ensure Git LFS is installed and initialized before cloning or pulling large model files.
- macOS:
brew install git-lfs && git lfs install- Generic: see
https://git-lfs.comfor installers
git lfs install
git clone https://huggingface.co/Supertone/supertonic-3 assetsSome language examples need native runtimes:
brew install onnxruntime is enough; the Go example auto-detects Homebrew paths.brew install openjdk@17 works.Then run the Python example:
cd py
uv sync
uv run example_onnx.pyThis generates outputs/output.wav using the default preset voice.
Node.js Example (Details)
cd nodejs
npm install
npm startBrowser Example (Details)
cd web
npm install
npm run devJava Example (Details)
cd java
mvn clean install
mvn exec:javaC++ Example (Details)
cd cpp
mkdir build && cd build
cmake .. && cmake --build . --config Release
./example_onnxC# Example (Details)
cd csharp
dotnet restore
dotnet runGo Example (Details)
cd go
go mod download
go run example_onnx.go helper.goSwift Example (Details)
cd swift
swift build -c release
.build/release/example_onnxRust Example (Details)
cd rust
cargo build --release
./target/release/example_onnxiOS Example (Details)
cd ios/ExampleiOSApp
xcodegen generate
open ExampleiOSApp.xcodeprojIn Xcode: Targets β ExampleiOSApp β Signing: select your Team, then choose your iPhone as run destination and build.
Supertonic 3 is designed for practical on-device inference: compact enough to run locally, while staying competitive with much larger open TTS systems.
Across measured languages, Supertonic 3 stays within a competitive WER/CER range against much larger open TTS models such as VoxCPM2, while preserving a lightweight on-device deployment path. Asterisked languages use CER; the others use WER.
Compared with Supertonic 2, Supertonic 3 reduces repeat and skip failures, improves speaker similarity across the shared-language set, and expands language coverage from 5 to 31 languages. It keeps the v2-compatible public ONNX interface, so existing integrations can move to v3 with the same inference contract.
Supertonic 3 runs fast on CPU, even compared with larger baselines measured on A100 GPU, and uses substantially less memory. The open-weight fixed-voice setting does not require a GPU, which makes local, browser, and edge deployment much easier.
At about 99M parameters across the public ONNX assets, Supertonic 3 is much smaller than 0.7B to 2B class open TTS systems. The smaller model size is a practical advantage for download size, startup time, and on-device inference.
Try it now: Experience Supertonic in your browser with our Interactive Demo, or get started with pre-trained models from Hugging Face Hub
Watch Supertonic running on a Raspberry Pi, demonstrating on-device, real-time text-to-speech synthesis:
Experience Supertonic on an Onyx Boox Go 6 e-reader in airplane mode, achieving an average RTF of 0.3Γ with zero network dependency:
Turns any webpage into audio in under one second, delivering lightning-fast, on-device text-to-speech with zero network dependencyβfree, private, and effortless:
<laugh>, <breath>, and <sigh>Supertonic 3 supports 31 languages:
| Code | Language | Code | Language | Code | Language | Code | Language |
|---|---|---|---|---|---|---|---|
en |
English | ko |
Korean | ja |
Japanese | ar |
Arabic |
bg |
Bulgarian | cs |
Czech | da |
Danish | de |
German |
el |
Greek | es |
Spanish | et |
Estonian | fi |
Finnish |
fr |
French | hi |
Hindi | hr |
Croatian | hu |
Hungarian |
id |
Indonesian | it |
Italian | lt |
Lithuanian | lv |
Latvian |
nl |
Dutch | pl |
Polish | pt |
Portuguese | ro |
Romanian |
ru |
Russian | sk |
Slovak | sl |
Slovenian | sv |
Swedish |
tr |
Turkish | uk |
Ukrainian | vi |
Vietnamese |
We provide ready-to-use TTS inference examples across multiple ecosystems:
| Language/Platform | Path | Description |
|---|---|---|
| Python | py/ |
ONNX Runtime inference |
| Node.js | nodejs/ |
Server-side JavaScript |
| Browser | web/ |
WebGPU/WASM inference |
| Java | java/ |
Cross-platform JVM |
| C++ | cpp/ |
High-performance C++ |
| C# | csharp/ |
.NET ecosystem |
| Go | go/ |
Go implementation |
| Swift | swift/ |
macOS applications |
| iOS | ios/ |
Native iOS apps |
| Rust | rust/ |
Memory-safe systems |
| Flutter | flutter/ |
Cross-platform apps |
For detailed usage instructions, please refer to the README.md in each language directory.
Supertonic is designed to handle complex, real-world text inputs that contain natural prose, punctuation, abbreviations, and proper nouns.
π§ View audio samples more easily: Check out our Interactive Demo for a better viewing experience of all audio examples
Overview of Test Cases:
| Category | Key Challenges | Supertonic | ElevenLabs | OpenAI | Gemini | Microsoft |
|---|---|---|---|---|---|---|
| Financial Expression | Decimal currency, abbreviated magnitudes (M, K), currency symbols, currency codes | β | β | β | β | β |
| Phone Number | Area codes, hyphens, extensions (ext.) | β | β | β | β | β |
| Technical Unit | Decimal numbers with units, abbreviated technical notations | β | β | β | β | β |
Text:
"The startup secured $5.2M in venture capital, a huge leap from their initial $450K seed round."
Challenges:
Audio Samples:
| System | Result | Audio Sample |
|---|---|---|
| Supertonic | β | π§ Play Audio |
| ElevenLabs Flash v2.5 | β | π§ Play Audio |
| OpenAI TTS-1 | β | π§ Play Audio |
| Gemini 2.5 Flash TTS | β | π§ Play Audio |
| VibeVoice Realtime 0.5B | β | π§ Play Audio |
Text:
"You can reach the hotel front desk at (212) 555-0142 ext. 402 anytime."
Challenges:
Audio Samples:
| System | Result | Audio Sample |
|---|---|---|
| Supertonic | β | π§ Play Audio |
| ElevenLabs Flash v2.5 | β | π§ Play Audio |
| OpenAI TTS-1 | β | π§ Play Audio |
| Gemini 2.5 Flash TTS | β | π§ Play Audio |
| VibeVoice Realtime 0.5B | β | π§ Play Audio |
Text:
"Our drone battery lasts 2.3h when flying at 30kph with full camera payload."
Challenges:
Audio Samples:
| System | Result | Audio Sample |
|---|---|---|
| Supertonic | β | π§ Play Audio |
| ElevenLabs Flash v2.5 | β | π§ Play Audio |
| OpenAI TTS-1 | β | π§ Play Audio |
| Gemini 2.5 Flash TTS | β | π§ Play Audio |
| VibeVoice Realtime 0.5B | β | π§ Play Audio |
Note: These samples demonstrate how each system handles text normalization and pronunciation of complex expressions without requiring pre-processing or phonetic annotations.
| Project | Description | Links |
|---|---|---|
| TLDRL | Free, on-device TTS extension for reading any webpage | Chrome |
| Read Aloud | Open-source TTS browser extension | Chrome Β· Edge Β· GitHub |
| PageEcho | E-Book reader app for iOS | App Store |
| VoiceChat | On-device voice-to-voice LLM chatbot in the browser | Demo Β· GitHub |
| OmniAvatar | Talking avatar video generator from photo + speech | Demo |
| CopiloTTS | Kotlin Multiplatform TTS SDK via ONNX Runtime | GitHub |
| Voice Mixer | PyQt5 tool for mixing and modifying voice styles | GitHub |
| Supertonic MNN | Lightweight library based on MNN (fp32/fp16/int8) | GitHub Β· PyPI |
| Transformers.js | Hugging Face's JS library with Supertonic support | GitHub PR Β· Demo |
| Pinokio | 1-click localhost cloud for Mac, Windows, and Linux | Pinokio Β· GitHub |
The following papers describe the core technologies used in Supertonic. If you use this system in your research or find these techniques useful, please consider citing the relevant papers:
This paper introduces the overall architecture of SupertonicTTS, including the speech autoencoder, flow-matching based text-to-latent module, and efficient design choices.
@article{kim2025supertonic,
title={SupertonicTTS: Towards Highly Efficient and Streamlined Text-to-Speech System},
author={Kim, Hyeongju and Yang, Jinhyeok and Yu, Yechan and Ji, Seunghun and Morton, Jacob and Bous, Frederik and Byun, Joon and Lee, Juheon},
journal={arXiv preprint arXiv:2503.23108},
year={2025},
url={https://arxiv.org/abs/2503.23108}
}This paper presents Length-Aware Rotary Position Embedding (LARoPE), which improves text-speech alignment in cross-attention mechanisms.
@article{kim2025larope,
title={Length-Aware Rotary Position Embedding for Text-Speech Alignment},
author={Kim, Hyeongju and Lee, Juheon and Yang, Jinhyeok and Morton, Jacob},
journal={arXiv preprint arXiv:2509.11084},
year={2025},
url={https://arxiv.org/abs/2509.11084}
}This paper describes the self-purification technique for training flow matching models robustly with noisy or unreliable labels.
@article{kim2025spfm,
title={Training Flow Matching Models with Reliable Labels via Self-Purification},
author={Kim, Hyeongju and Yu, Yechan and Yi, June Young and Lee, Juheon},
journal={arXiv preprint arXiv:2509.19091},
year={2025},
url={https://arxiv.org/abs/2509.19091}
}This project's sample code is released under the MIT License. - see the LICENSE for details.
The accompanying model is released under the OpenRAIL-M License. - see the LICENSE file for details.
This model was trained using PyTorch, which is licensed under the BSD 3-Clause License but is not redistributed with this project. - see the LICENSE for details.
Copyright (c) 2026 Supertone Inc.