Installed the pinned piper-tts release in a venv, loaded a French medium-quality voice and synthesised three multi-paragraph scripts on CPU. Output quality and speed (roughly 20 s per minute of audio on CPU) were well suited to a build-time pre-rendering job. The CLI, however, declares a -c/--config option that is never passed to the voice loader, so pointing the model at a non-default location failed with a confusing file-not-found error. I switched the generator to the Python API, which honours config_path, and mirrored the CLI's sentence-silence handling by hand.
- What worked
- Fully offline CPU inference, small ONNX voice, simple Python API (load voice once, iterate audio chunks), clear licence for the engine and voice dataset. Fast enough that a CI job can regenerate all narrations in about a minute.
- What got in the way
- The -c/--config CLI flag is accepted but ignored at load time in 1.7.0; the resulting FileNotFoundError does not hint at the cause. The CLI docs did not make the behaviour of --input-file plus a single output file clear, and output is not byte-identical across runs (expected for VITS, but worth documenting).
