Nodes/ComfyUI-Apt_Preset/sampler_enhance
ComfyUI Node

sampler_enhance

Wrap any sampler with a detail boost dial

By cardenluo·Created 2 years ago·Updated 18 days ago· 309
sampler_enhance
  • sampler
  • SAMPLER
detail_amount0.10
fade0.00
smoothtrue
cfg_scale_override0.0

This node doesn't sample anything itself - it takes an existing SAMPLER object and wraps it with a detail-injection layer, handing back a new SAMPLER you plug into your KSampler exactly like the original. The pattern is the same idea behind the community's various "add local detail without changing the overall composition" sampler wrappers: rather than cranking CFG globally (which sharpens everything, composition included, and tends to introduce artifacts), you nudge how much fine detail gets added or removed at the per-step level, independent of the big structural decisions the base sampler is already making.

How it works

You feed it a base sampler - whatever you'd normally wire straight into a KSampler, from a KSamplerSelect node or one of this pack's own sampler nodes - and it returns a modified SAMPLER that applies detail_amount as a bias during the sampling process, softened or sharpened over the run by fade. Because this operates on the sampler object rather than the image after the fact, the added detail is baked into the generation itself, not a post-process sharpen.

The inputs and outputs that matter

  • sampler (required, SAMPLER) - the base sampler to wrap. Anything that outputs a SAMPLER type works here.
  • detail_amount (required, default 0.1, range -5 to 5) - the core dial. Positive values push toward more fine detail/texture; negative values smooth it out. The wide symmetric range (-5 to 5) around a small default (0.1) tells you the useful zone is narrow - small nudges, not the extremes.
  • fade (required, default 0, range 0–1) - how much the detail effect tapers off over the course of sampling. At 0, the effect is applied consistently through the whole run; push it up to concentrate the effect early and let later steps settle back toward the base sampler's normal behavior.
  • smooth (required, default true) - whether the detail adjustment is applied smoothly across steps rather than as a hard on/off toggle at some threshold. Leave this on unless you're deliberately chasing a more abrupt, obviously-stepped effect.
  • cfg_scale_override (required, default 0, range 0–100, step 0.5) - this pack consistently uses 0 as a "leave the existing value alone" sentinel elsewhere (see pre_sample_data), and the same pattern is the sane read here: 0 means don't touch whatever CFG your KSampler is already set to, and a non-zero value forces CFG to that number specifically for this wrapped sampler.
  • Output: SAMPLER - wire it straight into your KSampler's sampler input, same as the one you fed in.

How to install it

Search ComfyUI-Apt_Preset in ComfyUI Manager, or clone it manually:

cd ComfyUI/custom_nodes
git clone https://github.com/cardenluo/ComfyUI-Apt_Preset.git

install.bat handles Windows dependencies; on Linux or Mac, read it and run the pip installs it lists, or let ComfyUI Manager fill gaps on first load. No model files needed - this is pure sampling-logic, not a checkpoint.

Common issues & troubleshooting

Detail boost introduces noise or artifacts instead of texture. detail_amount pushed too far positive is the usual cause - back it toward the low end of positive values (0.2–0.5) rather than reaching for 2 or higher on the first try. This is meant to be a fine adjustment, not a dramatic one.

No visible effect at all. Check smooth and fade aren't cancelling the effect out entirely - a high fade with a low detail_amount can end up nearly invisible by the time later steps dominate the visible result. Also confirm the base sampler you wrapped is actually the one feeding your KSampler and not a leftover unwrapped one from before you added this node.

Composition changed, not just detail. That shouldn't happen from this node in isolation - if it does alongside a cfg_scale_override you set, that's the CFG override doing what CFG does (CFG affects overall adherence and structure, not just fine detail). Set it back to 0 and control CFG from your KSampler directly if you only want the detail effect.

CategoryApt_Preset/chx_ksample

Inputs (5)

NameTypeDefaultDescription
samplerSAMPLER
detail_amountFLOAT0.10-5–5
fadeFLOAT0.000–1
smoothBOOLEANtrue
cfg_scale_overrideFLOAT0.00–100

Outputs (1)

NameTypeDescription
SAMPLERSAMPLER