Wan-AI/Wan-Dancer-14B · Hugging Face

Source: https://huggingface.co/Wan-AI/Wan-Dancer-14B

💜Wan-Dancer｜ 🖥️GitHub| 🤗Hugging Face| 🤖ModelScope| 📑Paper

Wan-Dancer: A Hierarchical Framework for Minute-scale Coherent Music-to-Dance Generation

https://huggingface.co/Wan-AI/Wan-Dancer-14B#%F0%9F%94%A5-latest-news🔥 Latest News!!

• July 13, 2026: 💃 We introduce**Wan-Dancer**, a method can generate long-duration, high-quality, rhythmic dance videos from music with global structure and temporal continuity. We released themodel weightsandinference code. And now you can try it onModelScope StudioorHuggingFace Space!

https://huggingface.co/Wan-AI/Wan-Dancer-14B#%F0%9F%93%91-todo-list📑 Todo List

• Wan-Dancer Music-to-Dance- Inference code of Wan-Dancer - Checkpoints of Wan-Dancer - ComfyUI integration

https://huggingface.co/Wan-AI/Wan-Dancer-14B#run-wan-dancerRun Wan-Dancer

https://huggingface.co/Wan-AI/Wan-Dancer-14B#installationInstallation

Clone the repo:

git clone https://github.com/Wan-Video/Wan-Dancer.git
cd Wan-Dancer

Install dependencies:

python -m venv venv_wan_dancer
source venv_wan_dancer/bin/activate

# Install package in editable mode
pip install -e .

# Install additional and specific versions dependencies
pip install moviepy loguru librosa
pip install https://mirrors.aliyun.com/pytorch-wheels/cu124/torch-2.6.0+cu124-cp310-cp310-linux_x86_64.whl
pip install torchvision==0.21.0
pip install diffusers==0.34.0
pip install yunchang==0.5.0
pip install flash_attn==2.6.3
pip install xfuser==0.4.0
pip install transformers==4.46.2

https://huggingface.co/Wan-AI/Wan-Dancer-14B#model-downloadModel Download

Download models using huggingface-cli:

pip install "huggingface_hub[cli]"
huggingface-cli download Wan-AI/Wan-Dancer-14B --local-dir ./Wan-Dancer-14B

Download models using modelscope-cli:

pip install modelscope
modelscope download Wan-AI/Wan-Dancer-14B --local_dir ./Wan-Dancer-14B

https://huggingface.co/Wan-AI/Wan-Dancer-14B#run-wan-dancer-1Run Wan-Dancer

Wan-Dancer can generate long-duration, high-quality, rhythmic dance videos from music with global structure and temporal continuity. Our method decouples the process into global keyframe planning and local temporal refinement, leveraging full-track musical context to ensure long-range coherence.

https://huggingface.co/Wan-AI/Wan-Dancer-14B#1-%F0%9F%8E%AC-generate-global-keyframe-video1. 🎬 Generate Global Keyframe Video

Run the global stage script:

cd Wan-Dancer
./gen_video_global.sh

https://huggingface.co/Wan-AI/Wan-Dancer-14B#%F0%9F%94%A7-important-parameters🔧 Important Parameters

ParameterDescriptionseedRandom seed for reproducibility.image\_pathPath to reference image. Example:gen\_video/ref\_image/1001\.jpg``prompt\_pathPath to prompt file (defines dance style). Available styles:- Chinese Classic Dance:gen\_video/prompt/古典舞\_global\.txt

• K-Pop Dance:gen\_video/prompt/kpop\_global\.txt
• Street Dance:gen\_video/prompt/街舞\_global\.txt
• Tap Dance:gen\_video/prompt/踢踏舞\_global\.txt
• Latin Dance:gen\_video/prompt/拉丁舞\_global\.txt

music\_pathPath to input music file. Example:gen\_video/music/ChineseClassicDance\.WAV``output\_folderOutput directory for generated video.timestampTimestamp identifier for output files.num\_inference\_stepsNumber of diffusion inference steps (e.g., 48).

https://huggingface.co/Wan-AI/Wan-Dancer-14B#%F0%9F%8C%B0-examples🌰 Examples

https://huggingface.co/Wan-AI/Wan-Dancer-14B#2-%F0%9F%8E%A5-generate-final-high-resolution-video2. 🎥 Generate Final High-Resolution Video

Run the local refinement stage:

cd Wan-Dancer
./gen_video_local.sh

https://huggingface.co/Wan-AI/Wan-Dancer-14B#%F0%9F%94%A7-additional-required-parameters🔧 Additional Required Parameters

ParameterDescriptionglobal\_video\_pathPath to the global video generated in Step 1.Requiredfor local refinement.prompt\_pathPath to prompt file (defines dance style). Available styles:- Chinese Classic Dance:gen\_video/prompt/古典舞\_local\.txt

• K-Pop Dance:gen\_video/prompt/kpop\_local\.txt
• Street Dance:gen\_video/prompt/街舞\_local\.txt
• Tap Dance:gen\_video/prompt/踢踏舞\_local\.txt
• Latin Dance:gen\_video/prompt/拉丁舞\_local\.txt

✅ All other parameters (seed,image\_path, etc.) are identical to Step 1.

https://huggingface.co/Wan-AI/Wan-Dancer-14B#%F0%9F%8C%B0-examples-1🌰 Examples

**Note:**Thenum\_inference\_stepsshould be set to a larger value (e.g., 48) for longer time videos.

https://huggingface.co/Wan-AI/Wan-Dancer-14B#citationCitation

If you use this code or framework in your research, please cite:

@article{wan-dancer-2026,
  title={Wan-Dancer: A Hierarchical Framework for Minute-scale Coherent Music-to-Dance Generation},
  author={Mingyang Huang, Peng Zhang, Li Hu, Guangyuan Wang, Bang Zhang},
  website={https://humanaigc.github.io/wan-dancer/},
  url={https://arxiv.org/abs/2607.09581},
  year={2026}
}

https://huggingface.co/Wan-AI/Wan-Dancer-14B#license-agreementLicense Agreement

This project is licensed under the Apache 2.0 License — see theLICENSEfile for details.

https://huggingface.co/Wan-AI/Wan-Dancer-14B#acknowledgementsAcknowledgements

This work builds upon and integrates components from the following open-source projects:

1. DiffSynth-Studio
2. Wan2.1