Repository navigation
piper-plus 2.1.0
つくよみちゃんモデルの利用案内を全ランタイムで表示するようにし、あわせてモデル名の解決、制御文字の扱い、各ランタイムの G2P を Python にそろえた更新です。本体と各パッケージを同時に公開しました。
つくよみちゃんモデルの利用案内
Python / Rust / Go / C# / C++ の CLI とサーバー、ブラウザ版 (npm piper-plus) は、つくよみちゃんモデルを読み込むと、利用条件を stderr (ブラウザでは console.warn) に 1 プロセスで 1 回表示します。権利者の方に問い合わせが届いてしまったため、依頼を受けて追加しました。
- 生成した音声を使うときは「Piper Plus:つくよみちゃん」のクレジット表記が必須です。
- このモデルはつくよみちゃん側から見ると非公式の作品です。夢前黎様は開発・サポートに携わっていないため、お問い合わせは開発者へお願いします。
- 禁止事項と規約: https://huggingface.co/ayousanz/piper-plus-tsukuyomi-chan
別名・カタログのキー・リポジトリ ID・Hugging Face の URL、または tsukuyomi-chan-6lang-fp16.onnx / tsukuyomi.onnx というファイル名で読み込んだときに表示します。PIPER_PLUS_DISABLE_MODEL_NOTICE=1 で消せます (--quiet では消えません)。ブラウザでは showModelNotice: false です。CLI のオプションと --help は変わりません。
ライブラリは案内文を返すだけで、自分では表示しません (piper_plus.download.get_model_notice()、piperplus.ModelNotice()、ModelManager.GetModelNotice() など)。C API はモデルのパスだけを受け取るため何も表示しません。モデルを同梱するアプリでは、iOS ガイドと C API / Dart / Godot のサンプル README にあるとおり、アプリ側で案内を表示してください。
今回公開したパッケージ
| 対象 | パッケージ | 版 |
|---|---|---|
| Python / ネイティブ | PyPI piper-plus、C++ / C API、Swift PiperPlus / PiperPlusG2P、Docker |
2.1.0 |
| Python G2P | PyPI piper-plus-g2p |
0.4.0 |
| Rust | crates.io piper-plus-g2p / piper-plus / piper-plus-cli |
0.5.4 |
| C# | NuGet PiperPlus.Core / PiperPlus.Cli |
0.6.0 |
| npm | @piper-plus/g2p |
0.5.0 |
| npm | piper-plus |
0.9.1 |
| Kotlin G2P | Maven Central io.github.ayutaz:piper-plus-g2p-android |
1.1.0 |
| Go | module src/go / src/go/phonemize |
v0.3.0 / v0.4.0 |
npm piper-plus は 0.9.1 を使ってください。0.9.0 は npm のページに表示される README が 0.8.2 のままで、その手順どおりに入れると利用案内を表示しない 0.8.2 が入ってしまうため、コードは同じまま README を直した 0.9.1 を出しました。
主な変更
- モデル名: Python / Rust / Go / C# / C++ / ブラウザのすべてで、カタログの 3 モデルのキーと全別名を受け付けるようにしました。Hugging Face のリポジトリ ID (
ayousanz/piper-plus-tsukuyomi-chanなど) も別名として扱います。Python のpiper-plus --model tsukuyomiと HTTP サーバーは、ダウンロードの後にMissing files for voice tsukuyomiで止まっていましたが、直りました。Go の CLI は--modelにカタログ名を渡すと、未取得なら Hugging Face から取得します。 - つくよみちゃんの
config.json: Hugging Face 上のファイルは 2026-06-13 から 6901 バイトですが、カタログが 6279 バイトのままだったため、正しいファイルを壊れていると判断して毎回取得し直していました (Python、C#、C++ の--download-modelなど)。カタログを 6901 に直しました。モデル本体は変わっていません。 - 制御文字: 全ランタイムで、読み上げる前に同じ規則で制御文字を除きます。
\n\t\rは残し、VT / FF / NEL は単語の区切りなので空白に置き換え、ほかの制御文字は取り除きます。これまでは単語の中の NUL などで単語が 2 つに分かれる、短いテキストの補正が効かない、などのずれがありました。C API のpiper_plus_synth_startとストリーミング関数は、制御文字だけのテキストを空のテキストと同じくPIPER_PLUS_ERR_TEXTで拒否します。規則はdocs/spec/input-sanitize-contract.tomlにあります。 - 文の分割: 全ランタイムで、数字に挟まれた
.(3.14、2.0.1、3.5) とe.g./i.e.の中では文を区切らないようにしました。これまでは3.14を「three」「fourteen」と読んでいました。 - G2P を Python にそろえる: C++ / Rust / Go / C# / npm の英語は、数字を読み上げ (
100、3.14、$5など)、アクセント付きの文字や辞書にない語も落とさず読むようにしました。フランス語のエリジオン (c'est) とリエゾン (les amis) を Python と同じ規則にしました。CJK の句読点と全角記号はどの言語にも属さない文字として扱い、中国語の文が,。を失わなくなりました。中国語の共有ピンイン辞書を数字の声調で作り直し、Python 以外で声調が崩れる問題を直しました。言語を指定したときは、ラテン文字の部分をその言語として読みます (これまでスペイン語などが英語として読まれることがありました)。 - Python runtime: スウェーデン語の音素化器を追加しました。モデルの
language_id_mapにsvがあるときだけ使うので、公開中の 6 言語モデルの読みは変わりません。PiperVoice.phonemize(text, language_id)も指定した言語で読みます。 - zero-shot の話者 embedding: Rust / Go / C# の
SpeakerEncoderは、zs-v1 のcampplus.onnx(192 次元) で Python と同じ embedding を計算します。これまでは別の前処理を使っていたため、同じ参照音声でも Python と違う声になっていました。ブラウザ版にも同じ前処理 (frontEnd: "kaldi-fbank") を追加しました。Hugging Face Space と GitHub Pages のデモに、参照音声の声で読み上げる zero-shot の画面を追加しました (機能の確認用で、品質の承認ではありません)。 - Swift
PiperPlusG2P: Rust の G2P の修正を取り込みました。言語を 1 つ指定しても英字を含む中国語を Python と同じく読み (Hello你好)、中国語の中の数字も読みます。Phonemizer.phonemizeはネイティブ呼び出しの前に制御文字を除くため、Swift の文字列の途中の NUL でテキストが切れなくなりました。 - Docker / WebUI: runtime イメージ (
python-inference、webui、wyomingなど) から pip を外しました。これらから派生したイメージでパッケージを足すときはuv pip install --systemを使ってください (python-trainとcpp-devは pip を残します)。gradio を 6.31.0 に、gradio を入れる環境の Pillow を 13.0.0 に上げ、nltk の下限を 3.10.4 にして、既知の脆弱性を解消しました。WebUI の学習タブで、学習の再開とベースモデルからの追加学習ができるようになりました。
インストール
Python 3.11 以降の新しい環境で、次のいずれかを使用します。
pip install "piper-plus[cpu]==2.1.0"
# GPU環境では別の新しい環境へ(CUDA / cuDNNの要件は別途必要)
pip install "piper-plus[gpu]==2.1.0"
# G2Pだけを使用する場合
pip install "piper-plus-g2p[all]==0.4.0"Docker:
docker pull ghcr.io/ayutaz/piper-plus/python-inference:2.1.0
docker pull ghcr.io/ayutaz/piper-plus/python-inference:2.1.0-cpu
docker pull ghcr.io/ayutaz/piper-plus/webui:2.1.0
docker pull ghcr.io/ayutaz/piper-plus/wyoming:2.1.0Swift Package Manager:
.package(url: "https://github.com/ayutaz/piper-plus", from: "2.1.0"),配布物とバージョンの範囲
C++ CLI、C API / Apple / Android 共有ライブラリ、Python runtime をこの root リリースで配布します。添付ファイルには Rust 0.5.4 と C# 0.6.0 の CLI も含みます。Docker は同じソースコミットの docker-v2.1.0 からビルド・公開します。
Rust / NuGet / npm / Kotlin / Go は独立したバージョンで、それぞれのリリースに変更内容を書いています。
Full Changelog: v2.0.2...v2.1.0