Add Chatterbox TTS to Home Assistant

Add Chatterbox TTS to Home Assistant

Install the OpenAI-TTS HACS Extension by sfortis

GitHub - sfortis/openai_tts: Custom TTS component for Home Assistant. Utilizes the OpenAI speech engine or any compatible endpoint to deliver high-quality speech. Optionally offers chime and audio normalization features.
Custom TTS component for Home Assistant. Utilizes the OpenAI speech engine or any compatible endpoint to deliver high-quality speech. Optionally offers chime and audio normalization features. - sfo…

Currently (Dec 2025) the Beta branch is required as Chatterbox has no API key. This works perfectly and I would hope the optional API key for 3rd party OpenAI replacements is moved in to the main branch.

Once installed add the extension via settings > devices in Home Assissant

And enter your URL like so: http://ChatterboxIP:PORT/v1/audio/speech

You can use the documentation for extra variables: https://github.com/travisvn/chatterbox-tts-api/blob/main/docs/STREAMING_API.md#server-side-events-sse-streaming

Like so:

For the voice, manually type your voice name from Chatterbox, as the drop down list is for OpenAI voices.

Ensure you add this variable to fast streaming, which starts almost immediately.

{
"stream_format": "sse",
}

Here is everything if you would like to copy and use/edit

{
"exaggeration": 0.7,
"cfg_weight": 0.1,
"temperature": 0.45,
"streaming_chunk_size": 200,
"streaming_strategy": "sentence"
"stream_format": "sse",
}