Nodes/ComfyUI-WanAnimatePlus/WanAnimatePlus Sampler
ComfyUI Node

WanAnimatePlus Sampler

APG, chain guidance, RIFLEX, and the knobs the Easy node hides

By wuwukaka·Created 4 months ago·Updated about a month ago· 409
WanAnimatePlus Sampler
  • model
  • image_embeds
  • text_embeds
  • samples
  • feta_args
  • context_options
  • cache_args
  • flowedit_args
  • slg_args
  • loop_args
  • experimental_args
  • sigmas
  • unianimate_poses
  • fantasytalking_embeds
  • uni3c_embeds
  • multitalk_embeds
  • freeinit_args
  • samples
  • denoised_samples
steps30
cfg6.00
shift5.00
seed0
force_offloadtrue
schedulerunipc
riflex_freq_index0
denoise_strength1.00
batched_cfgfalse
rope_functioncomfy
start_step0
end_step-1
add_noise_to_samplesfalse
guidance_modecfg
apg_eta0.50
apg_momentum0.00
apg_norm_threshold50
apg_omega4.00
apg_omega_I4.50
apg_omega_TI4.00
chain_omega_V1.25
chain_omega_I4.50
chain_omega_TI4.00

Easy Sampler exists so you don't have to look at this node. WanAnimatePlus Sampler is the full settings surface for the fork's sampling engine - and if you're running Bernini or SCAIL-2, you need some of what it exposes, because the Easy node doesn't reach the guidance modes those models depend on.

The core is familiar. model, image_embeds, steps (30), cfg (6), shift (5), seed, force_offload, scheduler (unipc default, 21 choices), plus text_embeds and samples (init latents for v2v) with denoise_strength and add_noise_to_samples for controlling how much of that init survives. context_options brings in windowing for long clips. batched_cfg batches cond and uncond for speed at the cost of memory - try it on a 24GB card, skip it on a 12GB one.

The part that makes it worth it: guidance modes. guidance_mode is where Bernini lives. Options: cfg (standard), apg (single-condition APG), apg_chain (image-reference APG chain), and cfg_chain (Bernini chained CFG). APG - adaptive parallel guidance - is the modern replacement for plain CFG, and the fork implements it with a full parameter set: apg_eta (parallel/orthogonal balance, 0.5 default), apg_momentum, apg_norm_threshold (L2 clipping, 50 default), and three omega values (apg_omega, apg_omega_I, apg_omega_TI) plus chain omegas (chain_omega_V, chain_omega_I, chain_omega_TI). The Bernini node literally outputs a recommended_guidance string telling you which of these to set per task - r2v wants apg_chain with apg_omega_I=4.5/apg_omega_TI=4.0, rv2v wants cfg_chain with the chain omegas. Defaults are sensible; follow the cheat-sheet.

Long-form and loop tools. riflex_freq_index (0 = disabled, default 6 when on) is RIFLEX - it lets new frames generate after the clip without looping back, which is the anti-repetition tool for extended takes. loop_args (from a loop-args node) handles loop-mode chunking. start_step/end_step slice the sampling schedule for two-stage tricks, and rope_function (comfy default) picks a compilable RoPE implementation - comfy_chunked trades some peak VRAM. The remaining inputs (feta_args, cache_args, slg_args, experimental_args, sigmas, unianimate_poses, fantasytalking_embeds, uni3c_embeds, multitalk_embeds, freeinit_args) are all optional bundles for specific models; ignore what you don't use. (flowedit_args is there but its tooltip is blunt: "FlowEdit support has been deprecated.")

Outputs. samples (latents for WanAnimatePlus Decode) and denoised_samples (pre-VAE denoised output).

Install via ComfyUI Manager (search "WanAnimatePlus") or git clone https://github.com/wuwukaka/ComfyUI-WanAnimatePlus into custom_nodes, restart. Start on Easy Sampler if you're on plain Wan Animate; graduate here the day a Bernini or SCAIL-2 workflow needs apg_chain. The fork-wide chain rule applies - and when CFG 6 with a speed LoRA gives you melted output, remember the distilled-model rule: CFG toward 1.0.

CategoryWanAnimatePlus

Inputs (40)

NameTypeDefaultDescription
modelWANVIDEOMODEL
image_embedsWANVIDIMAGE_EMBEDS
stepsINT30
cfgFLOAT6.000–30
shiftFLOAT5.000–1000
seedINT00–18446744073709550000
force_offloadBOOLEANtrueMoves the model to the offload device after sampling
schedulerCOMBOunipc21 options: unipc, unipc/beta, dpm++, dpm++/beta, dpm++_sde, dpm++_sde/beta, +15
riflex_freq_indexINT00–1000Frequency index for RIFLEX, disabled when 0, default 6. Allows for new frames to be generated after without looping
text_embedsoptWANVIDEOTEXTEMBEDS
samplesoptLATENTinit Latents to use for video2video process
denoise_strengthoptFLOAT1.000–1
feta_argsoptFETAARGS
context_optionsoptWANVIDCONTEXT
cache_argsoptCACHEARGS
flowedit_argsoptFLOWEDITARGSFlowEdit support has been deprecated
batched_cfgoptBOOLEANfalseBatch cond and uncond for faster sampling, possibly faster on some hardware, uses more memory
slg_argsoptSLGARGS
rope_functionoptCOMBOcomfyComfy's RoPE implementation doesn't use complex numbers and can thus be compiled, that should be a lot faster when using torch.compile. Chunked version has reduced peak VRAM usage when not using torch.compile
loop_argsoptLOOPARGS
experimental_argsoptEXPERIMENTALARGS
sigmasoptSIGMAS
unianimate_posesoptUNIANIMATE_POSE
fantasytalking_embedsoptFANTASYTALKING_EMBEDS
uni3c_embedsoptUNI3C_EMBEDS
multitalk_embedsoptMULTITALK_EMBEDS
freeinit_argsoptFREEINITARGS
start_stepoptINT00–10000Start step for the sampling, 0 means full sampling, otherwise samples only from this step
end_stepoptINT-1-1–10000End step for the sampling, -1 means full sampling, otherwise samples only until this step
add_noise_to_samplesoptBOOLEANfalseAdd noise to the samples before sampling, needed for video2video sampling when starting from clean video
guidance_modeoptCOMBOcfgGuidance mode: cfg (standard CFG), apg (single-condition APG), apg_chain (image-reference APG chain), or cfg_chain (Bernini chained CFG)
apg_etaoptFLOAT0.500–1APG: parallel/orthogonal balance (0=orthogonal only, 1=full)
apg_momentumoptFLOAT0.00-1–1APG: EMA momentum for smoothing guidance differences
apg_norm_thresholdoptFLOAT500–1000APG: L2 norm clipping threshold (0=disabled)
apg_omegaoptFLOAT4.000–30APG: guidance strength (equivalent to CFG scale, replaces cfg when APG is active)
apg_omega_IoptFLOAT4.500–30APG chain: image-only guidance strength
apg_omega_TIoptFLOAT4.000–30APG chain: text+image guidance strength
chain_omega_VoptFLOAT1.250–30Chain CFG: video-only guidance strength
chain_omega_IoptFLOAT4.500–30Chain CFG: extra reference context strength (VI - V; reference video/images)
chain_omega_TIoptFLOAT4.000–30Chain CFG: text+image guidance strength

Outputs (2)

NameTypeDescription
samplesLATENT
denoised_samplesLATENT