ソフトウェア/LMStudio/Orpheus の履歴(No.1)

1. サーバー側（Windows機）セットアップ†

1. LM Studioをインストール
   • https://lmstudio.ai/ からダウンロード

1. モデルをダウンロード
   • Discover（検索）タブで検索、または以下のCLI

     lms get isaiahbjork/orpheus-3b-0.1-ft-Q4_K_M-GGUF

1. リモートアクセスを許可
   • Developerタブ → サーバー設定 → バインドアドレスを 0.0.0.0 に変更
   • Windowsファイアウォールでポート1234を開放

     New-NetFirewallRule -DisplayName "LM Studio API" -Direction Inbound -Protocol TCP -LocalPort 1234 -Action Allow

1. 実際のモデルIDを確認（フォルダ名やHF repo名とは一致しないので注意）

   curl http://<Windows機IP>:1234/v1/models

   • "id" フィールドの値（例: orpheus-3b-0.1-ft）を後の手順で使う

2. クライアント側セットアップ†

1. リポジトリをclone

   git clone https://github.com/isaiahbjork/orpheus-tts-local.git
   cd orpheus-tts-local

1. 仮想環境作成（Python 3.11指定。3.12以降は非対応のパッケージがあるため）

   uv venv --python 3.11
   source .venv/Scripts/activate

1. requirements.txt の罠を先に除去
   • 「wave」という行がある場合は削除する（標準ライブラリ名と同名の無関係なPyPIパッケージがヒットし、mysql-pythonのビルドエラーで失敗するため）

     sed -i '/^wave/d' requirements.txt

1. 依存関係インストール

   uv pip install -r requirements.txt

1. API_URLをサーバー機のIPに書き換え（gguf_orpheus.py 冒頭、コマンドライン引数化されていないため直接編集が必要）

   API_URL = "http://<Windows機IP>:1234/v1/completions"

3. モデルをロード（リモートから）†

curl http://<Windows機IP>:1234/api/v1/models/load \
  -H "Content-Type: application/json" \
  -d '{"model": "<手順1で確認した実際のID>"}'

• 成功すると "status": "loaded" が返る
• JITローディング対応のため省略可能な場合もあるが、確実性のため明示ロード推奨

4. 音声生成†

python gguf_orpheus.py --text "Hello, this is a test" --voice tara --output test.wav

• 利用可能な声: tara, leah, jess, leo, dan, mia, zac, zoe（tara推奨）
• 感情タグ: <laugh> <chuckle> <sigh> <cough> <sniffle> <groan> <yawn> <gasp>
• 声一覧確認: python gguf_orpheus.py --list-voices