Nodes/AUN ComfyUI Nodes/Inputs Refine
ComfyUI Node

Inputs Refine

The full Inputs node, plus a refinement checkpoint and split SpeedLoRA

By loz2754·Created 8 months ago·Updated a day ago· 5
Inputs Refine
    • MODEL
    • CLIP
    • VAE
    • MODEL REFINE
    • ckpt name
    • ckpt name refine
    • sampler
    • scheduler
    • cfg
    • steps
    • latent
    • width
    • height
    • seed
    • MainFolder
    • Filename
    • prefix
    • date format
    • batch size
    • name mode
    • speed lora ratio
    ckpt_name
    refine_ckptNone
    speed_lorafalse
    speed_lora_modelNone
    speed_lora_strength1.00
    speed_lora_full_bothfalse
    speed_lora_ratio1.00
    clip_skip-1
    sampler
    scheduler
    cfg2.0
    steps10
    width720
    height720
    aspect_ratio
    aspect_modeOriginal
    batch_size1
    seed0
    MainFolderMainFolder
    ManualNameName
    name_modefalse
    prefix
    date_format
    croptrue
    words1
    megapixels1.0
    multiple8
    auto_nameName

    AUNInputsRefine is AUNInputs with a second model attached. It loads the main checkpoint, creates the latent, sets all the sampler parameters, and prepares the save filename - and then also loads an optional refinement checkpoint, giving you a second MODEL output for a refinement pass. For workflows that end with a polish pass using a different model (a detail-oriented refiner, a different flavor of the same base), this collapses what would otherwise be two loader stacks plus a pile of parameter nodes into one.

    What it adds over AUNInputs

    Two things. First, refine_ckpt - an optional second checkpoint, select 'None' to skip it (in which case the node behaves like plain AUNInputs with an extra, unused output). When set, you get MODEL REFINE and ckpt name refine outputs to drive a second sampler pass. clip_skip applies to both models.

    Second, SpeedLoRA gets smarter. Beyond the usual speed_lora / speed_lora_model / speed_lora_strength, there's speed_lora_full_both - apply the full LoRA strength to both main and refine models - and speed_lora_ratio, which splits the strength between them: the main model gets that fraction, the refine model gets the remainder. That split is the feature, because a SpeedLoRA tuned for the compositor can easily fight a refiner. Give the refiner less of it, or hand it everything, per workflow. The node even outputs the resolved speed lora ratio so you can see (and log) what actually got applied.

    Inputs and outputs

    Inputs: ckpt_name, refine_ckpt, the SpeedLoRA group, clip_skip, sampler/scheduler/cfg/steps, aspect_ratio/width/height/aspect_mode, batch_size, seed, megapixels/multiple, and the save-prep set (MainFolder, ManualName, name_mode, prefix, date_format, crop, words).

    Outputs: MODEL, CLIP, VAE, MODEL REFINE, ckpt name, ckpt name refine, sampler, scheduler, cfg, steps, latent, width, height, seed, MainFolder, Filename, prefix, date format, batch size, name mode, speed lora ratio.

    Installing it

    One pack, one install:

    • ComfyUI Manager: search "AUN ComfyUI Nodes", install, restart.
    • Manual: cd custom_nodes && git clone https://github.com/loz2754/AUN-ComfyUI-Nodes, then restart.

    Manual installs and ModuleNotFoundError: cv2? pip install -r custom_nodes/AUN-ComfyUI-Nodes/requirements.txt.

    Common issues

    The README flags a specific migration gotcha here: the SpeedLoRA-related input set changed, so if you load an older workflow that uses this node, "the SpeedLoRA-related widgets may need to be checked or reconnected." That's the first thing to check when an old graph loads with odd widget states. Beyond that, the usual two-model confusion applies - if your refinement pass looks wrong, the speed_lora_ratio split is the first lever to pull, before touching denoise on the refiner. And as a full Inputs-style node, it carries the legacy save-prep contract; the pack's forward-looking recommendation is Basic nodes plus AUN Save Image V2.

    CategoryAUN Nodes/Loaders+Inputs

    Inputs (28)

    NameTypeDefaultDescription
    ckpt_nameCOMBOThe checkpoint model file to load.
    refine_ckptCOMBONoneAn optional refinement checkpoint to apply after loading the main checkpoint. Select 'None' to skip.
    speed_loraBOOLEANfalseEnable or disable SpeedLoRA optimizations.
    speed_lora_modelCOMBONoneThe SpeedLoRA model to apply. Select 'None' to disable SpeedLoRA.
    speed_lora_strengthFLOAT1.000–3Multiplier applied to the selected SpeedLoRA weights.
    speed_lora_full_bothBOOLEANfalseApply the full SpeedLoRA strength to both the main and refine models.
    speed_lora_ratioFLOAT1.000–1Share of the SpeedLoRA strength applied to the main model. The refine model receives the remaining share.
    clip_skipINT-1-24–-1Number of last layers of CLIP to skip. -1 is a good default.
    samplerCOMBOThe sampling algorithm to use.
    schedulerCOMBOThe noise schedule to use.
    cfgFLOAT2.0-2–100Classifier-Free Guidance scale. Higher values increase prompt adherence.
    stepsINT101–10000Number of sampling steps.
    widthINT72064–8192Image width. Used when 'aspect_ratio' is 'custom'.
    heightINT72064–8192Image height. Used when 'aspect_ratio' is 'custom'.
    aspect_ratioCOMBOSelect a predefined aspect ratio or ratio to automatically set width and height.
    aspect_modeCOMBOOriginalRandom swaps dimensions 50% of the time, Swap forces a swap, Original keeps the original order.
    batch_sizeINT11–64Number of latent images to generate in a batch.
    seedINT0-18446744073709550000–18446744073709550000The random seed for generation.
    MainFolderSTRINGMainFolderThe main output folder for saved files.
    ManualNameSTRINGNameThe filename to use when 'name_mode' is set to Manual.
    name_modeBOOLEANfalseSwitch between automatic and manual filename modes.
    prefixSTRINGA prefix to add to the generated filename.
    date_formatCOMBOThe format for the date placeholder in filenames.
    cropBOOLEANtrueEnable or disable cropping the filename to a specified number of words.
    wordsINT11–10The number of words to keep from the start of the string.
    megapixelsFLOAT1.00.1–16Target total megapixels used when a ratio is selected.
    multipleINT88–128Nearest multiple to round computed resolution to. Used with ratio.
    auto_nameoptSTRINGNameAutomatic name input, typically from a prompt node, used when 'name_mode' is set to Auto.

    Outputs (21)

    NameTypeDescription
    MODELMODEL
    CLIPCLIP
    VAEVAE
    MODEL REFINEMODEL
    ckpt nameSTRING
    ckpt name refineSTRING
    sampler*
    scheduler*
    cfgFLOAT
    stepsINT
    latentLATENT
    widthINT
    heightINT
    seedINT
    MainFolderSTRING
    FilenameSTRING
    prefixSTRING
    date formatSTRING
    batch sizeINT
    name modeBOOLEAN
    speed lora ratioFLOAT