Skip to content

Latest commit

 

History

449 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ComfyUI-UtilsCollection

A collection of ComfyUI nodes for modern text and multimodal conditioning, image and mask processing, prompt presets, workflow parameters, loading, and general utilities. The encoder nodes track current ComfyUI Core behavior while retaining compatible legacy node IDs where practical.

Available nodes

The list below uses the canonical node IDs. Deprecated compatibility aliases remain registered for existing workflows but are not duplicated here.

Text encoding and conditioning

  • UC_TextEncodeSystemPrompt
  • UC_TextEncodeLtxv2SystemPrompt
  • UC_WeightedTextEncodeSystemPrompt
  • UC_TextEncodeSystemEditAdvanced
  • UC_TextEncodeGemmaSystemEditAdvanced
  • UC_AdvancedVisualConditioningEncode
  • UC_AdvancedVisualConditioningEncodeTokenFusion
  • UC_AdvancedMiniMaxH3ImageToVideo
  • UC_AdvMiniMaxH3ImageToVideoTokenFusion
  • UC_AdvancedMiniMaxH3ImageToVideoCombined
  • UC_AdvMiniMaxH3ImageToVideoCombinedTokenFusion
  • UC_MiniMaxH3MediaConfig
  • UC_MiniMaxH3FirstFrameReferences
  • UC_AdvancedVisConEncoder
  • UC_AdvancedVisConEncoderTokenFusion
  • UC_VisualConsensusConfiguration
  • UC_AdvancedConsensusConfiguration
  • UC_Krea2TokenAttentionWeight
  • UC_Krea2TokenAttentionWeightTokenFusion
  • UC_AttentionBiasTextEncode
  • UC_TextConsensusBlendConfig
  • UC_VisualFusionConfig
  • UC_ConditioningConsensusBlend
  • UC_VLMInputEmbeds
  • UC_Krea2LayerProbe
  • UC_Krea2LayerAblator
  • UC_MiniMaxH3ClipProjectionPatcher
  • UC_EncoderNodesGuide

MiniMax H3 CLIP projection models

UC_MiniMaxH3ClipProjectionPatcher projects a Qwen3-VL 4B or 8B text encoder into MiniMax H3's 32B conditioning space. Load the encoder with Core's Load CLIP node using type minimax, then connect it to the projection patcher.

Download one projection matching the encoder size into ComfyUI/models/clip_projections/:

Only one projection is used at a time. The control and obsolete/ files in the model repository are not normal generation models.

UC_AdvancedMiniMaxH3ImageToVideo: Qwen-only 1024 VLM example

The optional MiniMax H3 Media Configurator controls separate Picture and Video timestamp syntax. Configured Video timestamps map one-to-one to already-selected images; without them, the Video input is a full 24 fps batch using ComfyUI Core H3 sampling, syntax, and native conditioning. vlm_resolution controls Picture token detail while vlm_video_resolution independently controls Video token detail. Video blocks remain outside Picture fusion. Audio and its MiniMax H3 audio VAE connect directly to each advanced main node and produce a standalone native audio reference plus Qwen Audio label.

Workflow JSON | API workflow JSON | Workflow overview | Reference images | Turbo LoRA used

This example uses eight chronological storyboard frames as 1024-resolution Qwen3-VL/DeepStack references. The prompt associates each ordered <Picture N> entry with a target timestamp. With ref_image_size set to none, the images provide visual-token conditioning without VAE reference encoding.

The workflow demonstrates strong subject, composition, and approximate timeline control without a native reference video. Its eight images reproduced the main framing and progression of a 12.25-second source sequence in seven sampling steps on a 16 GB GPU. Picture timestamps are prompt instructions, not fixed frame anchors, so results remain stochastic.

Extract the separately hosted reference-image ZIP into ComfyUI/input before loading either workflow.

The workflow uses Core's Create Video and Save Video nodes and requires no other custom-node collection.

For headless use, start ComfyUI with its API reachable, extract the reference ZIP, then run:

python workflows/UC_AdvancedMiniMaxH3ImageToVideo/run_api_workflow.py C:\path\to\reference-images

The standard-library runner uploads the eight images, substitutes the returned server filenames into the unchanged API workflow, queues it, waits for completion, and prints the saved-output metadata. Use --server http://host:8188 for another ComfyUI server and --seed N to override the workflow seed.

UC Advanced MiniMax H3 Image to Video Qwen-only eight-image 1024 VLM workflow

Advanced visual consensus

UC_AdvancedVisConEncoder runs two sequential stages: it first constructs a complete spatially fused conditioning independently at every selected VLM resolution, then passes those complete conditionings through the same consensus mathematics as UC_ConditioningConsensusBlend. Spatial fusion and consensus are not alternatives and are never crossfaded.

UC_AdvancedVisConEncoderTokenFusion is the additive token-first alternative. At each lane and resolution it fuses per-source visual and DeepStack tokens, runs one conditioning encode, then applies the same complete-conditioning consensus across resolution samples. The original node remains unchanged.

Use UC_VisualConsensusConfiguration to combine one complete UC_VisualFusionConfig with one UC_AdvancedConsensusConfiguration. Fusion method off disables the spatial stage; consensus preset off disables the cross-resolution consensus stage. Advanced Consensus Configuration inherits the complete Text Consensus Blend Configurator contract and adds resolution_samples plus a 32-aligned sample_offset.

block_size is specific to block-interleave. dither_ratio and dither_secondary_pattern are specific to random-dither. Advanced Consensus Configuration exposes resolution_samples and sample_offset. Offset defaults to 32 and supports 32 through 512 in 32-unit steps. The configured sample count is exact, so 1 remains one resolution sample regardless of visual-source or batch-lane count. Original VLM resolution supports one sample but cannot construct adjacent resolution variants.

A batch in the only connected image socket behaves like its images were connected as separate visual sources. With multiple connected batched sockets, equal indices form independent lanes, singleton sockets broadcast, and all other batch lengths must match. Raw visual export uses the same spatial mask as the base-resolution conditioning fusion.

Image, mask, and compositing

  • UC_Image_Color_Noise
  • UC_ExtractPrevalentColors
  • UC_ModifyMask
  • UC_SAM31CheckpointLoader
  • UC_MaskToBoundingBox
  • UC_ImageBlendByMask
  • UC_ImagePad
  • UC_NoHaloLoHaloDownscale
  • UC_CropByMask
  • UC_StagedLayerCrops
  • UC_ImageCropMerge
  • UC_ExtractMask
  • UC_ExtractImage
  • UC_ImageAndMaskResize
  • UC_ResizeMask
  • UC_BackgroundRemovalPreserveAlpha
  • UC_UnifiedBackgroundReplace
  • UC_StagedLayeredBackgroundComposite
  • UC_StagedIndividualComposites
  • UC_StagedLayeredBackgroundCompositeOptions
  • UC_StagedMediaPipeFaceBackgroundComposite
  • UC_StagedMediaPipeFaceOptions
  • UC_LayeredBackgroundComposite
  • UC_MediaPipeFaceCompositeOptions
  • UC_MediaPipeFaceComposite
  • UC_ListToImageBatch
  • UC_ImageMatchProperties
  • UC_OpticalFlowComposite
  • UC_ImageInwardEdgeFill
  • UC_ImageIterativeStretchFill
  • UC_TextOverlayNode
  • UC_CompositeNodesGuide
  • UC_LaMaInpaint

UC_StagedLayeredBackgroundComposite builds a scene from a background and ordered foreground sockets. Use run_staging to retain cutouts and populate the placement editor. Use run_staged to composite retained cutouts without loading models or evaluating foreground branches. Use full_run to restage and composite in one queue. foreground_0 is the backmost layer. Retained cutouts are held in server memory and must be recreated after restarting ComfyUI.

UC_StagedMediaPipeFaceBackgroundComposite detects faces in each foreground and adds them as independently placeable layers. The background and face options nodes contain removal, extraction, feathering, and blend settings. UC_StagedIndividualComposites provides the same ordinary foreground staging editor but returns one full-background image, placement mask, and box per included foreground without stacking them. UC_BackgroundRemovalPreserveAlpha directly returns source-resolution RGBA images and their soft alpha masks; existing RGBA inputs keep their supplied alpha without model execution.

UC_LoadLaMaModel loads Big LaMa .safetensors files from ComfyUI/models/lama through Unified Efficient Loader. Connect its LAMA_MODEL output to UC_LaMaInpaint. Device choices include ComfyUI's default device, CPU, and every visible GPU. Models are never downloaded automatically. Download Big LaMa or Anime/Manga Big LaMa, then place the selected file in ComfyUI/models/lama.

Staged compositor example

Workflow JSON | Workflow overview | Source assets

Staged MediaPipe face background compositor workflow

Resolution and workflow parameters

  • UC_AdjustedResolutionParameters
  • UC_ResolutionSelectorExtended
  • UC_VideoResolutionSelector
  • UC_ImageScaleAndResolutionPicker
  • UC_SwitchInverseNode
  • UC_SoftSwitchInverseNode
  • UC_IntegerRangeRandom
  • UC_RandInt
  • UC_StaticInt
  • UC_StaticFloat
  • UC_RandIntRange
  • UC_ColorConvertNode
  • UC_SeedCluster
  • UC_FromSeedCluster
  • UC_ExtractBoundingBox
  • UC_AdjustBoundingBox
  • UC_Ideogram4BoundingBoxCrop
  • UC_Ideogram4DebannerPatch
  • UC_HighResolutionTileSplit
  • UC_HighResolutionTileAccumulator
  • UC_HighResolutionTilingGuide

Prompt presets

  • UC_SystemMessagePresets
  • UC_SystemMessageVideoPresets
  • UC_InstructPromptPresets
  • UC_InstructPromptVideoPresets
  • UC_BonusPromptPresets
  • UC_BonusPromptVideoPresets
  • UC_EditTargetPresets
  • UC_EditOpPresets
  • UC_CameraShotPresets
  • UC_VLMSysInstrPresets
  • UC_VLMSysInstrPresetsExperimental
  • UC_VLMSysInstrLegacyPresets
  • UC_VLMSysQueryAddPresets
  • UC_VLMSysQueryRawPresets
  • UC_VLMSysInstrAdvPresets
  • UC_VLMSysInstrAdvPresetsExperimental
  • UC_MiniMaxH3VLMSysInstrPresets
  • UC_MiniMaxH3VLMSysInstrPresetsExperimental
  • UC_MiniMaxH3VLMSysInstrAdvPresets
  • UC_MiniMaxH3VLMSysInstrAdvPresetsExperimental
  • UC_LegacyPromptPresets
  • UC_UnifiedPresets

Loading, text generation, and text utilities

  • UC_LoadImagePath
  • UC_LoadImageDirectory
  • UC_LoadImageWithAlpha
  • UC_SampleVideoFramesAsImages
  • UC_ImagesToVideoTimeline
  • UC_VideoTimelineText
  • UC_LoraLoaderCLIPOnly
  • UC_LoadLaMaModel
  • UC_TextGenerate
  • UC_TextGenerateQwen35SystemPrompt
  • UC_EmbeddingDetokenizerAnalysis
  • UC_ImageToVideoPrompt
  • UC_TagNormalizeCombine
  • UC_FromList
  • UC_GetJsonValue
  • UC_MiniMaxH3Cache
  • UC_MiniMaxH3Spectrum
  • UC_MiniMaxH3PDDAcc
  • UC_UnifiedAttentionPatcher
  • UC_MarkdownPreview
  • UC_BoldFrakturTextStyle
  • UC_UnBoldFrakturTextStyle
  • UC_WordJoiner
  • UC_UnWordJoiner
  • UC_JSONMinifyRepair
  • UC_StringUnescape
  • UC_TextConcatenateAutogrow
  • UC_TextConcatenateListsAutogrow
  • UC_Newline

MiniMax H3 PDD Acc models

Download the PDD Acc file matching the MiniMax H3 diffusion model:

Place the downloaded .safetensors file in ComfyUI/models/loras, or in the configured external directory used by ComfyUI's loras model category. Restart ComfyUI or refresh model files, then select it in UC_MiniMaxH3PDDAcc.

Scheduler presets

  • Ideogram4SchedulerPreset
  • UC_SigmaRescale
  • UC_DiscardPenultimateSigma
  • UC_SigmoidOffsetScheduler
  • UC_PowerShiftScheduler
  • UC_RadianceShiftScheduler
  • UC_SigmaCurveFromPointsScheduler
  • UC_SigmaCurvePchipScheduler

The migrated schedulers also register sigmoid_offset, power_shift, radiance_shift, sigma_curve_from_points, and sigma_curve_pchip for Core scheduler selectors. The Power Shift scheduler was inspired by InverserSquaredScheduler.

UC_SigmaRescale maps an existing schedule to exact start and end sigma values without changing its shape or number of steps.

The dedicated scheduler nodes do not include Core-style denoise controls or optional penultimate-sigma controls. Connect UC_SigmaRescale after a scheduler when setting image-to-image noise levels. Connect UC_DiscardPenultimateSigma when the selected sampler requires penultimate sigma removal. Radiance Shift performs its required compensated removal internally. Sigmoid Offset retains its model-specific start_sigma adjustment.

Logic and math

  • UC_LogicIF
  • UC_LogicAND
  • UC_LogicOR
  • UC_LogicNOT
  • UC_LogicXOR
  • UC_MathAdd
  • UC_MathSubtract
  • UC_MathMultiply
  • UC_MathDivide
  • UC_MathPower
  • UC_MathFloor
  • UC_MathCeil
  • UC_MathRound
  • UC_MathModulo
  • UC_MathAbs
  • UC_MathSqrt
  • UC_MathSin
  • UC_MathCos
  • UC_MathTan
  • UC_MathMin
  • UC_MathMax
  • UC_MathClamp
  • UC_MathNumberConvert
  • UC_StringToNumber
  • UC_NumberToString
  • UC_MathCompare
  • UC_MathOperation
  • UC_MathAspectRatio

These nodes replace the equivalent nodes from ComfyUI-LogicMath, ComfyUI_SigmoidOffsetScheduler, and ComfyUI_PowerShiftScheduler. Remove the standalone pack before accepting ComfyUI's workflow replacement prompt.

About

No description, website, or topics provided.

Resources

Stars

32 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages