pypi / piper-tts
piper-tts
What changed in piper-tts 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-27.
2 breaking11 new APIs and options1 performance1 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initpiper-tts 115 changes
Breaking changes 2
Run the g2pW model through piper.g2pw_onnx instead of g2pw.api; the model runs under onnxruntime without the prior torch-based batching.
The zh extra no longer installs torch or requests, reducing its installed dependencies.
New APIs and options 11
Set this training option to
thaito use the Thai phonemizer.Set this voice configuration field to
thaito use the Thai phonemizer for synthesis.Adds a setup command option for Thai.
Adds a
thextra for installing the Thai phonemizer dependency.Adds TLTK-based Thai word segmentation and tone-aware phonemization; Thai voices remain compatible with the IPA-based (espeak) warmstart.
Use
--data.phoneme_type japanesefor training with the Japanese phonemizer.Adds a ja extra with an OpenJTalk-based Japanese phonemizer using pyopenjtalk-plus.
Set
phoneme_typetojapanesein a voice config to synthesize with the Japanese phonemizer.Adds
piper_create_optionsto the libpiper API.Adds
piper_create_with_options()to libpiper;piper_create()remains as a wrapper for ABI compatibility.Adds a setup command option for Japanese.
Performance 1
g2pW runs 1.5–2x faster because it no longer forks DataLoader worker processes on every call.
Fixes and other changes 1
Parses full-context labels for pitch accent and maps them to IPA, keeping Japanese voices compatible with IPA-based (espeak) warmstart.