Nodes/comfyui-AGSoft/AGSoft KSampler
ComfyUI Node

AGSoft KSampler

A KSampler that hands back the receipt

By Art-xmaster·Created 12 months ago·Updated a day ago· 23
AGSoft KSampler
  • model
  • positive
  • negative
  • latent_image
  • vae
  • latent
  • image
  • seed_str
  • steps_str
  • cfg_str
  • sampler_str
  • scheduler_str
  • denoise_str
  • params_json
seed0
steps20
cfg8.0
sampler_name
scheduler
denoise1.00

ComfyUI's stock KSampler is fine until you want to know what you actually ran. Seed, steps, CFG, sampler, scheduler, denoise - they're all sitting in widgets, but if you want them in a log, a filename, or a workflow summary, you have to wire each one out by hand. AGSoft KSampler is a drop-in KSampler that also hands you every parameter as strings and JSON. If you've ever stared at a folder of outputs wondering which settings made which image, this is the node that answers.

What you get

The sampling side is stock behavior: model, positive/negative conditioning, latent_image, seed (with control-after-generate), steps, cfg, sampler_name, scheduler, denoise - all standard, and it uses ComfyUI's own common_ksampler under the hood, so results match what you'd get from a normal sampler. The deltas are the outputs.

  • latent - the denoised latent, same as stock.
  • image - a decoded image, if you connect the optional vae. That's a genuinely useful convenience: sampler + VAE decode in one node, no separate VAE Decode needed.
  • Then the receipt: seed_str, steps_str, cfg_str, sampler_str, scheduler_str, denoise_str - every parameter as a string you can splice into a filename, a text label, or a Save Image caption.
  • params_json - the whole lot as a JSON document, ready for structured logging or auto-generated workflow notes.

The design intent is obvious from the output list: this is a node for people who treat generation as an experiment and want provenance attached. It's the difference between "I ran something" and "I ran euler_ancestral, seed 42, CFG 7.5, 28 steps."

One honest caveat

If you don't connect the VAE, the image output is a 1×1 dummy tensor - the node deliberately avoids crashing and just hands back a placeholder. So if you wire image somewhere without a VAE connected, you'll get a black pixel, not a preview. Use the latent output plus a real VAE Decode in that case, or connect the VAE.

Installing it

Pack standard: ComfyUI Manager → search comfyui-AGSoft → install, restart. Or:

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

No models, no dependencies beyond ComfyUI's core - it's a thin wrapper over the built-in sampler.

Common issues

The VAE dummy-tensor behavior above is the one that'll catch you. Other than that, it behaves exactly like a stock KSampler, so any sampler troubleshooting you already know applies. If you're comparing results against another KSampler in the same graph, remember seed still respects control-after-generate, so both nodes will change seed together when you hit queue. And for style-transfer or img2img use, denoise below 1.0 works as expected - the logging just records what you set, which is the point.

CategoryAGSoft/Utility

Inputs (11)

NameTypeDefaultDescription
modelMODELThe model used for denoising the input latent. Модель, используемая для денойзинга входного латентного изображения.
seedINT00–18446744073709550000The random seed used for creating the noise. Случайный сид, используемый для генерации шума.
stepsINT201–10000The number of steps used in the denoising process. Количество шагов, используемых в процессе денойзинга.
cfgFLOAT8.00–100The Classifier-Free Guidance scale balances creativity and adherence to the prompt. Higher values result in images more closely matching the prompt however too high values will negatively impact quality. Масштаб Classifier-Free Guidance (CFG) балансирует между креативностью и следованием промпту. Более высокие значения дают изображения, точнее соответствующие промпту, но чрезмерно высокие значения ухудшают качество.
sampler_nameCOMBOThe algorithm used when sampling, this can affect the quality, speed, and style of the generated output. Алгоритм, используемый при сэмплировании; может влиять на качество, скорость и стиль генерируемого изображения.
schedulerCOMBOThe scheduler controls how noise is gradually removed to form the image. Планировщик определяет, как шум постепенно удаляется для формирования изображения.
positiveCONDITIONINGThe conditioning describing the attributes you want to include in the image. Условие, описывающее атрибуты, которые вы хотите включить в изображение.
negativeCONDITIONINGThe conditioning describing the attributes you want to exclude from the image. Условие, описывающее атрибуты, которые вы хотите исключить из изображения.
latent_imageLATENTThe latent image to denoise. Латентное изображение для денойзинга.
denoiseFLOAT1.000–1The amount of denoising applied, lower values will maintain the structure of the initial image allowing for image to image sampling. Степень применяемого денойзинга; более низкие значения сохраняют структуру исходного изображения, что позволяет использовать режим image-to-image.
vaeoptVAEThe VAE model used for decoding the latent into an image (optional). VAE-модель для декодирования латента в изображение (опционально).

Outputs (9)

NameTypeDescription
latentLATENTThe denoised latent. Деноизированный латент.
imageIMAGEThe decoded image (if VAE is connected). Декодированное изображение (если подключен VAE).
seed_strSTRINGSeed as string. Сид в виде строки.
steps_strSTRINGSteps as string. Количество шагов в виде строки.
cfg_strSTRINGCFG as string. Значение CFG в виде строки.
sampler_strSTRINGSampler name. Имя сэмплера.
scheduler_strSTRINGScheduler name. Имя планировщика.
denoise_strSTRINGDenoise level as string. Уровень денойзинга в виде строки.
params_jsonSTRINGFull parameters as JSON. Полные параметры в формате JSON.