Coqui TTS Trainer is a general-purpose model trainer for PyTorch, designed to be flexible and extensible. It's part of the wider Coqui AI ecosystem, providing core training utilities for various deep learning models, including those for Text-to-Speech. The current version is 0.4.0, with releases occurring on an irregular, feature-driven cadence.
pip install coqui-tts-trainerVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to set up a basic training loop using the `Trainer` class. It defines a simple PyTorch model and dataset, then configures the `Trainer` with a `TrainerConfig`, optimizer, scheduler, criterion, and data loaders. The `trainer.train()` method then executes the training process.
Review your code for direct calls to internal `coqui-tts-trainer` helper functions. Update to a compatible version of the main `coqui` library (v0.28.0 or newer if using the full Coqui stack) if experiencing integration issues.
Upgrade your Python environment to version 3.10, 3.11, 3.12, 3.13, or 3.14. Using Python 3.15 or newer is not yet supported.
Ensure your custom schedulers adhere to the standard `torch.optim.lr_scheduler` interface. Review any custom logic for loading optimizer/scheduler states from checkpoints to align with the updated restoration behavior.
Use a dedicated virtual environment to manage dependencies, preventing conflicts with other `coqpit` installations. The `coqui-tts-trainer` package will automatically install its required forked `coqpit` version.
Explicitly install `coqui-tts-trainer` with the `[cpu]` or `[cuda]` extras (e.g., `pip install coqui-tts-trainer[cpu]`) if your training pipeline requires `numpy` or `soundfile`.