kijai/ComfyUI-KJNodes

What is ComfyUI‑KJNodes?

ComfyUI‑KJNodes is a plug‑in for ComfyUI, the visual node‑based interface used to build Stable Diffusion (and other generative‑AI) pipelines. The repository provides a set of extra nodes and UI helpers that make it easier to organise, optimise and debug large graphs.

Core ideas

Feature	What it does (in plain language)
Utility / QoL nodes	Small building‑blocks that perform common chores (e.g., setting and getting values, converting links) so you don’t have to wire the same pattern over and over.
Model optimisation helpers	Nodes that let you tweak model parameters or cache results without pulling in heavy external libraries.
Minimal dependencies	Only the packages listed in `requirements.txt` are needed, keeping the install lightweight.
Sub‑graph awareness	The Set/Get nodes work across nested graphs – a value set in a parent graph can be read inside any child sub‑graph, and the UI can jump between them.
Keyboard shortcuts & mouse gestures	Hotkeys like D (node insert), S (node swap), Ctrl+Shift+S/G/L for quick Set/Get creation, and middle‑click shortcuts speed up graph editing.
Visual link toggles	Virtual connections created by Set/Get pairs can be shown or hidden on demand, helping keep the canvas readable.
Canvas extensions	Right‑click menus let you convert between direct links and Set/Get pairs, batch‑convert many nodes, and add Set/Get nodes directly from the connection menu.

How to install

Clone the repository into the custom_nodes folder of your ComfyUI installation.
Run pip install -r requirements.txt (or use the portable‑install command shown in the README).
Restart ComfyUI – the new nodes appear under a KJNodes category.

Recent major update (19 Mar 2026)

The author rewrote the Set/Get system to be backwards‑compatible and to support the newer Nodes 2.0 format. Highlights include:

Cross‑sub‑graph visibility of Set/Get values.
Right‑click conversion between links and Set/Get pairs.
Batch operations for converting many outputs at once.
New settings for default widget values, type inference, and link‑visibility modes.
Improved rename handling when pasting duplicated nodes.

Who might use this?

Artists & prompt engineers building complex Stable Diffusion workflows who want a cleaner way to share constants (e.g., model names, seeds) across many nodes.
Researchers prototyping new pipeline steps and needing quick, reversible rewiring without cluttering the graph.
Power users who spend a lot of time in the ComfyUI canvas and appreciate shortcuts, visual cues, and sub‑graph navigation.

Limitations

The plugin only adds UI/graph‑management features; it does not provide new diffusion models or inference engines.
Functionality is tied to the ComfyUI version it targets – if ComfyUI’s core API changes dramatically, the nodes may need updating.

TL;DR: ComfyUI‑KJNodes is a lightweight, dependency‑light add‑on that gives ComfyUI users a richer set of utility nodes, smarter Set/Get handling across sub‑graphs, and many keyboard/mouse shortcuts to keep large AI‑generation graphs tidy and easy to edit.