Nodes/ComfyUI-WanAnimatePlus/WanAnimatePlus ModelLoader
ComfyUI Node

WanAnimatePlus ModelLoader

Loading Wan, quantizing, attention modes, and what to plug in

By wuwukaka·Created 4 months ago·Updated about a month ago· 409
WanAnimatePlus ModelLoader
  • compile_args
  • block_swap_args
  • lora
  • vram_management_args
  • extra_model
  • fantasytalking_model
  • multitalk_model
  • fantasyportrait_model
  • model
model
base_precisionbf16
quantizationdisabled
load_deviceoffload_device
attention_modesdpa
rms_norm_functiondefault

Every WanAnimatePlus workflow starts here. ModelLoader takes your diffusion checkpoint out of ComfyUI/models/diffusion_models, applies precision, quantization, attention and memory settings, optionally bolts on a LoRA, VACE, or one of the talking/portrait extra models, and hands the chain a single WANVIDEOMODEL. Get this node wrong and nothing downstream matters - so here's what each family of settings actually does.

Precision and quantization. base_precision defaults to bf16, which is right for most modern cards. quantization defaults to disabled - and the tooltip explains that "disabled" really means "autoselect based on weights," so it's not as lazy as it sounds. The fp8 modes are where the VRAM wins live: fp8_e4m3fn and friends. Watch the compute-capability note though - the _fast modes (fp8 matmul) need CUDA compute capability 8.9+ (RTX 4000 series and up), and e4m3fn generally can't be torch.compiled on 3000-series and older. If you're on a 3090, that's the difference between a working fp8 load and a crash.

Where the model lives. load_device defaults to offload_device - the model starts in your system RAM and blocks shuffle in as needed. The tooltip is a warning in disguise: "NOT recommended with the larger models unless you have 48GB+ VRAM" if you set it to main_device. Leave the default; that's the whole point of block swap and VRAM management.

Attention and speed. attention_mode (default sdpa) is your menu: flash_attn_2, sageattn, sageattn_compiled, radial_sage_attention, and so on. SageAttention is the community's favorite speedup but is famously fiddly to install on Windows (Triton). compile_args hooks in torch.compile via the pack's TorchCompileSettings; rms_norm_function (pytorch is the newer native RMSNorm, faster without compile, slightly different results).

The memory helpers. block_swap_args takes the output of WanAnimatePlus BlockSwap - the CPU-RAM overflow parking for small cards. vram_management_args is an alternative from DiffSynth-Studio: more aggressive memory reduction than block swap, but slower. You generally pick one, not both. lora takes your WANVIDLORA chain from LoraSelect/LoraSelectMulti, and extra_model accepts a VACE or MTV Crafter to stack on top.

Install via ComfyUI Manager (search "WanAnimatePlus") or git clone https://github.com/wuwukaka/ComfyUI-WanAnimatePlus into custom_nodes, restart, and put your checkpoint in ComfyUI/models/diffusion_models - that folder is the only place this node looks. The fork's README is explicit that the original ComfyUI-WanVideoWrapper should be installed alongside, and that you must use the WanAnimatePlus chain end to end. If your load fails on a 3000-series card with a fp8 mode, the compute-capability note above is your answer.

CategoryWanAnimatePlus

Inputs (14)

NameTypeDefaultDescription
modelCOMBOThese models are loaded from the 'ComfyUI/models/diffusion_models' -folder
base_precisionCOMBObf164 options: fp32, bf16, fp16, fp16_fast
quantizationCOMBOdisabledOptional quantization method, 'disabled' acts as autoselect based by weights. Scaled modes only work with matching weights, _fast modes (fp8 matmul) require CUDA compute capability >= 8.9 (NVIDIA 4000 series and up), e4m3fn generally can not be torch.compiled on compute capability < 8.9 (3000 series and under)
load_deviceCOMBOoffload_deviceInitial device to load the model to, NOT recommended with the larger models unless you have 48GB+ VRAM
attention_modeoptCOMBOsdpa9 options: sdpa, flash_attn_2, flash_attn_3, sageattn, sageattn_3, radial_sage_attention, +3
compile_argsoptWANCOMPILEARGS
block_swap_argsoptBLOCKSWAPARGS
loraoptWANVIDLORA
vram_management_argsoptVRAM_MANAGEMENTARGSAlternative offloading method from DiffSynth-Studio, more aggressive in reducing memory use than block swapping, but can be slower
extra_modeloptVACEPATHExtra model to add to the main model, ie. VACE or MTV Crafter
fantasytalking_modeloptFANTASYTALKINGMODELFantasyTalking model https://github.com/Fantasy-AMAP
multitalk_modeloptMULTITALKMODELMultitalk model
fantasyportrait_modeloptFANTASYPORTRAITMODELFantasyPortrait model
rms_norm_functionoptCOMBOdefaultRMSNorm function to use, 'pytorch' is the new native torch RMSNorm, which is faster (when not using torch.compile mostly) but changes results slightly. 'default' is the original WanRMSNorm

Outputs (1)

NameTypeDescription
modelWANVIDEOMODEL