# Install the faster Supertonic 3 engine

SuperClonica is a speech engine built on Supertonic 3: faster on CPU and GPU, cleaner sound, compatible with Supertonic 3 voice JSON files.

SuperClonica is our speech engine built on Supertonic 3. It is faster on CPU and GPU, sounds cleaner and works with the same voice JSON files.

The packages are published on PyPI: superclonica-cpu and superclonica-gpu-cuda.

## 1. Install the package

Python 3.10 or newer is required. Install one of the two packages: for the CPU or for an NVIDIA GPU. For the GPU, pip installs CUDA and cuDNN itself.

## 2. Download a voice

Open "My library" and download the voice JSON. Files made for Supertonic 3 work too.

## 3. Turn text into speech

Pass the JSON path to the voice parameter. The Supertonic 3 base model (about 400 MB) is downloaded on first run.

## Installation

### CPU: Windows, macOS, Linux

```
python -m pip install superclonica-cpu
```

### NVIDIA GPU: Windows or Linux x86-64

Requires Python 3.11 or newer and an NVIDIA driver.

```
python -m pip install superclonica-gpu-cuda
```

Install only one package: together they get in each other’s way. To switch, first remove the previous one along with its ONNX Runtime:

```
python -m pip uninstall -y superclonica-cpu superclonica-gpu-cuda onnxruntime onnxruntime-gpu
```

## Speech from Python

```
from superclonica import Superclonica

tts = Superclonica()  # GPU if available, otherwise CPU
audio, sample_rate = tts.synthesize(
    "Hello! Your new voice is ready.", voice="voice.json", lang="en", seed=7
)
tts.save("hello.wav", audio)
```

Long texts, dialogues, custom voices and a comparison with pyttsx3 and gTTS: Text to speech in Python.

## Speech from the command line

```
superclonica --text "Hello! Your new voice is ready." --voice voice.json --lang en --output hello.wav
```

## With Docker

A ready image with an HTTP server and the command line: superclonica/superclonica. The model (about 400 MB) downloads on the first start into the superclonica-models volume.

### CPU

```
docker run -d -p 8000:8000 -v superclonica-models:/models superclonica/superclonica:cpu
```

### NVIDIA GPU

Requires the NVIDIA driver and the NVIDIA Container Toolkit.

```
docker run -d --gpus all -p 8000:8000 -v superclonica-models:/models superclonica/superclonica:cuda
```

### Speech through the server

The voice goes into the request as the JSON file itself. It is about 0.3 MB, so build the request in a file:

```
python -c "import json; json.dump({'text': 'Hello! Your new voice is ready.', 'lang': 'en', 'voice': json.load(open('voice.json'))}, open('request.json', 'w'))"
curl -X POST localhost:8000/synthesize -H "Content-Type: application/json" -d @request.json -o hello.wav
```

API key, settings, custom voices and running in production: Text-to-speech API in Docker.

## Text-to-speech guides

- [How to convert text to speech offline on your computer](https://superclonica.com/en/guides/offline-text-to-speech)
- [Voice cloning: how to get a voice that sounds like a recording](https://superclonica.com/en/guides/voice-cloning)
- [The best free text-to-speech models for local use in 2026](https://superclonica.com/en/guides/best-free-tts-models)
- [Text to speech for videos, audiobooks, games and apps](https://superclonica.com/en/guides/text-to-speech-for-videos)
- [Supertonic 3 voices: where to get custom voices and how to use them](https://superclonica.com/en/guides/supertonic-3-voices)
- [Text to speech in Python: offline, free and with natural voices](https://superclonica.com/en/guides/python-text-to-speech)
- [Self-hosted text-to-speech API in Docker](https://superclonica.com/en/guides/text-to-speech-api-docker)
- [SuperClonica](https://superclonica.com/en/)
- [AI voice catalog for text to speech](https://superclonica.com/en/explore)
- [Custom voice commissions for Supertonic 3](https://superclonica.com/en/requests)
- [How it works: voices, local speech, training](https://superclonica.com/en/guide)
- [Install the faster Supertonic 3 engine](https://superclonica.com/en/superclonica)
- [About us: speech synthesis enthusiasts](https://superclonica.com/en/about)
- [Contacts, support and voice complaints](https://superclonica.com/en/contacts)
- [Privacy policy: what data we keep](https://superclonica.com/en/privacy)
- [Terms of use: rules for buyers and authors](https://superclonica.com/en/terms)
- [Text to speech](https://superclonica.com/en/text-to-speech)