トラブル対処と制約

起動・依存関係

• DLLの読み込み失敗：Python 3.12と uv sync --locked を確認してください。Windowsのアプリ制御は無効化せず、許可されたPythonを使用します。
• 初回起動が遅い：モデルのダウンロードと読み込みを待ち、ログを確認してください。
• ポート使用中：GRADIO_SERVER_PORT を変更します。
• オフラインで失敗：メインモデルだけでなく、トークナイザー・コーデック・透かしモデルのキャッシュも必要です。

声の生成

• CPUでは生成に時間がかかります。短いセリフと16ステップで試し、必要に応じて増やします。
• 参照は同じ話者の明瞭な音声を使います。複数参照の試聴プレイヤーは先頭のみです。
• 参照を使っても声質の完全一致は保証されません。生成したセリフと音声を確認してください。
• 生成結果は一時ファイルです。残したいものはダウンロードしてください。

ホスティング

GitHub Pagesはドキュメント専用です。Pythonモデルの推論は実行しません。このリポジトリのuv構成はローカルCPU向けです。元コードのZeroGPU経路は残っていますが、Space用メタデータとCUDA環境は別途必要です。