README.md

May 21, 2026 ยท View on GitHub

SoulX-FlashTalk: Real-Time Infinite Streaming of Audio-Driven Avatars via Self-Correcting Bidirectional Distillation

Le Shen*, Qian Qiao*, Tan Yu*, Ke Zhou, Tianhang Yu, Yu Zhan, Zhenjie Wang, Dingcheng Zhen, Ming Tao, Shunshun Yin, Siyuan Liu โœ‰

*Equal Contribution โœ‰Corresponding Author

HF spaceย 

๐Ÿ”ฅ News

๐Ÿคซ Coming soon

A 4-GPU real-time version of SoulX-FlashTalk.

๐Ÿ“‘ Todo List

  • Technical report
  • Project Page
  • Inference code
  • Checkpoint release
  • Online demo

๐Ÿ“ข Live Streaming & Video Podcast

๐ŸŽฌ Online Demos

๐ŸŒฐ Examples

๐Ÿ“– Quickstart

๐Ÿ”ง Installation

1. Create a Conda environment

conda create -n flashtalk python=3.10
conda activate flashtalk

2. Install PyTorch on CUDA

pip install torch==2.7.1 torchvision==0.22.1 --index-url https://download.pytorch.org/whl/cu128

3. Install other dependencies

pip install -r requirements.txt

4. Flash-attention installation:

pip install ninja
pip install flash_attn==2.8.0.post2 --no-build-isolation

5. FFmpeg installation

# Ubuntu / Debian
apt-get install ffmpeg
# CentOS / RHEL
yum install ffmpeg ffmpeg-devel

or

# Conda (no root required) 
conda install -c conda-forge ffmpeg==7

๐Ÿค— Model download

Model ComponentDescriptionLink
SoulX-FlashTalk-14BOur 14b model๐Ÿค— Huggingface
chinese-wav2vec2-basechinese-wav2vec2-base๐Ÿค— Huggingface
# If you are in china mainland, run this first: export HF_ENDPOINT=https://hf-mirror.com
pip install "huggingface_hub[cli]"
huggingface-cli download Soul-AILab/SoulX-FlashTalk-14B --local-dir ./models/SoulX-FlashTalk-14B
huggingface-cli download TencentGameMate/chinese-wav2vec2-base --local-dir ./models/chinese-wav2vec2-base

๐Ÿš€ Inference

# Infer on single GPU
# Requires more than 64G of VRAM. Use --cpu_offload to reduce VRAM usage to 40G.
bash inference_script_single_gpu.sh

# Infer on multy GPUs
# Real-time inference speed can only be supported on 8xH800 or higher graphics cards
bash inference_script_multi_gpu.sh

๐Ÿ‘‹ Online Demo

Coming Soon!

๐Ÿ“ง Contact Us

If you are interested in leaving a message to our work, feel free to email le.shen@mail.dhu.edu.cn or qiaoqian@soulapp.cn or yutan@soulapp.cn or zhouke@soulapp.cn or liusiyuan@soulapp.cn

Due to Group 1 reaching its capacity, we have opened a new WeChat group. Additionally, we represent SoulApp and warmly welcome everyone to download the app and join our Soul group for further technical discussions and updates!

WeChat Group QR Code
Join WeChat Group
(ๅŠ ๅ…ฅๅพฎไฟกๆŠ€ๆœฏ็พค)
Soul App Group QR Code
Download SoulApp & Join Group
(ไธ‹่ฝฝSoulAppๅŠ ๅ…ฅ็พค็ป„)

๐Ÿ“š Citation

If you find our work useful in your research, please consider citing:

@misc{shen2025soulxflashtalk,
  title = {{SoulX-FlashTalk}: Real-Time Infinite Streaming of Audio-Driven Avatars via Self-Correcting Bidirectional Distillation},
  author = {Shen, Le and Qiao, Qian and Yu, Tan and Zhou, Ke and Yu, Tianhang and Zhan, Yu and Wang, Zhenjie and Tao, Ming and Yin, Shunshun and Liu, Siyuan},
  year = {2025},
  eprint = {2512.23379},
  archivePrefix = {arXiv},
  primaryClass = {cs.CV},
  doi = {10.48550/arXiv.2512.23379},
  url = {https://arxiv.org/abs/2512.23379}
}

๐Ÿ™‡ Acknowledgement

Tip

If you find our work useful, please also consider starring the original repositories of these foundational methods.

๐Ÿ’ก Star History

Star History Chart