Model reference · open weights

Wan-Dancer

Video Wan-AI Image→video 1 build Open weights 6k dl/mo

Wan-Dancer is an open-weight video model from Wan-AI. Wan-Dancer-14B (BF16) weighs 85.6 GB; the smallest configuration that runs it is L40S 48 GB.

  • Wan-Dancer is a 14B parameter model developed by Wan-AI for generating minute-scale, coherent dance videos from music and reference images.
  • It uses a hierarchical framework that decouples global keyframe planning from local temporal refinement to ensure long-range coherence and rhythmic accuracy.
  • The model supports English and Chinese, is released under the Apache 2.0 license, and is available as Wan-AI/Wan-Dancer-14B.

Summary of the Wan-AI/Wan-Dancer-14B model card, 2026-10-01

What it is

Released byWan-AI
Released2026-07-10
VRAM85.6 GB for the weights

What it runs on

Memory and cards for Wan-Dancer-14B (BF16)

85.6 GBweights, file size
34.5 GBbiggest part
537 MBruntime overhead
CardWeightsMemory
RTX 3060 12 GB … RTX 5090 32 GBdoes not fit
L40S 48 GBfits (encoders offloaded)44.0 GB
A100 80 GBfits (encoders offloaded)78.2 GB
H100 80 GBfits (encoders offloaded)78.1 GB
RTX PRO 6000 Blackwell 96 GBtight93.8 GB
DGX Spark (GB10) 128 GB unifiedfits107 GB
H200 141 GBfits138 GB
B200 180 GBfits176 GB

From the model card

What Wan-AI says about Wan-Dancer

Read the model card

💜 Project &nbsp&nbsp | &nbsp&nbsp 🖥️ GitHub &nbsp&nbsp | &nbsp&nbsp🤖 MS Space&nbsp&nbsp | &nbsp&nbsp🤖 MS Model&nbsp&nbsp | &nbsp&nbsp🤗 HF Model&nbsp&nbsp | &nbsp&nbsp 📑 Paper &nbsp&nbsp

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

🔥 Latest News!!

📑 Todo List

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

Run Wan-Dancer

Installation

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
Model Download
ModelsDownload LinksDescription
Wan-Dancer-14B🤗 Huggingface 🤖 ModelScopeMusic-to-Dance

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
Run 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.

1. 🎬 Generate Global Keyframe Video

Run the global stage script:

cd Wan-Dancer
./gen_video_global.sh
🔧 Important Parameters
ParameterDescription
seedRandom 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.txtK-Pop Dance: gen_video/prompt/kpop_global.txtStreet Dance: gen_video/prompt/街舞_global.txtTap Dance: gen_video/prompt/踢踏舞_global.txtLatin 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).
🌰 Examples
Dance GenresParameterGenerated Global Video
Chinese Classical Danceseed=0image_path='gen_video/ref_image/1001.jpg'prompt_path='gen_video/prompt/古典舞_global.txt'music_path='gen_video/music/ChineseClassicDance.WAV'num_inference_steps=48cfg_scale=5
Street Danceseed=0image_path='gen_video/ref_image/2001.jpg'prompt_path='gen_video/prompt/街舞_global.txt'music_path='gen_video/music/StreetDance.WAV'num_inference_steps=48cfg_scale=5
K-Pop Danceseed=0image_path='gen_video/ref_image/3001.jpg'prompt_path='gen_video/prompt/kpop_global.txt'music_path='gen_video/music_suno/3001.WAV'num_inference_steps=48cfg_scale=5
Latin Danceseed=0image_path='gen_video/ref_image/4001.jpg'prompt_path='gen_video/prompt/拉丁舞_global.txt'music_path='gen_video/music/LatinDance.WAV'num_inference_steps=48cfg_scale=5
Tap Danceseed=0image_path='gen_video/ref_image/5001.jpg'prompt_path='gen_video/prompt/踢踏舞_global.txt'music_path='gen_video/music/TapDance.wav'num_inference_steps=48cfg_scale=5
2. 🎥 Generate Final High-Resolution Video

Run the local refinement stage:

cd Wan-Dancer
./gen_video_local.sh
🔧 Additional Required Parameters
ParameterDescription
global_video_pathPath to the global video generated in Step 1. Required for local refinement.
prompt_pathPath to prompt file (defines dance style).Available styles:Chinese Classic Dance: gen_video/prompt/古典舞_local.txtK-Pop Dance: gen_video/prompt/kpop_local.txtStreet Dance: `gen_video/prompt/

Quoted from the model card on Hugging Face. The full card is behind the Hugging Face link above.

Running it yourself

Run it on a rented GPU

Rent a machine by the hour. ComfyUI is installed on it. Open ComfyUI through the tunnel and load the workflow from the model's card on Hugging Face; choose this model's file in its loader.

# on your rented machine (the ssh line is on its page in the console)
# get REPO FILE FOLDER: one file into /workspace/models/FOLDER, where ComfyUI loads it from
get() { hf download "$1" "$2" --local-dir /workspace/hf-files && mkdir -p "/workspace/models/$3" && mv "/workspace/hf-files/$2" "/workspace/models/$3/$4"; }

# the model (32.1 GB)
get Wan-AI/Wan-Dancer-14B global_model.safetensors diffusion_models

start-comfyui
Renting a GPU: connect, tunnels, ComfyUI
# on your computer, in a second terminal: ComfyUI in your browser at http://localhost:8188
# HOST and PORT are your machine's, from its page in the console
ssh -L 8188:localhost:8188 dev@HOST -p PORT
© 2026 AxForge · EU-hosted AI infrastructure Pricing Docs Trust Privacy Terms