Instructions to use tinytrashlabs/supertonic-3-mlx with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use tinytrashlabs/supertonic-3-mlx with MLX:
# Download the model from the Hub pip install huggingface_hub[hf_xet] huggingface-cli download --local-dir supertonic-3-mlx tinytrashlabs/supertonic-3-mlx
- Supertonic
How to use tinytrashlabs/supertonic-3-mlx with Supertonic:
from supertonic import TTS tts = TTS(auto_download=True) style = tts.get_voice_style(voice_name="M1") text = "The train delay was announced at 4:45 PM on Wed, Apr 3, 2024 due to track maintenance." wav, duration = tts.synthesize(text, voice_style=style) tts.save_audio(wav, "output.wav")
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Atomic Chat
File size: 1,639 Bytes
f032c0f | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 | ---
license: openrail
pipeline_tag: text-to-speech
base_model: Supertone/supertonic-3
tags:
- text-to-speech
- tts
- mlx
- supertonic
---
# supertonic-3-mlx
Native-MLX conversion of [Supertone/supertonic-3](https://huggingface.co/Supertone/supertonic-3)
(99M-parameter flow-matching TTS, 44.1 kHz, 10 preset voices, 32 languages)
for use with `mlx-audio-swift`'s `SupertonicModel` (model_type `supertonic`).
## Contents
- `config.json` — model_type `supertonic`, sample_rate 44100, hop 512,
latent_dim 24, chunk_factor 6, cfg_scale 4.0, default_steps 8
- `duration_predictor.safetensors`, `text_encoder.safetensors`,
`vector_estimator.safetensors`, `vocoder.safetensors` — the four ONNX
sub-graphs' initializers, converted to MLX layout (Conv [O,I,K] → [O,K,I])
- `unicode_indexer.json` — 65,536-entry BMP codepoint → embedding-row table
- `voice_styles/{M1..M5,F1..F5}.json` — preset style vectors
(`style_ttl` [1,50,256], `style_dp` [1,8,16])
## Conversion pipeline
ONNX initializers were extracted with `onnx.numpy_helper`, Conv weights
transposed to MLX conv1d layout, keys renamed to stable dotted paths, and the
result validated stage-by-stage against ONNX Runtime at ≤1e-4 max-abs-error
(end-to-end ≤1e-3 on identical injected noise; ~69 dB SNR, perceptually
transparent). CFG and the Euler step baked into `vector_estimator.onnx` are
factored out and applied by the runtime.
## License
BigScience Open RAIL-M with use-based restrictions — see `LICENSE` and
`NOTICE`. These are format-converted (modified) files of the original
Supertone release; all credit for the model belongs to Supertone Inc.
|