Draggen Local Loader

Everything the Remote Loader does, minus the subscription, the API key, and the network. Draggen Local Loader is the free on-ramp to the whole pack: if a Draggen board has been exported to disk - yours, a client's, a collaborator's - this node reads it straight from the filesystem. No Draggen.io account, no key, no paid tier, no outbound call. For most people this is the node to reach for first.

Mechanism: point it at a folder and DraggenClient.load_local() scans for a JSON file, parses it, and builds the same DRAGGEN_MOODBOARD object the Remote Loader produces. The folder path becomes the board's base path, which matters more than it looks - the moodboard's image elements reference files, and the processors resolve those against the images/ subfolder inside that directory.

The input and output

One input:

• folder_path - the absolute path to the folder holding the exported board.

The output is the shared moodboard (DRAGGEN_MOODBOARD) type, which only connects to the pack's three processors: Draggen Board to Image, Draggen Extract Images, and Draggen Extract Text. Swap the Local Loader for the Remote Loader later and nothing downstream changes - that interchangeability is the point of the shared type.

The README frames the folder as containing a data.json plus an images/ subfolder. Reality check from the code: the loader takes the first .json file it finds in the directory, whatever it's called. Fine when there's exactly one - a trap if a second JSON has sneaked into the same folder and wins the race. Missing folder or no JSON at all means a FileNotFoundError in your console, which is at least a clear error message rather than a silent empty board.

Installing

Install is pack-wide, so it's the same two options: ComfyUI Manager → search ComfyUI-Draggen, or:

cd ComfyUI/custom_nodes
git clone https://github.com/kadima-tech/comfyui-draggen

then restart ComfyUI. No extra Python dependencies - the pack leans on requests and Pillow, both already shipped with ComfyUI.

Where it fits

Honest take: this is a convenience wrapper around a JSON parser, and it doesn't pretend otherwise. What it buys you is that a whole reference board - images, boxes, notes - collapses into one object you can route around the graph. The workflow it enables is the sane one: collect references in Draggen where that's easy, export, and let ComfyUI's batch machinery handle the rest. If you're mid-project and a style reference board needs to become conditioning input or a pile of images, this is the zero-cost entry point.