v2.3.0

Wilfred/difftasticv2.3.0Aug 17, 2025by nazdridoy

AI Summary

This release introduces greater flexibility by allowing users to specify custom paths for ONNX models and voice files via the command line, alongside stricter validation to ensure startup reliability.

Key Highlights

  • Custom Model & Voice Paths via command line (--model and --voices options)
  • Improved Startup Reliability with upfront checks for necessary model files
  • Mandatory Model Files requirement for .onnx and .bin formats

Breaking Changes

  • Mandatory Model Files: The application now strictly requires .onnx and .bin model files to be present at startup or it will exit with an error.

New Features

  • Command-line options --model and --voices for custom path specification
  • Enhanced model validation to ensure required files exist before startup

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