Xu-Shihao/wespeaker

Research and Production Oriented Speaker Recognition Toolkit

WeSpeaker

Roadmap | Awesome Papers | Runtime (x86_gpu) | Python binding | Pretrained Models | Huggingface Demo

WeSpeaker mainly focuses on speaker embedding learning, with application to the speaker verification task. We support online feature extraction or loading pre-extracted features in kaldi-format.

Installation

• Clone this repo

git clone https://github.com/wenet-e2e/wespeaker.git

• Create conda env: pytorch version >= 1.10.0 is required !!!

conda create -n wespeaker python=3.9
conda activate wespeaker
conda install pytorch=1.10.1 torchaudio=0.10.1 cudatoolkit=11.3 -c pytorch -c conda-forge
pip install -r requirements.txt

• If you just want to use the pretrained model, try the python binding!

pip3 install wespeakerruntime

Recipes

• VoxCeleb: Speaker Verification recipe on the VoxCeleb dataset
  • 🔥 We support a two-convariance based PLDA, although the performance is still inferior to cosine, check it out!
  • 🔥 UPDATE 2022.10.31: We support deep r-vector up to the 293-layer version! Achiving 0.447%/0.043 EER/mindcf on vox1-O-clean test set
  • 🔥 UPDATE 2022.7.19: We apply the same setups as the CNCeleb recipe, and obtain SOTA performance considering the open-source systems
  • 🔥 EER/minDCF on vox1-O-clean test set are 0.723%/0.069 (ResNet34) and 0.728%/0.099 (ECAPA_TDNN_GLOB_c1024), after LM fine-tuning and AS-Norm
• CNCeleb: Speaker Verification recipe on the CnCeleb dataset
  • 🔥 UPDATE 2022.10.31: 221-layer ResNet achieves 5.655%/0.330 EER/minDCF
  • 🔥 UPDATE 2022.7.12: We are migrating the winner system of CNSRC 2022 report slides
  • 🔥 EER/minDCF reduction from 8.426%/0.487 to 6.492%/0.354 after large margin fine-tuning and AS-Norm
• VoxConverse: 🔥 UPDATE 2022.7.2: Diarization recipe on the VoxConverse dataset

Support List:

• Model (SOTA Models)
  • Standard X-vector
  • ResNet
  • ECAPA_TDNN
• Pooling Functions
  • TAP(mean) / TSDP(std) / TSTP(mean+std)
    • Comparison of mean/std pooling can be found in shuai_iscslp, anna_arxiv
  • Attentive Statistics Pooling (ASTP)
    • mainly for ECAPA_TDNN
• Criteria
  • Softmax
  • Sphere (A-Softmax)
  • Add_Margin (AM-Softmax)
  • Arc_Margin (AAM-Softmax)
• Scoring
  • Cosine
  • PLDA
  • Score Normalization (AS-Norm)
• Metric
  • EER
  • minDCF
• Online Augmentation
  • Noise && RIR
  • Speed Perturb
  • SpecAug
• Literature
  • Awesome Speaker Papers

Discussion

For Chinese users, you can scan the QR code on the left to follow our offical account of WeNet Community. We also created a WeChat group for better discussion and quicker response. Please scan the QR code on the right to join the chat group.

Citations

If you find wespeaker useful, please cite it as

@article{wang2022wespeaker,
  title={Wespeaker: A Research and Production oriented Speaker Embedding Learning Toolkit},
  author={Wang, Hongji and Liang, Chengdong and Wang, Shuai and Chen, Zhengyang and Zhang, Binbin and Xiang, Xu and Deng, Yanlei and Qian, Yanmin},
  journal={arXiv preprint arXiv:2210.17016},
  year={2022}
}

Looking for contributors

If you are interested to contribute, feel free to contact @wsstriving or @robin1001