Eclipse KSampler (Kargim)
The sampler that lives inside the pipe
- pipe
- model
- vae
- positive
- negative
- latent
- image
- pipe
- model
- vae
- positive
- negative
- latent
- image
The KSampler is where a generation actually happens, and most of them sit there with ten loose wires feeding in. Eclipse KSampler (Kargim) is the version that plays the pipe game: you can feed it a whole context pipe and it samples, decodes, and hands back an updated pipe - so the next node in your chain starts from the state this one ended with, no re-wiring.
What it is
A full-featured sampler node (it's an output node - it runs unconditionally) with a pipe-first design. It accepts an optional pipe containing model, vae, conditioning, and sampling settings, plus direct inputs for every component. The twist is a priority system and an allow_overwrite flag that decide who wins when the pipe and your widgets disagree. It also handles the seed bookkeeping (-1 random, -2 increment, -3 decrement) and can VAE-encode an image for you if you hand it an image instead of a latent.
The "Kargim" in the name is the author's signature on a sampler preset lineage - the defaults here (res_multistep sampler, simple scheduler, 8 steps, CFG 1.0) are tuned for distilled/fast models where low-step, low-CFG sampling is the norm, so it's a natural fit for Flux and other few-step checkpoints.
How it works
The resolution logic is worth understanding, because it's the whole reason allow_overwrite exists:
- Model/vae/conditioning/latent/image sockets: a direct wire always wins over the pipe, regardless of the flag.
- Widgets (steps, cfg, seed, etc.): if the widget is physically wired from another node, the wire wins. Otherwise, with
allow_overwriteoff (default), your local widget value wins over the pipe; with it on, the pipe's values override your widgets. - Unset values fall back to the pipe, then to defaults (8 steps, CFG 1.0).
Practical translation: leave allow_overwrite off and the widgets are authoritative; turn it on when you want the pipe (say, from a Context Image) to drive everything. The output pipe is rebuilt with the resolved model, vae, conditioning, latent, image, and settings - so downstream nodes inherit exactly what was used.
It also supports tiled VAE decoding (tiled_decode, tile_size) for big images, a preview_mode toggle to hide the live preview, and it writes the resolved seed back into the workflow so reproducible runs aren't guesswork.
Inputs that matter
- pipe - optional; the context to sample from (Context Image / Context Video output).
- model / vae / positive / negative / latent - or image if you want it to VAE-encode first. Either
latentorimagemust be provided. - steps / cfg / denoise / sampler_name / scheduler / seed - the sampling recipe.
- allow_overwrite - the pipe-vs-widget priority switch.
Outputs
pipe (updated context), plus model, vae, positive, negative, latent (denoised), and image (decoded). Wire the pipe onward or grab the image straight off.
Install
Part of ComfyUI_Eclipse (formerly RvTools, rewritten in v4.0.0). Manager → ComfyUI_Eclipse → install → restart, or:
cd ComfyUI/custom_nodes
git clone https://github.com/r-vage/ComfyUI_Eclipse
Under Eclipse → Sampler. No model downloads - bring your own checkpoint.
Troubleshooting
- "A model must be provided" error: the pipe was empty and nothing was wired to
model. You need either a pipe with a model or a direct connection. - Settings ignored / unexpectedly overwritten: this is
allow_overwrite. If the pipe is driving values you thought you'd set in the widgets, flip the flag or check what the pipe contains. Remember: wired widget inputs always beat the pipe. - Preview too noisy for large batches: set
preview_modeto None; it hides the per-step previews and keeps the layout clean. - Seed keeps changing:
control_after_generatebehavior - set widget control mode to "Before" once to see the seed that actually ran.
Inputs (17)
| Name | Type | Default | Description |
|---|---|---|---|
| allow_overwrite | BOOLEAN | false | When enabled, allows values from the pipe to take priority over/overwrite local widget settings. |
| steps | INT | 81–10000 | The number of steps used in the denoising process. Overrides pipe if connected. |
| cfg | FLOAT | 1.00–100 | The Classifier-Free Guidance scale. Overrides pipe if connected. |
| sampler_name | COMBO | res_multistep | The sampling algorithm. Overrides pipe if connected. |
| scheduler | COMBO | simple | The scheduler algorithm. Overrides pipe if connected. |
| denoise | FLOAT | 1.000–1 | The amount of denoising applied. Overrides pipe if connected. |
| tiled_decode | BOOLEAN | false | Enable tiled VAE decoding to save VRAM on large images. |
| tile_size | INT | 51264–4096 | The size of the tiles used for tiled VAE decoding. |
| preview_mode | COMBO | Preview | Show the step-by-step rendering process during sampling and display the final decoded image at the end (Preview), or hide both (None) to keep the node layout clean. |
| seed | INT | 42-3–18446744073709550000 | The random seed used for creating the noise. Use -1 for random, -2 to increment, -3 to decrement. Overrides pipe if connected. |
| pipeopt | PIPE | Optional input context pipe containing model, vae, positive, negative, and sampling settings. | |
| modelopt | MODEL | The model used for denoising the input latent. Overrides pipe if connected. | |
| vaeopt | VAE | The VAE model used for decoding the latent. Overrides pipe if connected. | |
| positiveopt | CONDITIONING | The positive conditioning. Overrides pipe if connected. | |
| negativeopt | CONDITIONING | The negative conditioning. Overrides pipe if connected. | |
| latentopt | LATENT | Optional input latent to denoise. Either this or 'image' must be connected/provided. Overrides pipe if connected. | |
| imageopt | IMAGE | Optional input image to VAE-encode and denoise. Either this or 'latent' must be connected/provided. Overrides pipe if connected. |
Outputs (7)
| Name | Type | Description |
|---|---|---|
| pipe | PIPE | The updated/merged context pipe containing model, vae, positive, negative, latent, image, and sampling settings. |
| model | MODEL | The resolved model. |
| vae | VAE | The resolved VAE model. |
| positive | CONDITIONING | The resolved positive conditioning. |
| negative | CONDITIONING | The resolved negative conditioning. |
| latent | LATENT | The denoised latent. |
| image | IMAGE | The decoded image. |