v2.3.0
ekzhang/borev2.3.0Aug 17, 2025by nazdridoy
AI Summary
This release introduces stricter model validation and custom path support for ONNX models and voice files, requiring mandatory model files to prevent startup failures.
Key Highlights
- Custom paths for .onnx models and voice files via command line
- Mandatory model file validation requiring .onnx and .bin files
- Improved startup reliability with upfront checks
Breaking Changes
- Mandatory Model Files: Application strictly requires .onnx and .bin model files at startup; missing files cause an error
New Features
- New command-line options --model and --voices
- Enhanced model validation checks
Full Release Notes
## What's New in v2.3.0 This release brings greater flexibility to how you manage your models and voices, alongside enhanced stability with stricter model file validation. ### Highlights * **Custom Model & Voice Paths**: You can now specify custom paths for your `.onnx` models and voice files directly from the command line. * **Improved Startup Reliability**: The application now performs an upfront check for all necessary model files, ensuring a smoother experience. ### Breaking Changes * **Mandatory Model Files**: The application now strictly requires `.onnx` and `.bin` model files to be present at startup. If these files are missing, the application will exit with an error. Ensure your environment is set up correctly with all required model assets. ### What's Changed * **New Command-Line Options**: Introduced `--model` and `--voices` options, allowing you to specify custom paths for your ONNX models and voice configuration files. * **Enhanced Model Validation**: Implemented robust checks to ensure all required `.onnx` and `.bin` model files are present before the application starts, improving overall stability. * **Documentation Updates**: The README has been updated to reflect the new requirements for model files. ### Installation ```bash # For new installations pip install kokoro-tts # Or your project's package name # To upgrade pip install --upgrade kokoro-tts # Or your project's package name ``` ### Full Changelog **Full Changelog**: https://github.com/nazdridoy/kokoro-tts/compare/v2.2.1...v2.3.0