vtts — Voice TTS

Unified TTS wrapper for Kokoro 82M and Chatterbox Turbo in one simple API.

Installation

# Base install
pip install vtts

# With Kokoro support
pip install vtts[kokoro]

# With Chatterbox support
pip install vtts[chatterbox]

# Everything
pip install vtts[all]

Usage

Kokoro 82M — kspeak

from vtts import kspeak

kspeak("Hello world!")                                    # defaults: voice="af_heart"
kspeak("Different voice.", voice="af_bella")              # change voice
kspeak("Save somewhere.", output="greet.wav")             # custom output
kspeak("Speak faster.", speed=1.3)                        # adjust speed

Chatterbox Turbo — cspeak

from vtts import cspeak

cspeak("Hello world!", ref="voice.wav")                   # requires a reference voice WAV
cspeak("Clone a voice.", ref="other_voice.wav")           # different reference
cspeak("Ha! [laugh] That's funny.", ref="voice.wav")      # paralinguistic tags

Notes

• Kokoro 82M is lightweight (82M params) and runs on CPU. Uses espeak-ng for phonemization.
• Chatterbox Turbo is larger and runs on CUDA GPU. Supports zero-shot voice cloning.
• Models are loaded lazily on first call and cached — subsequent calls are fast.