Skip to content

Wan-Video /Wan-Animate-2

Animated clips from one character photo and a driving video
Model toolingApache-2.0English README
Stars
331
30 days
0
Last push
1 month ago

About Wan-Animate-2

Wan-Animate-2 turns a character photo and a driving video into an animated clip. It skips the usual motion extractor, so the model generates motion itself. A text prompt can also change the camera angle away from the driving footage. It wants 8 A800 GPUs, and your prompt should be a Chinese image caption.

Best for: Teams with a multi-GPU server who want to animate a fixed character using motion from another clip.

What it does

  • Animates a reference character using motion from a driving video
  • Skips the motion extractor; motion is generated inside the model
  • Changes the output camera angle with a text prompt
  • Runs a distilled checkpoint in 10 steps with no extra guidance
  • Includes a Gradio demo you can run on your own machine
  • Works with Diffusers (WanAnimate2Pipeline) and DiffSynth-Studio

Quickstart

Rewritten from the README. Check the repo for the latest steps.

  1. 1
    Clone the repo with its submodules: the command below
    git clone --recursive https://github.com/Wan-Video/Wan-Animate-2.git
  2. 2
    Make a Python 3.11 environment and install PyTorch: the command below, then the next command
    conda create -n wan_animate_2 python==3.11 -y
    pip install torch==2.7.0 torchvision==0.22.0 torchaudio==2.7.0 --index-url https://download.pytorch.org/whl/cu126
  3. 3
    Install the rest: the command below, the next command, pip install -e .
    pip install -r requirements.txt
    pip install flash-attn --no-build-isolation
  4. 4
    Download the weights: the command below
    huggingface-cli download Wan-AI/Wan2.2-Animate-2-14B --local-dir ./ckpts/
  5. 5
    Write a Chinese caption for your reference image with an LLM, then cd infer and run the command below
    python wan_animate_2_demo.py --prompt "..." --refer-img-file ../examples/demo1/reference.png --refer-video-file ../examples/demo1/template.mp4 --config ./wan_animate_2.yaml
  6. 6
    Or start the local demo: the command below
    python wan_animate_2_gradio.py

Models and languages

Models it works with

  • Wan-Animate-2 Base
  • Wan-Animate-2 Distillation
  • Wan-Animate-2-Lite
  • Qwen3.7-Plus

Interface and docs

  • English

Alternatives

Other model tooling projects people compare with Wan-Animate-2.

Wan-Video

Wan2.2

Open video models for text, image, speech and character animation

Model tooling
  • Wan 2.2-T2V-A14B
  • Wan 2.2-I2V-A14B
  • Wan 2.2-TI2V-5B
  • +5
18k GitHub stars+5/30d11 days agoApache-2.0

SkyworkAI

SkyReels-V2

Makes long, even endless clips with open SkyReels-V2 video models

Model tooling
  • SkyReels-V2-DF-14B-540P
  • SkyReels-V2-DF-14B-720P
  • SkyReels-V2-DF-1.3B-540P
  • +5
7.6k GitHub stars-2/30d8 months agoCustom license

Lightricks

LTX-2

Open audio-video model you run yourself on a CUDA GPU

Model tooling
  • LTX-2.5
  • LTX-2.3
  • Gemma 4 12B
  • +1
9.6k GitHub stars+2/30d2 days agoCustom license

deepbeepmeep

Wan2GP

Desktop app that runs open video, image and audio models on your own PC

Model tooling
  • Wan 2.1/2.2
  • MiniMax H3
  • LTX-2/2.3/2.5
  • +7
9.8k GitHub stars+32/30dyesterdayCustom license

Featured on OpenMicroDrama

Do you maintain Wan-Animate-2? Add this badge to your README so English speakers can find our write-up.

Featured on OpenMicroDrama
markdown
[![Featured on OpenMicroDrama](https://openmicrodrama.com/badges/featured.svg)](https://openmicrodrama.com/projects/wan-video-wan-animate-2)

The badge links to this page. Want your description changed? Email support@openmicrodrama.com.

Reviewed Oct 1, 2026. We write these descriptions ourselves. The repo's own docs are the final word.