Guider → Dict🗂️

ComfyUI's newer sampling stack breaks "sampling" into explicit objects: a guider, a noise source, a sampler, and a sigma schedule. DictAddGuider is the Add-side node that bundles a guider into your dict. If you're working with the advanced sampling API at all, this is how the guider (which encodes your CFG-scale and guidance strategy) travels through a bus workflow.

It's grouped under Add/Advanced in the pack menu - the pack keeps its sampling-object nodes apart from the media and model types. The GUIDER value is a wired input from a guider-producing node like BasicGuider or CFGGuider, validated against the CFGGuider family before storage.

How it works

Same Dict Tools engine as the rest of the pack: validate, store under the key, return a new frozendict without mutating your input, sort keys alphabetically on update. The guider is held by reference, so bundling it costs no meaningful memory.

The bus payoff: an advanced sampler needs guider, noise, sampler, and sigmas to all arrive at the same node. Four objects, four potential missing wires. With the four Dict Add nodes you bundle all of them into one dict, pass a single connection, and extract each at the sampler. The README's "you decide what's in the bus" framing is exactly this.

The inputs that matter

• key (STRING) - the name you'll fetch the guider back by.
• cleanup_key (BOOL, default on) - trims spaces/newlines from the key.
• dict (DICT, optional) - an existing dict to extend, or empty to start one.
• value (GUIDER, optional) - the wired guider from a guider node.

Output is dict (DICT). Get it back with DictExtractGuider.

Install

ComfyUI Manager: search Dict Tools, install, restart. Or:

cd ComfyUI/custom_nodes
git clone https://github.com/Lex-DRL/ComfyUI-DictTools

Restart after. Only dependency is frozendict, auto-installed by Manager.

Gotchas

Pack-wide: requires ComfyUI 0.18.0+ (newer node API) - and that matters double for the Advanced nodes, because the guider/noise/sampler/sigmas types themselves only exist on a reasonably current ComfyUI. If the input types don't even show up, update ComfyUI.

Also remember the snapshot rule: if you modify the guider (say, rescale CFG) after adding it to the dict, the copy in the dict is still the old one - re-add the modified object. And keep the four sampling-object types straight; this node will loudly reject a noise object where a guider belongs.