v0.3.1

fregante/GhostTextv0.3.1Jul 15, 2026by andimarafioti

AI Summary

This release introduces a standardized public API for backend warmup and updates the demo deployment to use the published PyPI package.

Key Highlights

Expose public `model.warmup(prefill_len=100)` API
Update demo Space deployment to use PyPI package
Resolve backend interface mismatch reported in issue #354

New Features

Expose public backend warmup API
Install published PyPI package in the demo Space deployment

Full Release Notes

## Highlights

- Add a public `model.warmup(prefill_len=100)` API shared by the Torch and GGML backends.
- Keep the former private Torch `_warmup()` entry point as a compatibility alias.
- Capture CUDA graphs once on Torch while treating GGML warmup as a safe no-op until qwentts.cpp exposes a native preparation hook.
- Update internal, demo, example, and test callers to use the public API.
- Install the published PyPI package in the demo Space deployment.

This resolves the backend interface mismatch reported in [huggingface/speech-to-speech#354](https://github.com/huggingface/speech-to-speech/issues/354).

## Installation

```bash
pip install faster-qwen3-tts==0.3.1
```

For the optional GGML backend:

```bash
pip install "faster-qwen3-tts[ggml]==0.3.1"
```

## Changes

- [#128](https://github.com/andimarafioti/faster-qwen3-tts/pull/128) — Expose public backend warmup API
- [#122](https://github.com/andimarafioti/faster-qwen3-tts/pull/122) — Use the PyPI package in the demo Space

**Full changelog:** https://github.com/andimarafioti/faster-qwen3-tts/compare/v0.3.0...v0.3.1