🛠AGSoft KSampler options_single

🛠AGSoft KSampler options_single is the batch-test node: a little grid of rows where each row changes one sampling parameter, and the whole list runs through 🧩AGSoft KSampler as either one long queue run or one item per run.

Why bother? Because "which sampler/scheduler/steps is best on this new model" is a real question with a real answer, and it's not the one you had for the last architecture you downloaded. The most systematic community work on this is a 62-sampler × 16-scheduler sweep on Z-Image Turbo, roughly a thousand images, which concluded that on flow-matching models Karras and exponential schedules are the ones that fail rather than the ones that save you. You can copy someone else's table, or you can spend one evening generating your own. This node is the second option.

How it works

Each enabled row declares a param and a value, and the node coerces the value by type before handing it over: seed and steps become ints, cfg becomes a float, sampler and scheduler are validated against ComfyUI's own lists (a typo raises Unknown sampler 'xyz' at queue time, which is a feature), and sigmas is parsed from a comma- or newline-separated string and needs at least two numbers. Rows with an empty value are skipped, and the enabled toggle drops a row without deleting it.

Then output_mode decides the shape of what comes out:

• series (the default) - the node emits a list of override dicts. AGSoft KSampler sees a list and loops internally, decoding each item and concatenating the images into one batch. One press of Queue, twenty images.
• current - it emits a single override dict, picked by a server-side counter, and you run it repeatedly. That's one item per queue run, so you need Auto-Queue or you'll be clicking. mode chooses increment or fixed-by-index, loop wraps back to the first item at the end, and the node forces itself to re-evaluate every run in increment mode so the counter actually advances.

Your rows are also the caption source. current_str gives you one line per item in the form steps = 12, cfg = 4.5, sampler = euler - wire it into Contact Sheet and the grid tells you which image is which. status is a short human line like series: 6 items / one queue, handy on a Show Any node.

The inputs you'll actually set

output_mode, then per row: param_N, value_N, enabled_N. The rest - active_rows, index, mode, loop - are the series control widgets; active_rows is driven by the node's + Add / – Remove buttons and _sampler_list / _scheduler_list are hidden templates that exist so the UI can populate its dropdowns. You never type in those two.

Thirty rows max, and outputs are options, current_str, status.

Wire-up

options → AGSoft KSampler's options input. Everything else stays as it was; the KSampler's own widgets are the baseline and the overrides win.

Install

cd ComfyUI/custom_nodes
git clone https://github.com/Art-xmaster/comfyui-AGSoft
# restart ComfyUI

Or Manager → search comfyui-AGSoft. No extra downloads for this node.

Where people get burned

Comparing seeds instead of settings. If the point is "which sampler suits this model," the seed has to be constant across the sweep - otherwise you're comparing noise, not samplers. The KSampler's seed widget is the one in charge, so set its post-generate control to fixed (or switch the global widget control mode from After to Before, so the number you see is the number that ran). This is the single most common way a careful sweep turns into noise.

Running 30 items in series and then wanting to stop. Series mode is one queue run; the only exit is the interrupt. Start with 6 rows, look at the contact sheet, then expand. current mode exists precisely for poking at a series one image at a time.

A long series that restarts at item 1. In current mode the position is keyed to the row signature, so editing any value resets the counter to the start. That's usually what you want; it just looks like a bug the first time.

Expecting the KSampler's output labels to be per-item. The KSampler's options output is the last item only - if you want the whole series logged, take current_str from this node.