Views
No views yet
1conda create -n flashhead python=3.10
2conda activate flashheadpip install torch==2.7.1 torchvision==0.22.1 --index-url https://download.pytorch.org/whl/cu128pip install -r requirements.txt1pip install ninja
2pip install flash_attn==2.8.0.post2 --no-build-isolationpip install sageattention==2.2.0 --no-build-isolation1# Ubuntu / Debian
2apt-get install ffmpeg
3# CentOS / RHEL
4yum install ffmpeg ffmpeg-devel1# Conda (no root required)
2conda install -c conda-forge ffmpeg==71# If you are in china mainland, run this first: export HF_ENDPOINT=https://hf-mirror.com
2pip install "huggingface_hub[cli]"
3huggingface-cli download Soul-AILab/SoulX-FlashHead-1_3B --local-dir ./models/SoulX-FlashHead-1_3B
4huggingface-cli download facebook/wav2vec2-base-960h --local-dir ./models/wav2vec2-base-960h1# Infer with [Pro-Model] on single GPU
2bash inference_script_single_gpu_pro.sh
3
4
5# Infer with [Pro-Model] on multy GPUs
6bash inference_script_multi_gpu_pro.sh
7# Real-time inference speed of Pro-Model can only be supported on two RTX-5090 with SageAttention.
8
9
10# Infer with [Lite-Model] on single GPU
11bash inference_script_single_gpu_lite.sh
12# Real-time inference speed can be supported on single RTX-4090 (up to 3 concurrent).
![]() Real-time Online Experience (SoulApp 实时在线体验) |
![]() Join WeChat Group (加入微信技术群) |
![]() Download SoulApp & Join Group (下载SoulApp加入群组) |
@misc{yu2026soulxflashheadoracleguidedgenerationinfinite,
title={SoulX-FlashHead: Oracle-guided Generation of Infinite Real-time Streaming Talking Heads},
author={Tan Yu and Qian Qiao and Le Shen and Ke Zhou and Jincheng Hu and Dian Sheng and Bo Hu and Haoming Qin and Jun Gao and Changhai Zhou and Shunshun Yin and Siyuan Liu},
year={2026},
eprint={2602.07449},
archivePrefix={arXiv},
primaryClass={cs.CV},
url={https://arxiv.org/abs/2602.07449},
}[!TIP] If you find our work useful, please also consider starring the original repositories of these foundational methods.