AGSoft KSampler
A KSampler that hands back the receipt
- model
- positive
- negative
- latent_image
- vae
- latent
- image
- seed_str
- steps_str
- cfg_str
- sampler_str
- scheduler_str
- denoise_str
- params_json
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 optionalvae. 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.
Inputs (11)
| Name | Type | Default | Description |
|---|---|---|---|
| model | MODEL | The model used for denoising the input latent. Модель, используемая для денойзинга входного латентного изображения. | |
| seed | INT | 00–18446744073709550000 | The random seed used for creating the noise. Случайный сид, используемый для генерации шума. |
| steps | INT | 201–10000 | The number of steps used in the denoising process. Количество шагов, используемых в процессе денойзинга. |
| cfg | FLOAT | 8.00–100 | The 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_name | COMBO | The algorithm used when sampling, this can affect the quality, speed, and style of the generated output. Алгоритм, используемый при сэмплировании; может влиять на качество, скорость и стиль генерируемого изображения. | |
| scheduler | COMBO | The scheduler controls how noise is gradually removed to form the image. Планировщик определяет, как шум постепенно удаляется для формирования изображения. | |
| positive | CONDITIONING | The conditioning describing the attributes you want to include in the image. Условие, описывающее атрибуты, которые вы хотите включить в изображение. | |
| negative | CONDITIONING | The conditioning describing the attributes you want to exclude from the image. Условие, описывающее атрибуты, которые вы хотите исключить из изображения. | |
| latent_image | LATENT | The latent image to denoise. Латентное изображение для денойзинга. | |
| denoise | FLOAT | 1.000–1 | The amount of denoising applied, lower values will maintain the structure of the initial image allowing for image to image sampling. Степень применяемого денойзинга; более низкие значения сохраняют структуру исходного изображения, что позволяет использовать режим image-to-image. |
| vaeopt | VAE | The VAE model used for decoding the latent into an image (optional). VAE-модель для декодирования латента в изображение (опционально). |
Outputs (9)
| Name | Type | Description |
|---|---|---|
| latent | LATENT | The denoised latent. Деноизированный латент. |
| image | IMAGE | The decoded image (if VAE is connected). Декодированное изображение (если подключен VAE). |
| seed_str | STRING | Seed as string. Сид в виде строки. |
| steps_str | STRING | Steps as string. Количество шагов в виде строки. |
| cfg_str | STRING | CFG as string. Значение CFG в виде строки. |
| sampler_str | STRING | Sampler name. Имя сэмплера. |
| scheduler_str | STRING | Scheduler name. Имя планировщика. |
| denoise_str | STRING | Denoise level as string. Уровень денойзинга в виде строки. |
| params_json | STRING | Full parameters as JSON. Полные параметры в формате JSON. |