1git clone https://github.com/ASLP-lab/MeanVC2.git
2cd MeanVC2
3
4conda create -n meanvc2 python=3.11 -y
5conda activate meanvc2
6
7pip install torch==2.5.1 torchaudio==2.5.1 --index-url https://download.pytorch.org/whl/cu121
8pip install -r requirements.txt
1python initialization.py --task preprocess # BN + SpkEmb extraction only
2python initialization.py --task train_120ms # preprocess + 120ms VC + vocoder
3python initialization.py --task train_40ms # preprocess + 40ms VC + vocoder
1# 120ms+40ms model (recommended for quality)
2python src/infer/infer_e2e.py \
3 --source-wav /path/to/source.wav \
4 --target-wav /path/to/target.wav \
5 --ckpt-path ckpts/pretrained_models/meanvc2_120ms_40ms.safetensors \
6 --model-config src/config/config_120ms_40ms.json \
7 --vocoder-ckpt-path ckpts/vocos/vocos.pt \
8 --chunk-size 12 --steps 3 \
9 --output-wav output.wav
10
11# 40ms+40ms model (lower latency)
12python src/infer/infer_e2e.py \
13 --source-wav /path/to/source.wav \
14 --target-wav /path/to/target.wav \
15 --ckpt-path ckpts/pretrained_models/meanvc2_40ms_40ms.safetensors \
16 --model-config src/config/config_40ms_40ms.json \
17 --vocoder-ckpt-path ckpts/vocos/vocos.pt \
18 --chunk-size 4 --steps 3 \
19 --output-wav output.wav
1cd runtime
2
3# File mode
4python run_rt.py --mode file --input in.wav --output out.wav --model 120ms
5
6# Microphone mode
7python run_rt.py --mode realtime --model 40ms
MeanVC2 is released under the
Apache License 2.0. This open-source license allows you to freely use, modify, and distribute the model, as long as you include the appropriate copyright notice and disclaimer.
MeanVC2 is designed for research and legitimate applications in voice conversion technology. Users must obtain proper consent from individuals whose voices are being converted or used as references. We strongly discourage malicious use including impersonation, fraud, or creating misleading audio content. Users are solely responsible for ensuring compliance with ethical standards and legal requirements.
1@article{ma2026meanvc2,
2 title={MeanVC2: Robust Low-Latency Streaming Zero-Shot Voice Conversion},
3 author={Ma, Guobin and Xia, Yuxuan and Jiang, Yuepeng and Guo, Dake and Xie, Hanke and Hu, Jingbin and Wang, Yanbo and Xie, Lei and Zhu, Pengcheng},
4 journal={arXiv preprint arXiv:2606.09050},
5 year={2026}
6}
For questions or collaborations, please contact:
guobin.ma@mail.nwpu.edu.cn