Install & Compatibility
Where this runs
tested against v0.27.5 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
py 3.13
✕ build_error
✕ dependency_conflict
5683MB installed
● package 5683MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
TTS
✓ from TTS.api import TTS
✗ from coqui_tts.tts import TTS
The primary API is exposed through TTS.api, not lower-level internal modules.
This quickstart demonstrates how to initialize a Coqui TTS model and synthesize speech to an audio file. It uses a default VITS model for English. Remember to install PyTorch and Torchaudio manually if using coqui-tts versions 0.27.4 or newer. Adjust `gpu=True` for GPU acceleration if available and configured.
from TTS.api import TTS
import os
# This will download and load a default VITS model into memory.
# For GPU, set gpu=True. Ensure appropriate PyTorch version is installed.
# If you encounter issues, try a different model_name, e.g., 'tts_models/multilingual/multi-dataset/xtts_v2'
# For XTTS, you'd also need a speaker_wav file.
# For simpler, single-speaker models, speaker_wav is often optional.
tts = TTS(model_name="tts_models/en/ljspeech/vits", progress_bar=True, gpu=False)
# Synthesize speech to a file.
# Replace 'output.wav' with your desired output path.
output_file = "coqui_output.wav"
tts.tts_to_file(
text="Hello from Coqui TTS, the ultimate text-to-speech library!",
file_path=output_file,
language="en"
)
print(f"Speech saved to {os.path.abspath(output_file)}")
tts --version
Debug
Known issues
breakingStarting from v0.27.4, `coqui-tts` no longer installs `torch`, `torchaudio`, and `torchcodec` by default. Users must install these PyTorch dependencies manually to match their system (CPU/CUDA) and desired PyTorch version.fixAfter `pip install coqui-tts`, manually install PyTorch and Torchaudio, e.g., `pip install torch==X.Y.Z torchaudio==X.Y.Z --index-url https://download.pytorch.org/whl/cuXXX` (for CUDA) or `.../whl/cpu` (for CPU). Refer to PyTorch's official installation instructions for specific versions.
affects: >=0.27.4
breakingThe old caching mechanism for Bark and Tortoise models has been removed. Additionally, the `speaker_id` argument in the `synthesize()` method is deprecated.fixSwitch to the new speaker caching mechanism (consult official documentation for updated cloning details). Avoid using `speaker_id` and prefer `speaker_wav` or other model-specific parameters for speaker selection.
affects: >=0.27.0
gotchaCompatibility issues can arise with the `transformers` library, leading to incorrect output or inference errors. Specific `transformers` versions might be required for certain `coqui-tts` releases.fixCheck the Coqui TTS release notes or GitHub issues for recommended `transformers` versions. For example, v0.26.2 restricted transformers to `<4.52`, while v0.27.5 fixed issues with `transformers>=5`. If you encounter issues, try pinning `transformers` to a known working version.
affects: All versions, notably around 0.26.x and 0.27.x
gotchaCoqui TTS has strict Python version requirements, currently `<3.15,>=3.10`.fixEnsure your Python environment is within the supported range. Create a new virtual environment with a compatible Python version if necessary (e.g., Python 3.10, 3.11, 3.12, 3.13).
affects: All versions
Upgrade
Version history
0.27.5latest on PyPI · released Jan 26, 2026
Audit
Dependencies
torchrequiredCore deep learning framework. Not installed by default since v0.27.4.
torchaudiorequiredAudio processing library for PyTorch. Not installed by default since v0.27.4.
transformersrequiredUsed for various models, requires careful version management for compatibility.