PixlStash Set Loader

PixlStash groups pictures into sets - think "all the reference shots for this character," "every reject from last week's batch," or "the 200 images I want to run a LoRA over." PixlStash Set Loader is the dropdown that picks one of those sets, and it outputs a PIXLSTASH_SET handle you can feed to a loader, a saver, a search, or the Picture Likeness Gate. It's the middle rung of the scoping ladder: Project Loader narrows to a project, Set Loader narrows within it.

How it works

Same machinery as the Project Loader. The dropdown is populated live from your PixlStash server using the credentials you set once under Settings > PixlStash (URL, API token, verify SSL). Your token is read server-side and never embedded in the workflow. A small JS extension fetches the set list and formats entries as "SetName #id"; the node strips the numeric ID with a regex and passes it along as an opaque PIXLSTASH_SET wire.

One behavior worth knowing: reference-character sets are hidden from the dropdown. Those are the sets PixlStash uses internally to define a character's face, and the pack deliberately doesn't let you pick them here - you work against a character via the Character Loader instead. If you can't find a set you know exists, that's usually why.

The inputs and outputs

• pixlstash_set (required) - the dropdown. If it shows "(loading…)", check the server connection.
• pixlstash_project (optional) - wire a Project Loader here and the dropdown shows only that project's sets.

Outputs: pixlstash_project and pixlstash_set, both pass-through wires.

Where the set handle goes

• Picture Loader - leave picture_ids empty and it auto-fetches every picture in the set.
• Picture Saver - results land back in the set, which makes the classic "generate a batch, keep the good ones" loop trivial.
• Picture Likeness Gate - this set is the reference: every generation is scored against its members.
• Semantic / Likeness Search - restrict results to the set.

Install and gotchas

Installs with the whole pack: ComfyUI Manager → search ComfyUI-PixlStash, or

cd ComfyUI/custom_nodes
git clone https://github.com/Pikselkroken/ComfyUI-PixlStash.git

then restart and configure Settings > PixlStash. No extra dependencies beyond requests and Pillow (already in ComfyUI), no model files. It talks to a running PixlStash server - the self-hosted image manager this pack fronts, originally named PixlVault - and it needs PixlStash 1.2.0+ for the API it relies on. And as with every node here, multi-user ComfyUI isn't supported: PixlStash can't tell which user ran the prompt, so it refuses rather than touch the wrong token. Single-user instances only.