GitHub Releases には 3 種類の CLI バイナリが並んでおり、初めて使うときはどれを選べばよいか迷いがちです。このドキュメントは、用途・OS・アーキテクチャから最適なバイナリを選ぶための判断材料をまとめたものです。
迷ったら C++ CLI (piper-plus-cpp-*) を選んでください。 最も多くのプラットフォームで動作し、Quick Start のサンプルとも整合しています。Linux arm64 は glibc 互換修正を含む v2.0.2 を使用してください（下記参照）。
| バリアント | 実装 | プレフィクス | 特徴 | 推奨用途 |
|---|---|---|---|---|
| C++ CLI | C++ | piper-plus-cpp-* |
最も成熟・安定。バイナリサイズ最小、起動が軽量。armv7 (32bit ARM) を唯一サポート。OpenJTalk 辞書の自動 DL に対応 | 初めて使う / 組み込み機器 / Raspberry Pi / 本番運用で安定性重視 |
| C# .NET CLI | C# / .NET 10 | piper-plus-cli-* |
8 言語マルチリンガル (JA/EN/ZH/KO/ES/FR/PT/SV)、lid テンソル対応、ストリーミング文分割、カスタム辞書 (JSON/TSV)、インライン音素 [[ph]] 記法、モデル名自動解決。Intel Mac (osx-x64) を唯一サポート |
Windows ユーザー / Intel Mac ユーザー / 多言語合成 / .NET 環境との統合 |
| Rust CLI | Rust | piper-plus-rs-cli-* |
ストリーミング。公開 archive は CPU build。GPU は provider feature を有効にした source build が必要。8 言語対応。--sentence-silence, --phoneme-silence 等の細かい無音制御。jpreprocess (lindera) と naist-jdic (OpenJTalk) を選択可能 |
CPU で Rust CLI を使いたい / source build する開発者 |
各バリアントの実装は src/cpp/、src/csharp/PiperPlus.Cli/、src/rust/piper-cli/ にあります。
o = 配布あり、- = 配布なし
| OS / アーキテクチャ | C++ (piper-plus-cpp-*) |
C# (piper-plus-cli-*) |
Rust (piper-plus-rs-cli-*) |
|---|---|---|---|
| Linux x64 | o | o | o |
| Linux arm64 (Raspberry Pi 5 等) | o* | o | - |
| Linux armv7 (Raspberry Pi 4 32bit 等) | o | - | - |
| macOS arm64 (Apple Silicon) | o | o | o |
| macOS x64 (Intel Mac) | - | o | - |
| Windows x64 | o | o | o |
| Windows arm64 | - | o | - |
Intel Mac、Linux armv7、Windows arm64 のいずれかを使う場合は、選択肢が一意に決まる点に注意してください。
* v2.0.2 の piper-plus-cpp-linux-arm64.tar.gz は Bullseye でビルドし、GLIBC 2.31 を ABI 上限として CI で検査します。同じアーカイブの起動と日本語合成を QEMU 上の Debian Bullseye / Bookworm / Trixie（64bit）で検証します。旧 v2.0.1 は GLIBC 2.38 を要求するため Bullseye / Bookworm では使用できません。Raspberry Pi 実機・Raspberry Pi OS 自体・性能と C# ARM64 の Bullseye 動作はこの検証の対象外です。
- Raspberry Pi 4 (32bit) などの armv7 環境 -> C++ CLI 一択 (
piper-plus-cpp-linux-armv7.tar.gz) - Linux arm64 で Debian Bullseye 等の広い glibc 互換性が必要 -> v2.0.2 の C++ CLIを取得 (ABI 上限 GLIBC 2.31)
- Intel Mac (macOS x64) -> C# .NET CLI 一択 (
piper-plus-cli-osx-x64.tar.gz) - Windows on ARM -> C# .NET CLI 一択 (
piper-plus-cli-win-arm64.zip) - GPU 推論 (CUDA / CoreML / DirectML) を使いたい -> Rust CLI を provider feature 付きで source build（手順。公開
piper-plus-rs-cli-*は CPU build） - Windows / 多言語 (中国語・スペイン語など) を使う / .NET と統合したい -> C# .NET CLI
- 上記に当てはまらない / とにかく動かしたい / 何を選んでよいか分からない -> C++ CLI
Apple Silicon Mac で piper-plus-cpp-macos-arm64.tar.gz (C++) と piper-plus-cli-osx-arm64.tar.gz (C#) で迷った場合、まずは C++ を試し、多言語合成や lid テンソル対応モデルを使う場面で C# を検討するのがおすすめです。
このリリースの配布先は v2.0.2 です。再現可能な取得には tag を固定してください。latest を使う場合は、asset 名と互換性をリリースページで再確認してください。
VERSION=v2.0.2
curl -LO https://github.com/ayutaz/piper-plus/releases/download/${VERSION}/piper-plus-cpp-macos-arm64.tar.gz
tar -xzf piper-plus-cpp-macos-arm64.tar.gz
cd piper-plus
./bin/piper-plus --helpVERSION=v2.0.2
curl -LO https://github.com/ayutaz/piper-plus/releases/download/${VERSION}/piper-plus-cli-linux-x64.tar.gz
tar -xzf piper-plus-cli-linux-x64.tar.gz
./PiperPlus.Cli --helpPowerShell:
$version = "v2.0.2"
Invoke-WebRequest -Uri "https://github.com/ayutaz/piper-plus/releases/download/$version/piper-plus-rs-cli-win-x64.zip" -OutFile piper-plus-rs-cli.zip
Expand-Archive piper-plus-rs-cli.zip -DestinationPath piper-plus-rs-cli
.\piper-plus-rs-cli\piper-plus-cli.exe --help実行例の詳細は README の Quick Start セクションを参照してください。
Gatekeeper によりブロックされる場合があります。展開後、隔離属性を外してください。
xattr -dr com.apple.quarantine ./bin/piper-plusまたは「システム設定 > プライバシーとセキュリティ」から個別に許可することもできます。
C++ CLI のアーカイブには ONNX Runtime の共有ライブラリが lib/ ディレクトリに同梱されています。展開した piper-plus ディレクトリ直下で LD_LIBRARY_PATH に lib を追加してから実行してください。
export LD_LIBRARY_PATH=$(pwd)/lib:$LD_LIBRARY_PATH
./bin/piper-plus --help署名されていないバイナリは初回起動時にブロックされることがあります。「詳細情報」 -> 「実行」で許可するか、ファイルのプロパティから「ブロックの解除」にチェックを入れてください。
piper-plus-cli-* はセルフコンテインド (self-contained) でビルドされており、別途 .NET ランタイムをインストールする必要はありません。
その他の問題は troubleshooting.md を参照してください。