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 14 days ago· 415
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—