Wan-Animate-2 is a character animation model that takes a reference image and a driving video and transfers the performance directly — no intermediate skeleton or motion extractor in between. This repo exists so it runs on 8-12 GB cards instead of requiring the full 30 GB bf16.
All original licensing terms and usage restrictions carry over from the base model.
Wan-Animate-2 doesn't announce itself through tensor names. ComfyUI selects it from a config blob in the safetensors __metadata__ that sets model_type: "animate2" — and GGUF has no equivalent field, so any GGUF of this model loads as a plain Wan 2.1 I2V.
The failure is quiet, which is what makes it worth spelling out: the model loads, sampling runs, a video comes out with your reference character in it — and the driving video is completely ignored. Random motion, no performance transfer. Nothing errors.
Use GGUF Unet Loader + model_type (Rebels) in place of the stock Unet Loader (GGUF)
Set model_type to animate2
Everything else in the standard Wan-Animate-2 workflow stays as it is
Confirm it took — the console prints on load:
[Rebels GGUF] loaded <file> | model_type=animate2 | model class=WAN_Animate2
model class=WAN_Animate2 is the proof. Anything else and you're in the silent-failure case above.
Getting good motion transfer
The reference image must roughly match the driving video's opening pose. This is the single biggest quality factor and it isn't a quantization thing — it applies to the full bf16 model too. A front-facing portrait against a side-on driving video loses context and the model falls back to invented motion. Frame the reference the way the performance starts.
Files
Converted from the official bf16 weights. Every file was verified after quantization to confirm the precision-sensitive layers were preserved.
Quant
Size
Notes
Q8_0
~17.4 GB
Near-lossless reference tier
Q6_K
~13.5 GB
Excellent quality
Q5_K_M
~11.7 GB
Very good
Q4_K_M
~9.8 GB
Recommended — best quality per GB
Q4_K_S
~9.2 GB
Slightly smaller
Q3_K_M
~8.0 GB
Usable, visible detail loss
Q2_K
~5.9 GB
Smallest; quality drops sharply
Download a single file rather than the whole repo:
Load CLIP — umt5_xxl_fp8_e4m3fn_scaled.safetensors, type wan
Load VAE — Wan2_1_VAE_bf16.safetensors
Load CLIP Vision — clip_vision_h.safetensors
Reference image + driving video into the Wan Animate nodes, then sample as usual
Requires a recent ComfyUI with native Wan-Animate-2 support, plus the ComfyUI-GGUF custom node.
Base vs distillation
Upstream ships two variants. This repo is quantized from the {base | distillation} weights.
Base — standard step count and CFG. Higher ceiling, slower.
Distillation — few-step schedule with CFG 1.0. Much faster; use the settings the base model documents rather than normal Wan settings, or output quality suffers regardless of quantization.
Conversion notes
Converted with a streaming converter that never loads the full model into RAM, then quantized with llama-quantize.
These layers are preserved at high precision rather than quantized:
That matters more than it sounds. Timestep and conditioning projections carry very little redundancy — quantizing them corrupts every sampling step, and standard quantizers do not preserve them automatically. They are restored after quantization and verified per file.
The 5-D patch_embedding conv weight is stored with its original shape recorded so the loader restores it correctly.
Credits
Wan-AI / Alibaba — Wan2.2-Animate-2-14B
Comfy-Org — repackaged encoder, VAE and CLIP vision files
