Nodes/🗂️ Dict Tools/🗂️Dict → Guider
ComfyUI Node

🗂️Dict → Guider

For the advanced-sampling crowd

By Lex-DRL·Created 4 months ago·Updated 4 months ago· 1
🗂️Dict → Guider
  • dict
  • value
◄key—►
â—„cleanup_keytrueâ–ş

Guiders are an advanced corner of ComfyUI's sampling machinery. If you've used a stock KSampler, you've never seen one - it's the config object that decides how guidance is applied during sampling, and it's mostly the territory of custom sampler packs, CFGGuider-style nodes, and people who treat the sampling step as something to be tuned rather than taken for granted. DictExtractGuider ("🗂️Dict → Guider") is the dict-bus extractor for that crowd, tucked under the Extract/Advanced category.

The pattern is the same as every extractor here, just aimed at advanced sampler users. If you're building custom sampling pipelines - where a guider object is created, configured, and passed to a sampler - the guider can ride in the dict bus like any other value: store it under a key up top, extract it where the sampler needs it. For anyone running stock workflows, this node is a polite "you're not the target audience" and you can move on.

What you set

  • dict (required) - the dictionary to read from (non-empty).
  • key - the slot name.
  • cleanup_key (on by default) - normalizes the key.

Output: value as the Guider type, wired into a sampler node that accepts a guider input.

The honest framing

This node exists because the pack author decided to cover the type space thoroughly - every ComfyUI type worth carrying gets an Add and an Extract. For guider objects specifically, that's a small audience. Where it pays off is the same place all the others do: a modular sampling stack where you want the guider config (and the sampler, and the noise - the siblings in this same Advanced category) declared in one place and applied in another. If you're in the habit of swapping guiders between experiments, having them keyed in a dict makes the swap a one-edit change.

As with all the extractors here, it type-checks the stored value and raises a hard "No such key in Dict" error on a missing key. There's no downside beyond the extra hop - it just isn't useful until your sampling pipeline is exotic enough to have guider objects floating around in the first place.

Install

Standard for the whole pack - small, one lightweight dependency (frozendict), no model downloads. ComfyUI Manager: search "Dict Tools". Or:

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

Restart ComfyUI. Needs 0.18.0+ (newer extension API) - if the nodes don't show up after install, update ComfyUI first. And remember the guider has to come from wherever your sampler pack creates one; this node only carries it, it doesn't create it.

Category🗂️ Dict Tools/Extract/Advanced

Inputs (3)

NameTypeDefaultDescription
dictDICTA Dictionary to work with.
keySTRINGKey (name) of the item extracted from the dict.
cleanup_keyBOOLEANtrueAutomatically remove leading/trailing spaces and extra newlines from the key.

Outputs (1)

NameTypeDescription
valueGUIDERThe actual Guider-type item extracted from the Dict.