Chatterbox TTS

0.1.7 verified Mon Apr 27 auth: no python

Chatterbox (formerly Resemble Enhance) is an open-source text-to-speech and voice conversion library by Resemble AI. Version 0.1.7 supports Python >= 3.10. The library is actively developed on GitHub with regular releases.

pip install chatterbox-tts

Common errors

error ModuleNotFoundError: No module named 'chatterbox_tts' ↓

cause Trying to import the package name with underscore or dash.

fix

Use 'import chatterbox' or 'from chatterbox import TTS'.

error AttributeError: module 'chatterbox' has no attribute 'TTS' ↓

cause Installed an older version (pre-0.1) or misnamed import.

fix

Upgrade to latest: pip install chatterbox-tts --upgrade, then use 'from chatterbox import TTS'.

error RuntimeError: Model 'chatterbox-medium' not found ↓

cause Using short model name without full prefix.

fix

Use complete model ID: 'chatterbox-tts/en_US/chatterbox-medium'.

Warnings

gotcha The import path uses 'chatterbox' not 'chatterbox_tts'. Installing from PyPI as 'chatterbox-tts' but importing as 'chatterbox' is a common mistake. ↓

fix Use 'from chatterbox import TTS'

gotcha model_name expects full model ID (e.g., 'chatterbox-tts/en_US/chatterbox-medium'). Omitting prefix may cause download errors. ↓

fix Include the full model ID from the list of available models.

deprecated The older 'Resemble Enhance' API is deprecated. Use 'chatterbox' TTS class instead. ↓

fix Replace 'from resemble_enhance import TTS' with 'from chatterbox import TTS'

Imports

TTS
wrong
```
from chatterbox_tts import TTS
```
correct
```
from chatterbox import TTS
```
Package name uses underscore but import path is 'chatterbox'.
VoiceConverter
```
from chatterbox import VoiceConverter
```

Quickstart

Basic TTS synthesis using the medium English model.

from chatterbox import TTS
tts = TTS(model_name='chatterbox-tts/en_US/chatterbox-medium')
tts.tts_to_file(text='Hello world.', file_path='output.wav')