Wan-Dancer is a hierarchical framework that generates long-duration (over one minute), high-definition (720p/30fps), rhythmically synchronized dance videos directly from music by decoupling the process into global keyframe planning and local temporal refinement.

Stars

378

7-day growth

No data

Forks

37

Open issues

1

License

Apache-2.0

Last updated

2026-07-17

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It overcomes the traditional 20-second duration barrier of diffusion models for music-to-dance generation, achieving minute-scale coherent videos with high temporal stability and supporting five distinct dance genres.

Who it is for

  • AI researchers focused on video generation and diffusion models
  • Dance content creators and music video producers
  • Multimedia developers integrating AI-generated dance into applications
  • Academic researchers studying long-form temporal consistency in generative models

Use cases

  • Automatically generating choreographed dance videos for any given music track
  • Prototyping dance sequences for live performances or game animations
  • Producing background dancing content for music streaming platforms
  • Assisting dance educators with visual demonstrations of different dance styles

Strengths

  • Achieves minute-scale (over 60 seconds) high-resolution dance video generation, surpassing prior diffusion model limits
  • Employs a hierarchical framework (global keyframe + local refinement) for long-range temporal coherence
  • Supports five dance genres (Chinese classical, K-Pop, street, tap, Latin) with both audio and text conditioning
  • Introduces optical-flow-based loss and dynamic frame rate adaptation to maintain motion continuity and detail

Considerations

  • Requires heavy computational resources (tested on 8 × NVIDIA A800 80GB GPUs) for inference
  • Two-stage pipeline (global then local) adds complexity and processing time
  • Dependency on specific software versions (CUDA 12.4, PyTorch 2.6, etc.) may hinder portability

README quick start


💃 Wan-Dancer

💜 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 

Generating long-duration, high-quality, rhythmic dance videos from music with global structure and temporal continuity


📄 Abstract

Generating long-duration, high-definition, and rhythmically synchronized dance videos directly from music remains a significant challenge, primarily due to the temporal constraints of current diffusion models, which typically fail beyond 20 seconds. Existing approaches, whether they rely on intermediate 3D skeletons or on end-to-end video synthesis, suffer from temporal drift, identity inconsistency, and repetitive motion patterns when extended to longer horizons. To address these limitations, we propose a novel hierarchical framework for minute-scale coherent music-to-dance generation. Our method decouples the process into global keyframe planning and local temporal refinement, leveraging full-track musical context to ensure long-range coherence. Key innovations include dynamic frame rate adaptation via time-mapped RoPE embeddings for precise alignment, an optical-flow-based loss function to enhance motion continuity, and motion-speed control to preserve high-fidelity details during rapid movements. Extensive experiments demonstrate that our framework surpasses the conventional duration barrier, generating stable, 720p/30fps videos exceeding one minute with superior temporal stability. Furthermore, the model exhibits robust versatility across five distinct dance genres, conditioned on both audio and textual prompts, establishing a new state-of-the-art in coherent, long-form dance video synthesis.


⚙️ Environment Setup

We tested the code on:

  • OS: Ubuntu 22.04
  • Hardware: 8 × NVIDIA A800 80GB GPUs
  • Python: 3.10.14

✅ Install Dependencies

cd /path/to/Wan-Dancer
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

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482