VCClient-CLI は VCClient (w-okada/voice-changer) をバックエンドとして使用する RVC 音声変換 CLI ツールです。
CLI であるため、外部から SSH で RVC を実行することができます。
入出力ではローカルファイル・ネットワークを自由にルーティングできます。 このルーティングにはシステムの FFmpeg を利用することもでき、これにより SRT や RTMP などネットワークから直接音声を入力して音声変換を実行できます。
入出力は以下に対応しています:
- WAV ファイル
- オーディオデバイス
- FFmpeg
- SRT, RTMP, HTTP などのネットワークプロトコル
- Ogg/Opus on UDP (FFmpeg ラッパー)
- Discord Bot
Python 3.10.x が必要です。
# w-okada/voice-changer をサブモジュールとしてクローン
git submodule update --init --depth 1 --single-branch src/vcclient
# 依存関係をインストール
pip install -e .
# CUDA 12.1 で GPU 推論する場合
pip install -e . --extra-index-url https://download.pytorch.org/whl/cu121ヘルプを表示:
python src/main.pyつくよみちゃん RVC (モデル ID 0) を使用して、GPU 0 でローカルファイル awesome_input_audio.wav を変換し converted_awesome_audio.wav に保存する例:
python src/main.py \
--model 0 \
--gpu 0 \
--input-file awesome_input_audio.wav \
--output-file converted_awesome_audio.wavTune 6 (ピッチを3音上げる) に設定し、SRT プロトコルを使用してローカルファイル awesome_input_audio.wav を srt://localhost:1234 に Caller モードとして出力する例:
python src/main.py \
--model 0 \
--tune 6 \
--gpu 0 \
--input-type ffmpeg \
--input-url srt://localhost:1234?mode=caller \
--input-sample-rate 44100 \
--output-type ffmpeg \
--output-url srt://localhost:1234?mode=caller接続されているマイクから音声を取得し、Discord のボイスチャンネルに出力する例:
python src/main.py \
--model 0 \
--gpu 0 \
--input-type device \
--input-device "Microphone (Realtek High Definition Audio)" \
--output-type discord \
--discord-token DISCORD_TOKEN_HERE \
--discord-channel DISCORD_VOICE_CHANNEL_ID_HEREUDP で Ogg/Opus 音声を受信し、低遅延で変換する例:
python src/main.py \
--model 0 \
--gpu 0 \
--input-type ogg_opus \
--input-port 20012 \
--input-sample-rate 48000FFmpeg で任意のプロトコル入力を使い、カスタムオプションを指定する例:
python src/main.py \
--model 0 \
--gpu 0 \
--input-type ffmpeg \
--input-url udp://0.0.0.0:20012 \
--input-sample-rate 48000 \
--input-ffmpeg-args "-f ogg -c:a libopus -analyzeduration 0 -probesize 32"VCClient 付属の初期サンプルモデルをダウンロードしたい場合、--enable-downloading-models フラグを使用してください。
このフラグを付けていても、すでにサンプルモデルが存在する場合はダウンロードされません。
python src/main.py --enable-downloading-modelsWarning
このツールに関する問題は、VCClient のリポジトリではなく、こちらのリポジトリで報告してください。
$ uv pip install -e . --extra-index-url https://download.pytorch.org/whl/cu130
× No solution found when resolving dependencies:
╰─▶ Because there is no version of torch==2.5.1 and vcclient-cli==0.1.0 depends on torch==2.5.1, we can conclude
that vcclient-cli==0.1.0 cannot be used.
And because only vcclient-cli==0.1.0 is available and you require vcclient-cli, we can conclude that your
requirements are unsatisfiable.
hint: `torch` was found on https://download.pytorch.org/whl/cu130, but not at the requested version (torch==2.5.1). A compatible version may be available on a subsequent index (e.g., https://pypi.org/simple). By default, uv will only consider versions that are published on the first index that contains a given package, to avoid dependency confusion attacks. If all indexes are equally trusted, use `--index-strategy unsafe-best-match` to consider all versions from all indexes, regardless of the order in which they were defined.
使用している torch のバージョンが CUDA 13.x に対応していません。uv では、download.pytorch.org から取得するよう指定した場合インストールを拒否します。
pip では CPU 推論を行う torch にフォールバックするようです（未確認）。
CUDA 12.x を使用してください。
動作確認ができた最後のバージョンは cu128-full です。
setuptools のバージョンをダウングレードしてください。
pip install setuptools==81.0.0SRT プロトコルを利用しており、Caller モードで動作している際、一度接続先から切断された後再接続した場合にもこのエラーが出ることがあります。その場合は Listener を再起動してください。
Listener モードに設定した OBS でこの問題が発生する場合、「非アクティブ時にファイルを閉じる」のチェックを無効化してみてください。
FutureWarning: torch.cuda.amp.autocast(args...) is deprecated. Please use torch.amp.autocast('cuda', args...) instead.
src\vcclient\server\voice_changer\RVC\pipeline\Pipeline.py:120: FutureWarning: `torch.cuda.amp.autocast(args...)` is deprecated. Please use `torch.amp.autocast('cuda', args...)` instead.
with autocast(enabled=self.isHalf):
この警告は VCClient のコード内で発生しているものであり、VCClient-CLI で修正する予定はありません。無視しても問題ありません。
- Windows 11, Python 3.10.19, GTX1650 (CUDA 12.1)
- Arch Linux, Python 3.10.20, NVIDIA TITAN X (Pascal) (CUDA 12.4)