> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Wan Animate 2: Motion Transfer

> Animate a still character using a driving video with Wan Animate 2, transferring motion directly from video frames without pose extraction or skeleton preprocessing

Wan Animate 2 is an end-to-end character animation framework from the Wan team that directly consumes driving videos in a redesigned Diffusion Transformer. It achieves high-fidelity motion generation and strong identity preservation by eliminating intermediate motion extractors: no pose extraction or skeleton preprocessing is needed.

The model also adds text-driven viewpoint control, decoupling the output camera perspective from the driving video. This lets you animate a still character using a driving video while controlling the camera independently, and even generate a fresh background from your text prompt.

<Tip>
  <Tabs>
    <Tab title="Local users">
      Make sure your ComfyUI is updated.

      * [Download ComfyUI](https://www.comfy.org/download)
      * [Update Guide](/installation/update_comfyui)

      Workflows in this guide can be found in the [Workflow Templates](/interface/features/template).
      If you can't find them in the template, your ComfyUI may be outdated.

      If nodes are missing when loading a workflow, possible reasons:

      1. You are not using the latest ComfyUI version (Nightly version)
      2. Some nodes failed to import at startup
    </Tab>

    <Tab title="Cloud users">
      * [Cloud](https://cloud.comfy.org) will update after ComfyUI stable release.

      So, if you find any core node missing in this document, it might be because the new core nodes have not yet been released in the latest stable version. Please wait for the next stable release.
    </Tab>
  </Tabs>
</Tip>

## Model Highlights

* **Direct motion transfer**: Animates a still character from a driving video without pose extraction or skeleton preprocessing
* **Identity preservation**: Keeps the reference character's identity, appearance, and details intact
* **Text-driven camera control**: Decouples output camera perspective from the driving video
* **Fresh backgrounds**: Generates a new background from your text prompt instead of copying the driving video's background
* **High-fidelity motion**: Replicates complex motions and expressions from the driving video

## Wan Animate 2 workflow

Animate a still character using a driving video, transferring motion directly from video frames. The output preserves the reference character's identity while generating a fresh background and camera movement from your text prompt.

<video controls className="w-full aspect-video" src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/video_wan_animate2.mp4" />

<CardGroup cols={2}>
  <Card title="Run on Comfy Cloud" icon="cloud" href="https://cloud.comfy.org/?template=video_wan_animate2&utm_source=docs&utm_medium=referral&utm_campaign=wan-animate-2">
    Open in Comfy Cloud
  </Card>

  <Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_wan_animate2.json">
    Download JSON or search "Wan Animate 2" in Template Library
  </Card>
</CardGroup>

**Input materials**

Upload these files to the matching nodes:

<CardGroup cols={2}>
  <Card title="Reference image" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_hair_mech_arms_ref.png">
    `LoadImage` node: pink\_hair\_mech\_arms\_ref.png (the character to animate)
  </Card>

  <Card title="Driving video" icon="video" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/street_dance_drive.mp4">
    `LoadVideo` node: street\_dance\_drive.mp4 (the motion source)
  </Card>
</CardGroup>

### Model downloads

This workflow uses the `wan_animate_2_int8_convrot.safetensors` diffusion model. The repository also ships BF16 and distilled variants; if you want to use those instead, change the model selection in the `UNETLoader` node. All files are available in the [Comfy-Org/Wan-Animate-2](https://huggingface.co/Comfy-Org/Wan-Animate-2) repository:

<CardGroup cols={2}>
  <Card title="Diffusion Model (INT8, required)" icon="download" href="https://huggingface.co/Comfy-Org/Wan-Animate-2/blob/main/diffusion_models/wan_animate_2_int8_convrot.safetensors">
    wan\_animate\_2\_int8\_convrot.safetensors: INT8 convrot quantized diffusion model used by this workflow
  </Card>

  <Card title="Diffusion Model (BF16, optional)" icon="download" href="https://huggingface.co/Comfy-Org/Wan-Animate-2/blob/main/diffusion_models/wan_animate_2_bf16.safetensors">
    wan\_animate\_2\_bf16.safetensors: Full-precision base model. Requires changing the UNETLoader model selection.
  </Card>

  <Card title="Diffusion Model (Distill INT8, optional)" icon="download" href="https://huggingface.co/Comfy-Org/Wan-Animate-2/blob/main/diffusion_models/wan_animate_2_distill_int8_convrot.safetensors">
    wan\_animate\_2\_distill\_int8\_convrot.safetensors: Distilled INT8 variant. Requires changing the UNETLoader model selection.
  </Card>

  <Card title="Diffusion Model (Distill BF16, optional)" icon="download" href="https://huggingface.co/Comfy-Org/Wan-Animate-2/blob/main/diffusion_models/wan_animate_2_distill_bf16.safetensors">
    wan\_animate\_2\_distill\_bf16.safetensors: Distilled BF16 variant. Requires changing the UNETLoader model selection.
  </Card>

  <Card title="LoRA" icon="download" href="https://huggingface.co/Comfy-Org/Wan-Animate-2/blob/main/loras/lightx2v_I2V_14B_480p_cfg_step_distill_rank64_bf16.safetensors">
    lightx2v\_I2V\_14B\_480p\_cfg\_step\_distill\_rank64\_bf16.safetensors: LightX2V acceleration LoRA
  </Card>

  <Card title="Text Encoder" icon="download" href="https://huggingface.co/Comfy-Org/Wan-Animate-2/blob/main/text_encoders/umt5_xxl_fp8_e4m3fn_scaled.safetensors">
    umt5\_xxl\_fp8\_e4m3fn\_scaled.safetensors: UMT5-XXL FP8 text encoder
  </Card>

  <Card title="CLIP Vision" icon="download" href="https://huggingface.co/Comfy-Org/Wan-Animate-2/blob/main/clip_vision/clip_vision_h.safetensors">
    clip\_vision\_h.safetensors: CLIP Vision encoder
  </Card>

  <Card title="VAE" icon="download" href="https://huggingface.co/Comfy-Org/Wan-Animate-2/blob/main/vae/Wan2_1_VAE_bf16.safetensors">
    Wan2\_1\_VAE\_bf16.safetensors: Wan2.1 VAE for encoding and decoding
  </Card>
</CardGroup>

Place the files in the following directories:

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   ├── wan_animate_2_bf16.safetensors
│   │   ├── wan_animate_2_distill_bf16.safetensors
│   │   ├── wan_animate_2_distill_int8_convrot.safetensors
│   │   └── wan_animate_2_int8_convrot.safetensors
│   ├── 📂 loras/
│   │   └── lightx2v_I2V_14B_480p_cfg_step_distill_rank64_bf16.safetensors
│   ├── 📂 text_encoders/
│   │   └── umt5_xxl_fp8_e4m3fn_scaled.safetensors
│   ├── 📂 clip_vision/
│   │   └── clip_vision_h.safetensors
│   └── 📂 vae/
│       └── Wan2_1_VAE_bf16.safetensors
```

### Workflow instructions

1. Make sure all the models are loaded correctly
2. Upload the reference image: the character in this image is the target character to animate
3. Upload the driving video: its motion is transferred to the reference character
4. Update the prompt to describe the scene, background, and camera movement you want
5. Click `Run` or use the shortcut `Ctrl(cmd) + Enter` to generate the video
