ComfyUI-Apt_Preset
ComfyUI Preset Manager, supporting various preset templates and workflow management
Nodes (395)
Stop guessing tiled-decode settings for long video clips
Google's FILM interpolator, wired into an Apt_Preset batch
Swap or pull a frame range out of an image batch
Pad an image batch out to a target frame count
Plot a keyframe trend curve as an image
A deprecated keyframe-relay node (use the LTX_video branch instead)
Deprecated latent-tail packer, superseded by the LTX_video branch
Feed your own audio into LTX's audio latent
Unbundle the LTX config into individual wires
Pose/depth/canny structural control for LTX video
Upscale an LTX latent before decode
The one-node entry point for LTX video in Apt_Preset
Wiring multiple LTX guide references into one node instead of several
The actual sampling step for Apt_Preset's LTX pipeline
Decode LTX latents to a finished video (with audio)
Pad a mask batch out to a target frame count
Cut a video/audio file down with marker-based trim points
Fake a seamless loop by playing your clip backward
Plot up to four schedule curves on one graph
Schedule IPAdapter strength across an animation instead of holding one weight
Turn a keyframe curve into a fading mask batch
Prompt travel with keyframes and easing curves
Eased prompt scheduling for animated workflows
Turn a number into an eased curve over time
Stitch up to 10 clips together with audio, inside the graph
Automatic scene-cut detection and splitting
ByteDance's Seedream image model, called via API key
Pull generated images back from a Doubao browser session
Vision chat over Zhipu's GLM models, with a free tier that actually works
Text-only chat against Zhipu's GLM models
It's a vision chat node, not an image generator
Qwen-Image-Edit as a hosted API, no local VRAM needed
Z-Image-Turbo and friends, generated over the API
Text chat via ModelScope, defaulting to MiniMax rather than Qwen
Vision chat against a local Ollama model, no API key needed
Make sure your local Ollama service is actually up first
Text chat against your local Ollama models
Why every AI node's preset dropdown says just 'None'
Vision chat against Alibaba's Qwen-VL models via DashScope
Text and coder-model chat against Qwen via DashScope
Drive a web app's browser session and grab the images back
Turn a soundtrack into a per-frame value for audio-reactive animation
A mask that pulses with whatever curve you feed it
Cycle prompt lines off a threshold, not a frame count
Shape a raw amplitude curve into a number you can actually use
The manual VRAM-release valve for Apt_Preset workflows
A toggle that hands you its opposite for free
CLIP Text Encode, positive and negative, in one node
A float value you type into a text box, not a slider
Type one value, get it back as int, float, and string at once
The plain integer box this pack builds everything else on
A 0-1 knob you can bend to any range you actually need
Pick your sampler once, wire it to every KSampler that needs it
The noise-schedule dropdown, pulled out on its own
One seed, wired to every sampler that needs to match it
A bare text box with an output port
The four video dimensions in one place (yes, the name is misspelled)
ComfyUI's Advanced KSampler, wired for Apt_Preset's context
Build your own sampling algorithm, context-native
The everything-KSampler for Apt_Preset's context pipeline
For when it's the VAE decode running you out of VRAM, not the sampler
KSampler without demanding a loader first
ComfyUI's stock KSampler, collapsed to one context wire
Python list slicing for your ComfyUI batches
Stitch several Apt_Preset lists into one
Turn a bounding box into a portable text coordinate
Parse a text coordinate (hand-drawn or AI-generated) into a real bounding box
Bridge stock ComfyUI loaders into Apt_Preset's context pipeline
IP-Adapter with raw file dropdowns instead of presets
The node that actually applies your stacked regional IP-Adapter setup
IP-Adapter, wired the way you'll actually use it
Face-consistent generation without training a LoRA — with a license catch
Manual file control over IP-Adapter FaceID, plus the InsightFace pack choice
Stack per-region reference images and prompts before applying IP-Adapter
Split style from composition with two reference images
Two independent denoise dials, one for the mask, one for everything else
Crop, sample, and stitch back — inpainting as one node
A Flux Kontext sampler — but the pack itself marks it deprecated
KSamplerAdvanced-style step control for Kontext — also marked deprecated
Crop-and-stitch masked editing for Kontext — deprecated in the pack
Upscale and re-sample in one node — the hi-res fix pattern, built in
Tiled upscaling for output sizes your VRAM couldn't otherwise touch
Brightness, contrast, and sharpen — done on the latent, not the pixels
Flux Redux with the wiring already done, plus knobs stock Redux doesn't give you
Bundle a whole ControlNet setup into one wire
Unbundling the ControlNet wire CN_preset1_pack builds
The fake-HDR tone-map look, from a single image
The live-preview twin of color_adjust_HDR
The one-node basic photo pass
The live-preview twin of color_adjust_HSL
Color balance with a lock so skin tones survive the grade
A linear lighting gradient you paint across the image
A seeded tile-fragment glitch effect
Photoshop-style curves, with 30 built-in presets
A linear gradient generator with a live preview
Match one image's grade onto another, with a skin-protection dial
Live-preview color matching with skin protection
The classic 'color pop' selective-color effect
A lightweight color-replace / chroma-key tool
A radial gradient / spotlight generator
The live-preview twin of color_RadiaBrightGradient
A reusable color swatch for the rest of this pack's hex-code inputs
Converting between hex and RGB(A) without leaving the graph
A rectangular mask from four normalized numbers
Click points on an image, get JSON coordinates back
Turning a mask region into an actual x/y coordinate
Type up to five points instead of clicking them
Attaching text labels to numbered coordinate points
LoadImage and a point picker, fused into one node
Drawing numbered markers back onto an image
Merging up to five coordinate lists into one
Pulling one point out of a coordinates list as plain numbers
Animated wipe/fade transition masks for video work
Building a LIST from a variable number of inputs
A generic, any-type list builder with dynamic inputs
Stacking a variable number of images into one batch
A two-color linear gradient, plus its mask, at any angle
Splitting a canvas into a grid of masks by ratio
Stacking a variable number of masks into one batch
Deprecated — compositing a masked foreground onto a background
The current version of Apt_Preset's mask-fit compositor
A quick shape-mask generator — circles, stars, crosses and more
Sanity-check a mask before it wrecks your generation
Eight solid color swatches in one node
A gradient image and its mask, in one node
Unpack (and override) the Apt_Preset context bus
Smuggle up to 8 extra values through your context wire
Reunite two context buses into one
A bus with ports you name yourself
Pull loader metadata back out of a context
Bake your loader settings into a reusable preset
Read the sampling settings out of a context
Pull one value off the context bus without the clutter
One node for Qwen-Image-Edit-2509's multi-image conditioning
Find how many prompts in your batch sheet are still missing
Deprecated — use excel_insert_image_easy instead
Drop a generated image straight into a spreadsheet cell
Build a scene prompt from curated dropdowns instead of a blank text box
A typography prompt builder for Qwen-Image's text-rendering strength
Build camera-move prompts from dropdowns instead of typing them
Deprecated typography-prompt builder for 3D text renders
Deprecated range reader — see excel_read_easy for the current version
Pull one cell out of a spreadsheet
Build a character-appearance prompt attribute by attribute
Actually a column comparison — see excel_column_diff first
Find a value's coordinates in a spreadsheet
Fill-in-the-blank video prompts for Wan-style clips
A screenplay generator that has nothing to do with Excel
Writes a block of cells to an xlsx file (deprecated, use the easy version)
Write one value into one Excel cell, no fuss
Conditional auto-resize (deprecated node in Apt_Preset)
Shut your PC down when a batch finishes
A simple on/off gate for any wire
A manual valve for an image/mask pair
Turn an image's shape into a boolean you can branch on
Wait until two values have actually settled
Combine two values into one batch
The closing bracket of Apt_Preset's for-loop
A real for-loop primitive for ComfyUI graphs
Pick between two values with one boolean
Route one value to one of two paths
A VRAM-reservation checkpoint you drop into a graph
The old manual-requeue loop counter (deprecated)
Turn a seed into a repeating schedule index
A 5-way multiplexer for any wire type
Send one value to one of five destinations
Fix mismatched image/mask shapes before they crash your graph
The condition check that actually closes the loop
Faking a while-loop inside a graph that isn't supposed to have one
Stamp the same overlay onto every frame in a batch
Pull specific frames back out of a batch
Read or write a single RGBA channel as a mask
A Photoshop-style layer blender for building composite control maps
The same blend engine as Image_CnMapMix, previewed inline
Match one image's resolution to another before you blend them
Drag-and-zoom cropping right on the node
Frequency separation, the trick that saves IC-Light relights
Frequency separation, previewed inline
Preview four filter presets on one image at once
Drag the canvas edges out, get an outpaint mask for free
Crop tight around a mask, at an exact size, with a way back
Stitch two images together with a feathered seam
Pad an image to the size your model wants, without losing the original
Undo Image_pad_adjust and get your original geometry back
Rotate, scale, and place one image onto another
Pull the second image's region back out after Image_Pair_Merge
Combine two images onto one canvas without losing track of either
Quantize an image down to 4-bit color
The old resize node — deprecated, use Image_Resize_sum instead
Resize by the long edge, keep the aspect ratio
Resize, pad or crop an image — and keep the receipt to undo it
Unpack the resize math from Image_Resize_sum
Paste a resized image back onto its original canvas
Clamp an image into a Seedream-safe resolution range
Feather a mask edge and recolor what's outside it
Deprecated — crop a subject and get its background separately
Crop a subject out by its mask, ready to stitch back later
Read the raw numbers out of a solo_crop stitch bundle
Blend a processed crop back into the original image
Force an image to an exact size — stretch, crop, or pad
Composite one image onto another, Photoshop-style
Composite two images with a drag-to-place widget
An upscale-model pass and a pixel resize pass, in one node
Deprecated fisheye/pinch distortion node
Deprecated push/pull/twist/pinch distortion brush
Deprecated banded stretch/squeeze distortion
Deprecated ripple/wave distortion node
Fan one wire out to 20 outputs, of any type
Paint a mask straight inside the node, split by color
Save an image to the same filename every time
Pick specific frames out of a batch by index
Turn pasted text into a typed list, one node
Load a whole folder of images, or just one by position
Manage a list of audio files and step through them
A visual gallery for stepping through a batch of images
The storyboard viewer that pairs with IO_ShotCreate
Cycle through a list of prompts or captions, card by card
Manage a list of video paths and step through them
A searchable index of every node in your ComfyUI install
Filter, sort, and clean up a list of file paths with regex
Build a working regex from plain language, not trial and error
A save node with real control over the filename
Build one shot of a storyboard — scale, camera move, transition, image
Buffer images across runs, then release them as a batch
Tiled VAE decode for video, wired through this pack's context pipe
Encode a reference image for IP-Adapter-style prompting
Feed different conditioning into different SDXL attention blocks
An image noise generator, despite living in the 'latent' folder
Turn a picture into a noise texture that still echoes its shapes and color
Slicing one image into a grid of tiles in ComfyUI
Turn a batch of images into one contact-sheet grid
A labeled comparison grid for ComfyUI image batches
Comic-style panel layouts for ComfyUI images
Hero image + thumbnails layout in ComfyUI
Drawing styled text onto an image in ComfyUI
Labeling multiple points on one image at once
Python-style list slicing for any ComfyUI data type
Combining multiple lists into one in ComfyUI
Generating evenly spaced number sequences in ComfyUI
Keyframed, eased value schedules for ComfyUI animation
Loading a quantized GGUF UNet in ComfyUI
The Nunchaku-quantized loader in Apt_Preset, and its one real gotcha
Human body-part masking in ComfyUI
Masking individual clothing items in ComfyUI
Masking individual facial features in ComfyUI
Four ways to turn an image into a mask, one node
Combining two masks with boolean/arithmetic operations
Background removal with RMBG-2.0, InSPyReNet or BEN2
Point, box, or text-prompted SAM masking in ComfyUI
Cleaning up and reshaping masks in ComfyUI
Picking out one region from a multi-blob mask
Split a color-coded mask into 8 channel masks
Break one multi-blob mask into up to 4 separate masks
The all-in-one mask preview, crop, and style node
One node instead of ten to do arithmetic in your workflow
Rescale a value into a new range, with easing
Turn a prompt string into a true/false switch
Bundle your model file choices into one wire
Get your model filenames back out of an EPIPE
FreeU, PAG, SAG, CFG-Norm, and flow-shift in one model patch
A deprecated node from ComfyUI-Apt_Preset — what to use instead
A deprecated generic unpack node — here's what replaced it
Bundle your ControlNet strengths and mix factors into one wire
Get your ControlNet strengths and mix factors back out
Bundle canvas, mask, prompts and size into one wire
Get canvas, mask, prompts and size back out
Eight ways to combine two conditioning streams
A 3-slot ControlNet stack for the pack's context chain
One checkpoint, multiple condition types, up to three slots
A one-parameter guidance patch for Apt_Preset's context pipeline
IC-Light relighting for SD1.5 — deprecated, and here's why
Native inpaint or ControlNet inpaint, switched by one dropdown
Single-image Kontext editing preset — deprecated
Multi-image Kontext editing preset — deprecated
Deprecated 5-region masked prompting for Kontext
Blend two images into one latent, weighted
Five-region masked prompting, with a negative output
Feed up to four reference images into your conditioning
Stack up to three ControlNets on Qwen-Image in one node
Deprecated one-node Qwen-Image-Edit setup
Override sampler/scheduler/steps/cfg in the run context, or leave them alone
Deprecated preset for ByteDance's USO style/subject model on Flux
Z-Image's union ControlNet, wired for masked inpainting
Stitch processed tiles back into one image
Chop a big image into overlapping tiles for tiled upscaling
Wrap any sampler with a detail boost dial
Add noise to your conditioning, on a schedule
Drag points on your sigma curve instead of guessing numbers
Write your own sigma schedule as a math formula
Run two schedulers in one sampling pass, blended at the seam
An Align-Your-Steps-style schedule, extended past SD1/SDXL
Plot your sigma schedule instead of guessing what it looks like
Pick one frame out of a batch by index
Pick one mask out of a batch by index
Keyframe Prompt Scheduling Straight to CONDITIONING
Split a String and Pick One Piece per Frame
Raw Keyframe-Scheduled Prompt Text, Before It Hits CLIP
Schedule a Number (CFG, Strength, Denoise) Across Frames
One Union ControlNet, Up to Two Conditions, No Double-Loading
Three Control Images, Two Condition Slots Each, One Node
Five Masked Regions, One Background, One Conditioning Bundle
The Plain Single-Model ControlNet Chain Link
Texture Fill and Emboss Settings for Apt_Preset's Graphic Tools
Gradient Fills and Double Outlines for Apt_Preset's Graphic Tools
Two Inpainting Modes, and Which Mask Color Goes With Which Base Model
Cubiq's IPAdapter Presets, Bundled Into One Stack Node
Three Different Edit Instructions, Three Different Masks
Feeding a Kontext-Style Editor Up to Three Reference Images
KSampler (Advanced), Packaged for Two-Stage Sampling
The Plain KSampler, Down to Four Fields
Build Your Own Sampling Loop From Parts
Two Denoise Dials for Inpainting Instead of One
Handing Off Mid-Sample to a Second Model
One-Node Hires Fix, and the Only Node Here That Outputs a Picture
Tile-Based Hi-Res Refine in One Node
One Node for Empty Latents, Encoded Images, and Inpaint Masks
Chain Up to Three LoRAs (and Then Chain More)
Recolor Up to Three Masks for Visualization
Mask Shaping, Growing, and Range Remapping Before You Use It
Flux Redux Style Transfer With the Knobs Stock ComfyUI Doesn't Give You
Override Just the Sampling Settings You Actually Want to Change
Photoshop-Style Drop Shadow and Glow Layer Effects
Positive/Negative Prompts Plus a 300+ Style Preset Library
Tiled VAE Decode Settings, Ready to Plug Into Other Apt_Preset Nodes
Control-Video-Driven Generation on Wan 2.2
Character Animation and Replacement on Wan 2.2
Camera-Controlled I2V on Wan
Interpolate a Video Between Two Fixed Frames
Control-Video-Driven I2V on Wan 2.1
First/Last-Frame Video Inpainting on Wan 2.1
Audio-Driven Talking Video With HuMo
The Plain, Standard Wan Image-to-Video Node
Subject-Consistent Video Without Training a LoRA
Wan's Official Speech-to-Video (S2V) Node
Apt_Preset's universal model loader, and the clip-order gotcha that bites people
Clean up and batch-replace text without chaining five nodes
Cut a script into shots and index into it for prompt scheduling
Apt_Preset's YAML-backed prompt library, with find-and-replace built in
Turn a batch of masks into a list ComfyUI can loop over
Apt_Preset's on-canvas debug and node-lookup widget
Overview
The current workflow connections are becoming increasingly dense, making them difficult to understand and operate, and there are issues with poor consistency. As the number of saved workflows increases, frequent errors occur during actual use, and the operation methods need to be relearned. To address this, a plugin has been developed to simplify workflows, clarify control concepts, and design nodes around the "Loader ---- Controller ----- Sampler" framework.
<a href="./README.md">English</a> >> <a href="./README_ZH.md">中文版</a>
I. Update Record
2025.1.14 Optimize sum_load to support caching and cleaning, update AI_GLM to support the new GLM 4.7 model, and add judgment nodes to the process group
2025.01.17 sum_load and sum_edit are compatible with the latent size of Flux2_Klein
2025.1.25 Add an image batch loading manager:IO_LoadImgList
2025.1.31 update IO_LoadImgList Supports bridging, with more powerful operations
2026.3.13 add LTX2.3 video_merge: AD_video_merge
2026.3.15 Add visualization batch loading nodes :IO_LoadImgBatch、IO_LoadTextBatch、IO_LoadShotBatch
2026.3.22 Add image editing and visualization nodes
<img width="2028" height="868" alt="image" src="https://github.com/user-attachments/assets/bd2f2bb4-b82d-4297-bff8-cb40f46bbff2" /> 2026.3.29 Add Automatic Video Segmentation Node :"AD_VideoSeg": AD_VideoSeg,2026.4.27 Updated the prompt visualization tool “text_interPrompt“” to support 4 modes
<img width="2281" height="634" alt="image" src="https://github.com/user-attachments/assets/0acf9217-701e-4c30-92e2-9f5f8ea2eefe" />II. Usage Guide
1. Universal Loader Sum_load_adv, Supports GGUF Models
- Model combinations for various workflows are the same as official workflows.
① XL, SD mode: Load model checkpoint or Unet or over model.
② wan2.1, wan2.2, QwenEdit mode: Load model Unet + clip1
③ Flux\Kontext mode: Load model Unet + clip1 + clip2 (Note: In order, not clip1+clip3)
④ SD3.5 mode: Load model Unet+clip1 +clip2+clip3
⑤ Hi-dream mode: Load model Unet+clip1 +clip2+clip3+clip4
- Override mode over_model and over_clip
① When using over_model, the internal corresponding model or Unet of the loader becomes invalid and will directly output model
② When using over_clip, all internal corresponding clip1,2,3,4 of the loader become invalid and will directly output clip
- Preset saving, which can save loaded models and sampling methods uniformly
① At least one arbitrary preset must be selected, otherwise an error will occur
② After selecting any preset, all parameters can be modified and take effect arbitrarily.
③ Newly set parameters can be saved as new presets, but ComfyUI needs to be restarted to select and use them
2. Controller Stack: Functional modules with associated control tools centralized together
① General Control image Stack: Universal control for SD, XL, Flux, etc., Ipa style, redux transfer, Union_controlnet, controlnet_adv, inpaint redrawing
② General Control wan Stack: All wan video generation nodes officially supported
③ General Control AD Stack: Animatediff animation generation control, prompt scheduling, CN scheduling, IPA scheduling, etc.
④ General Control Kontext Stack: Multi-image reference, partitioned generation, redux transfer, union_controlnet
⑤ General Control QwenEdit Stack: Multi-image reference, union_controlnet
<img width="2890" height="715" alt="image" src="https://github.com/user-attachments/assets/27e6733d-4d2e-49d3-8249-8a6f86ff883f" />3. Sampler: Rich sampling methods to eliminate repetitive connections
① Basic sampler: Packages ComfyUI's built-in sampler input ports into a single port replacement, with functionality completely consistent with the official version
② Special function sampler: A combination of basic sampler + special functions.
As in the example below, operations like secondary sampling repair and refine enlargement can be achieved in one step:
4. Utility Nodes: Image, mask, data processing tools
- Data types: Data conversion, data creation,data operation
- Image processing: A powerful image processing combination: pre-processing, intermediate generation, and post-recovery
- Mask processing: Creation, conversion, and transformation of masks
III. Installation
Clone the repository to the custom_nodes directory and install dependencies
#1. Git download
git clone https://github.com/cardenluo/ComfyUI-Apt_Preset.git
#2. Install dependencies
Double-click install.bat to install dependencies
Note:
1、To use the controlNet schedule control feature, please first install ComfyUI-Advanced-ControlNet
2、To load GGUF models, please first install ComfyUI-GGUF
3、To use the load_Nanchaku node, please first install and make sure it works normal ComfyUI-nunchaku.
4、ollama model: download and put at "...comfyui\models\ollama" Download model.
5、<a id="AAA">Some nodes will use the resource expansion pack. Please download it : Apt_file. or download it here: Mask_FaceSegment 、Mask_ClothesSegment、 Mask_BodySegment Then Place the entire folder into comfyUI/models</a>
├── ComfyUI/models/Apt_File
| ├──body_segment
├── ComfyUI/models/Apt_File
| ├──segformer_clothes
├── ComfyUI/models/Apt_File
| ├──segformer_face
Disclaimer
This open-source project and its contents are provided "AS IS" without any express or implied warranties, including but not limited to warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.
Users are responsible for ensuring compliance with all applicable laws and regulations in their respective jurisdictions when using this software or publishing content generated by it. The authors and copyright holders are not responsible for any violations of laws or regulations by users in their respective locations.
Follow Me, Share Methods for Easily Building Workflows
Bilibili: https://space.bilibili.com/2008798642?spm_id_from=333.33.0.0