ASLP-lab / MeanVC2

huggingface.co
Total runs: 0
24-hour runs: 0
7-day runs: 0
30-day runs: 0
Model's Last Updated: August 03 2026
audio-to-audio

Introduction of MeanVC2

Model Details of MeanVC2

MeanVC2: Robust Low-Latency Streaming Zero-Shot Voice Conversion

MeanVC2 is a robust, low-latency streaming zero-shot voice conversion (VC) system built upon the diffusion-based conditional flow matching (CFM) framework. By introducing Future-Receptive Chunking (FRC) and a Universal Timbre Token Encoder (UTTE) , MeanVC2 achieves high-fidelity voice conversion with an end-to-end pipeline latency of only 110 ms while maintaining superior speaker similarity and audio naturalness even with a 40 ms chunk size .

img

✨ Key Features
  • 🚀 Ultra-Low Latency Streaming : 110 ms end-to-end first-packet latency with 40 ms chunk size; full pipeline RTF < 0.633 on single CPU core.
  • ⚡ Single-Step Generation : Mean flows + 1-NFE ODE solving for high-quality mel-spectrogram synthesis.
  • 🎯 Zero-Shot Capability : Convert to any unseen target speaker without re-training, robust under low-quality reference audio.
  • 💾 Lightweight : Only 18M parameters — far smaller than competing streaming VC systems.
  • 🔊 High Fidelity : Future-Receptive Chunking (FRC) with Universal Timbre Token Encoder (UTTE) for pronunciation-aware timbre modeling.
📁 Model Checkpoints

This repository hosts all pretrained models for MeanVC2:

Voice Conversion Models
File Description
meanvc2_120ms_40ms.safetensors 120ms chunk + 40ms future (recommended for quality)
meanvc2_40ms_40ms.safetensors 40ms chunk + 40ms future (lower latency)
Vocoder (JIT)
File Description
vocos.pt Vocos JIT-traced vocoder
ASR Encoder (Fast-U2++ JIT)
File Description
fastu2pp_80ms.pt 80ms chunk JIT model (11-frame window, stride=8)
fastu2pp_160ms.pt 160ms chunk JIT model (19-frame window, stride=16)
💻 Quick Start
1. Clone and Install
git clone https://github.com/ASLP-lab/MeanVC2.git
cd MeanVC2

conda create -n meanvc2 python=3.11 -y
conda activate meanvc2

pip install torch==2.5.1 torchaudio==2.5.1 --index-url https://download.pytorch.org/whl/cu121
pip install -r requirements.txt
2. Download Pretrained Models
python initialization.py --task all

Or download selectively:

python initialization.py --task preprocess   # BN + SpkEmb extraction only
python initialization.py --task train_120ms  # preprocess + 120ms VC + vocoder
python initialization.py --task train_40ms   # preprocess + 40ms VC + vocoder
3. End-to-End Voice Conversion

No pre-extracted features needed — input two wavs, output converted audio:

# 120ms+40ms model (recommended for quality)
python src/infer/infer_e2e.py \
    --source-wav /path/to/source.wav \
    --target-wav /path/to/target.wav \
    --ckpt-path ckpts/pretrained_models/meanvc2_120ms_40ms.safetensors \
    --model-config src/config/config_120ms_40ms.json \
    --vocoder-ckpt-path ckpts/vocos/vocos.pt \
    --chunk-size 12 --steps 3 \
    --output-wav output.wav

# 40ms+40ms model (lower latency)
python src/infer/infer_e2e.py \
    --source-wav /path/to/source.wav \
    --target-wav /path/to/target.wav \
    --ckpt-path ckpts/pretrained_models/meanvc2_40ms_40ms.safetensors \
    --model-config src/config/config_40ms_40ms.json \
    --vocoder-ckpt-path ckpts/vocos/vocos.pt \
    --chunk-size 4 --steps 3 \
    --output-wav output.wav
4. Real-Time Streaming
cd runtime

# File mode
python run_rt.py --mode file --input in.wav --output out.wav --model 120ms

# Microphone mode
python run_rt.py --mode realtime --model 40ms
🏗️ Model Architecture
Component Description
Streaming ASR Encoder Fast-U2++ (WeNet) extracts bottleneck features (BNFs) from source waveform
Speaker Encoder ECAPA-TDNN + WavLM upstream extracts global speaker embedding from reference audio
Universal Timbre Token Encoder (UTTE) Transforms speaker embedding into K key-value UTT pairs; BNFs serve as queries in cross-attention for fine-grained, pronunciation-aware timbre cues
DiT-based CFM Decoder 4-layer DiT (hidden dim 512, 2 heads) with Future-Receptive Chunking (FRC); trained with mean flows objective for 1-NFE mel-spectrogram generation
Vocoder Vocos converts mel-spectrograms to 16 kHz high-fidelity speech waveforms

Total parameters : ~18M

📜 License & Disclaimer

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.

📄 Citation

If you find our work helpful, please cite:

@article{ma2026meanvc2,
  title={MeanVC2: Robust Low-Latency Streaming Zero-Shot Voice Conversion},
  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},
  journal={arXiv preprint arXiv:2606.09050},
  year={2026}
}
📧 Contact

For questions or collaborations, please contact: [email protected]

Runs of ASLP-lab MeanVC2 on huggingface.co

0
Total runs
0
24-hour runs
0
3-day runs
0
7-day runs
0
30-day runs

More Information About MeanVC2 huggingface.co Model

More MeanVC2 license Visit here:

https://choosealicense.com/licenses/apache-2.0

MeanVC2 huggingface.co

MeanVC2 huggingface.co is an AI model on huggingface.co that provides MeanVC2's model effect (), which can be used instantly with this ASLP-lab MeanVC2 model. huggingface.co supports a free trial of the MeanVC2 model, and also provides paid use of the MeanVC2. Support call MeanVC2 model through api, including Node.js, Python, http.

ASLP-lab MeanVC2 online free

MeanVC2 huggingface.co is an online trial and call api platform, which integrates MeanVC2's modeling effects, including api services, and provides a free online trial of MeanVC2, you can try MeanVC2 online for free by clicking the link below.

ASLP-lab MeanVC2 online free url in huggingface.co:

https://huggingface.co/ASLP-lab/MeanVC2

MeanVC2 install

MeanVC2 is an open source model from GitHub that offers a free installation service, and any user can find MeanVC2 on GitHub to install. At the same time, huggingface.co provides the effect of MeanVC2 install, users can directly use MeanVC2 installed effect in huggingface.co for debugging and trial. It also supports api for free installation.

MeanVC2 install url in huggingface.co:

https://huggingface.co/ASLP-lab/MeanVC2

Url of MeanVC2

Provider of MeanVC2 huggingface.co

ASLP-lab
ORGANIZATIONS

Other API from ASLP-lab

huggingface.co

Total runs: 1.6K
Run Growth: 59
Growth Rate: 3.81%
Updated:November 09 2025
huggingface.co

Total runs: 461
Run Growth: 112
Growth Rate: 24.30%
Updated:May 14 2026
huggingface.co

Total runs: 114
Run Growth: 3
Growth Rate: 2.63%
Updated:October 11 2025
huggingface.co

Total runs: 63
Run Growth: 27
Growth Rate: 42.86%
Updated:December 09 2025
huggingface.co

Total runs: 28
Run Growth: -55
Growth Rate: -196.43%
Updated:June 16 2026
huggingface.co

Total runs: 23
Run Growth: -1
Growth Rate: -4.35%
Updated:October 16 2025
huggingface.co

Total runs: 21
Run Growth: 8
Growth Rate: 38.10%
Updated:November 03 2025
huggingface.co

Total runs: 0
Run Growth: 0
Growth Rate: 0.00%
Updated:February 24 2025
huggingface.co

Total runs: 0
Run Growth: 0
Growth Rate: 0.00%
Updated:February 17 2025
huggingface.co

Total runs: 0
Run Growth: 0
Growth Rate: 0.00%
Updated:September 24 2025
huggingface.co

Total runs: 0
Run Growth: 0
Growth Rate: 0.00%
Updated:November 29 2025
huggingface.co

Total runs: 0
Run Growth: 0
Growth Rate: 0.00%
Updated:March 17 2026
huggingface.co

Total runs: 0
Run Growth: 0
Growth Rate: 0.00%
Updated:March 14 2025
huggingface.co

Total runs: 0
Run Growth: 0
Growth Rate: 0.00%
Updated:September 11 2026
huggingface.co

Total runs: 0
Run Growth: 0
Growth Rate: 0.00%
Updated:March 03 2025
huggingface.co

Total runs: 0
Run Growth: 0
Growth Rate: 0.00%
Updated:April 09 2026
huggingface.co

Total runs: 0
Run Growth: 0
Growth Rate: 0.00%
Updated:September 12 2025