haqumei

Haqumei（薄明/拍命）は、Rustで実装された日本語の書記素から音素への変換（G2P）ライブラリであり、Pythonバインディングとコマンドラインインターフェースを備えています。日本語のテキストを音素列に変換し、音声合成やテキスト読み上げフロントエンド向けに、正確で詳細な言語分析を提供します。 **中核機能** このライブラリは、いくつかの主要なAPIを提供します： - `g2p`：基本的なテキストから音素への変換 - `g2k`：テキストからカタカナ読みへの変換 - `g2p_prosody`：韻律記号（ピッチの上昇・下降、句境界、ポーズ）で注釈された音素列 - `g2p_mapping`：未知語検出を含む単語-音素マッピング - `g2p_mapping_detailed`：品詞とアクセント情報を含む詳細なマッピング - `g2p_mapping_prosody`：韻律、ピッチ、形態情報を含む構造化マッピング - `g2p_candidates`：曖昧なテキストに対する複数の読み候補 **精度** Haqumeiは、jsut-labelベンチマークで0.83%の音素誤り率（PER）、ROHANで0.78%のカタカナ誤り率（KER）を達成しており、pyopenjtalk（PER 1.31%、KER 5.02%）やpyopenjtalk-plus（PER 1.09%、KER 1.60%）を上回っています。精度の向上は、pyopenjtalk-plusの辞書と技術を基盤としています。 **特徴** - **単語-音素マッピング**：単語と音素の間のマッピングを提供し、未知語（`unk`）や空白（`sp`）の検出も含むため、入力テキストからの情報損失を最小限に抑えます。 - **韻律情報**：ピッチの高低注釈、アクセント句境界、韻律記号を含む複数の韻律形式（デフォルト、プレフィックス、数値）をサポートします。 - **異音解決**：撥音と促音を専用の音素ラベルで処理します。 - **未知語フォールバック**：haqumei-kanalizerによる英単語の読み推定、漢字の音読みフォールバック、カタカナのみの単語のアクセント修正に対応。 - **並行処理**：マルチスレッドG2P操作のためのバッチ処理メソッド。 - **カスタムオプション**：異音ラベル、Unicode正規化、読み動作の柔軟な設定。 - **カスタム辞書**：カスタム組み込み辞書でのビルドをサポート。 **インストール** - Rust：`cargo add haqumei` - Python：`pip install haqumei`（Linux x86_64/aarch64、macOS aarch64、Windows x86_64向けのプリビルドホイール） - CLI：`cargo install haqumei-cli` **技術詳細** このライブラリは形態素解析にMeCabを使用し、HTS形式のフルコンテキストラベル形式を拡張しています。ビルドプロセス中に辞書を埋め込みます（カスタム辞書が提供されない限り、ネットワークからダウンロード）。Pythonバインディングは辞書をバンドルしたプリビルドホイールを使用するため、インストール中にネットワークアクセスは不要です。 **ライセンス** Apache-2.0