{"kind":"guides","slug":"supertonic-3-voices","path":"/guides/supertonic-3-voices","title":"Supertonic 3 Voices and How to Use Them | SuperClonica","description":"What a Supertonic 3 voice file is, where to get custom voices (free and paid), and how to use one offline with Supertonic, the SuperClonica engine or Docker.","h1":"Supertonic 3 voices: where to get custom voices and how to use them","intro":"Supertonic 3 is a small open text-to-speech model that runs on an ordinary computer. It comes with ten preset voices, and every other voice for it is a single small file that you add yourself. Once you have that file, speech in any of the model's 31 languages is generated offline, on your own CPU or GPU.\n\nThis guide explains what a Supertonic 3 voice is, where custom voices come from now that the original Supertonic project is archived, and how to use a voice with the official code, with the SuperClonica engine and with Docker. SuperClonica sells and trains such voices, so we say where something is ours.","sections":[{"heading":"What a Supertonic 3 voice is","paragraphs":["A Supertonic 3 voice is a voice style: a JSON file of about 0.3 MB that holds two small sets of numbers. One shapes the timbre and manner of speech, the other the timing. The model itself, about 385 MB of ONNX files, is the same for every voice and is downloaded once.","Because the voice is separate from the model, switching voices costs nothing: the same installation speaks with any voice file you pass to it. A voice also works in every language the model supports, from English, Spanish and German to Russian, Japanese, Korean, Arabic and Hindi. It sounds most natural in the language of the recording it was made from. Chinese is not among the 31 languages."]},{"heading":"Where to get Supertonic 3 voices","paragraphs":["The ten preset voices, M1 to M5 and F1 to F5, come with the model. For anything else there are a few sources."],"points":["Free voices on GitHub: the superclonica/supertonic-voices repository has free voice files with audio samples in nine languages.","The SuperClonica catalog: 170+ voices, including game and cartoon characters, narrators, male, female and child voices. Every voice page has demos and lets you voice your own short phrase online for free; free voices download without an account, and paid ones are bought once.","A voice made to order: on the commissions page you describe the voice and attach a recording, and an author trains it for you.","Your own voice: SuperClonica trains a voice from a short clean recording for free on your own NVIDIA GPU, with our worker program.","Voice Builder, Supertone's former service for custom voices, is not part of the archived project, so new voices can no longer be made there."]},{"heading":"Use a voice with the official Supertonic code","paragraphs":["The archived Supertonic repository still works. Clone it, create a Python 3.11 virtual environment, install huggingface_hub and download the model into the assets folder with hf download supertone-oss-archive/supertonic-3 --local-dir assets (the project's quick start pins the exact revision). Then install the packages from py/requirements.txt.","To speak with a custom voice, run the example script from the py folder and pass the voice file: python example_onnx.py --voice-style ./voice.json --text \"Your text here\" --lang en --n-test 1. The WAV file appears in the results folder. For another language, change --lang, for example to de or ja."]},{"heading":"Use a voice with the SuperClonica engine","paragraphs":["SuperClonica is our engine built on Supertonic 3. It reads the same voice files without conversion, is on average 61% faster on a CPU and 73% faster on a graphics card in our measurements, removes the model's hiss between words and speaks numbers as words.","Install one package: python -m pip install superclonica-cpu, or superclonica-gpu-cuda for an NVIDIA GPU. In Python, create the engine once and call tts.synthesize(\"Hello!\", voice=\"voice.json\", lang=\"en\", seed=7), then tts.save(\"hello.wav\", audio). From the command line: superclonica --text \"Hello!\" --voice voice.json --lang en --output hello.wav. The base model downloads on the first run."]},{"heading":"Use a voice in Docker","paragraphs":["The superclonica/superclonica image on Docker Hub runs the engine as an HTTP server: docker run -d -p 8000:8000 -v superclonica-models:/models superclonica/superclonica:cpu, or the cuda tag with --gpus all on an NVIDIA GPU.","A request to POST /synthesize carries the text, the language and the voice: the content of the voice JSON goes into the request itself. Since a voice is about 0.3 MB, build the request in a file and send it with curl -d @request.json. The answer is a 16-bit WAV."]},{"heading":"Tips for good results","paragraphs":["A few habits make a voice sound its best."],"points":["Pass the language of the text, not of the voice: a Russian voice reads English text with lang=en.","Fix a seed when you like a take: the same text, voice and seed give the same audio again.","Write numbers, dates and abbreviations the way they should sound if you use the official code; the SuperClonica engine spells numbers out by itself.","Split long texts into paragraphs. The SuperClonica engine does this automatically and voices long texts in short pieces, which keeps words from being repeated or cut off.","Listen to the demos before you buy: a voice keeps the character of its recording, including its accent."]},{"heading":"Voices of real people and the rules of the model","paragraphs":["Some catalog voices are inspired by well-known people. They are not their real voices, and the people did not take part in them, so do not present such audio as their real words.","Supertonic 3 is released under the BigScience Open RAIL-M license, and its use restrictions apply to every voice: do not use speech to impersonate someone without consent, to deceive or to harass, and say that the audio is machine-generated where that matters."]}],"faq":[{"question":"Where can I download Supertonic 3 voices?","answer":"Ten preset voices come with the model. Free custom voices are on GitHub in superclonica/supertonic-voices and in the SuperClonica catalog, which also sells 170+ character and narrator voices. Each voice is one JSON file."},{"question":"Does a Supertonic 3 voice speak other languages?","answer":"Yes. Every voice speaks all 31 languages of the model; you choose the language with the lang parameter. It sounds most natural in the language it was recorded in. Chinese is not supported."},{"question":"Is the voice file all I need?","answer":"You also need the model and a program that runs it: the official Supertonic code, the SuperClonica engine or its Docker image. The model, about 385 MB, downloads once; after that speech is generated offline."},{"question":"Can I make a Supertonic 3 voice from my own recording?","answer":"Yes. SuperClonica trains a voice from a short clean recording for free on your own NVIDIA GPU, or you can order one from an author on the commissions page. Supertone's former Voice Builder service is no longer available."}],"cta":{"catalog":"Browse Supertonic 3 voices","install":"Install the SuperClonica engine"},"sources":[{"label":"Supertonic quick start (GitHub)","url":"https://github.com/supertone-oss-archive/supertonic#quick-start"},{"label":"Supertonic Python examples: voice styles and options","url":"https://github.com/supertone-oss-archive/supertonic/blob/main/py/README.md"},{"label":"Supertonic 3 model card (Hugging Face)","url":"https://huggingface.co/supertone-oss-archive/supertonic-3"},{"label":"Free Supertonic 3 voices (GitHub)","url":"https://github.com/superclonica/supertonic-voices"},{"label":"SuperClonica engine (PyPI)","url":"https://pypi.org/project/superclonica-cpu/"},{"label":"SuperClonica Docker image (Docker Hub)","url":"https://hub.docker.com/r/superclonica/superclonica"}],"published":"2026-10-22","updated":"2026-10-23","pages":[{"slug":"offline-text-to-speech","path":"/guides/offline-text-to-speech","h1":"How to convert text to speech offline on your computer"},{"slug":"voice-cloning","path":"/guides/voice-cloning","h1":"Voice cloning: how to get a voice that sounds like a recording"},{"slug":"best-free-tts-models","path":"/guides/best-free-tts-models","h1":"The best free text-to-speech models for local use in 2026"},{"slug":"text-to-speech-for-videos","path":"/guides/text-to-speech-for-videos","h1":"Text to speech for videos, audiobooks, games and apps"},{"slug":"supertonic-3-voices","path":"/guides/supertonic-3-voices","h1":"Supertonic 3 voices: where to get custom voices and how to use them"},{"slug":"python-text-to-speech","path":"/guides/python-text-to-speech","h1":"Text to speech in Python: offline, free and with natural voices"},{"slug":"text-to-speech-api-docker","path":"/guides/text-to-speech-api-docker","h1":"Self-hosted text-to-speech API in Docker"}],"related":[{"slug":"text-to-speech","path":"/text-to-speech","h1":"Text-to-speech that runs on your own computer"},{"slug":"supertonic","path":"/compare/supertonic","h1":"Supertonic vs SuperClonica: same model, faster and cleaner"},{"slug":"fish-audio","path":"/compare/fish-audio","h1":"Fish Audio and Fish Speech vs SuperClonica"},{"slug":"omnivoice","path":"/compare/omnivoice","h1":"OmniVoice vs SuperClonica: more languages or more speed"},{"slug":"qwen3-tts","path":"/compare/qwen3-tts","h1":"Qwen3-TTS vs SuperClonica for local text-to-speech"},{"slug":"voxcpm","path":"/compare/voxcpm","h1":"VoxCPM 2 vs SuperClonica: studio sound or CPU speed"},{"slug":"f5-tts","path":"/compare/f5-tts","h1":"F5-TTS vs SuperClonica: zero-shot cloning or fast CPU speech"},{"slug":"elevenlabs","path":"/compare/elevenlabs","h1":"An offline alternative to ElevenLabs"},{"slug":"kokoro","path":"/compare/kokoro","h1":"Kokoro TTS vs SuperClonica: two small models for local speech"},{"slug":"piper","path":"/compare/piper","h1":"Piper TTS vs SuperClonica: tiny devices or custom voices"},{"slug":"xtts","path":"/compare/xtts","h1":"Coqui XTTS-v2 vs SuperClonica: a Coqui TTS alternative"},{"slug":"chatterbox","path":"/compare/chatterbox","h1":"Chatterbox TTS vs SuperClonica: instant cloning or a trained voice file"}]}