Nodes/ComfyUI-PixlStash/PixlStash Project Loader
ComfyUI Node

PixlStash Project Loader

One dropdown that scopes your whole PixlStash workflow

By Pikselkroken·Created 4 months ago·Updated 5 days ago· 7
PixlStash Project Loader
    • pixlstash_project
    pixlstash_project

    If you organize your vault into projects, this is the node your whole workflow starts from. PixlStash Project Loader is a single dropdown that picks a project from your PixlStash server, and it hands the choice to every other PixlStash node downstream so they all operate inside that one project. No project discipline in your vault? You can honestly skip it. But the moment you keep separate projects for different characters, clients, or model experiments, this is the knob that stops a search or a save from bleeding across them.

    How it works

    The dropdown is populated live from your PixlStash instance - not from a static list baked into the node. Credentials live in ComfyUI Settings > PixlStash (URL, API token, verify-SSL toggle), configured once and stored server-side, so the token never shows up in node widgets or saved workflow JSON. A small JavaScript extension fetches the project list through a proxy route, and when you pick one, the selection is encoded as "ProjectName #42". The node extracts the numeric ID server-side with a regex and emits it as a PIXLSTASH_PROJECT handle - an opaque wire type you never need to look at, just pass around.

    That design detail matters for shared workflows: because the wire carries only an ID and your credentials never touch the graph, loading someone else's PixlStash workflow won't leak your token or try to use theirs.

    The inputs and outputs

    There's exactly one required input, pixlstash_project, and honestly it's the whole node. It's a COMBO dropdown; if it still says "(loading…)", your credentials or server connection are the problem, not the node.

    Output: pixlstash_project (PIXLSTASH_PROJECT).

    What you wire it into

    • Set Loader and Character Loader - restrict their dropdowns to just this project's sets and characters.
    • Picture Loader and Picture Saver - load from or save back to this project.
    • Semantic Search / Likeness Search - limit results to the project.

    Install and the usual gotchas

    Install once and it serves all nine nodes in this pack. From ComfyUI Manager, search ComfyUI-PixlStash, or:

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

    Restart ComfyUI, then set URL and token under Settings > PixlStash. The pack's only dependencies are requests and Pillow - already present in any ComfyUI install, no model downloads.

    Two things trip people up. First, the nodes talk to a running PixlStash server (self-hosted - PixlStash is the open-source image manager this pack is the ComfyUI front-end for; it was renamed from PixlVault, so older posts may say PixlVault). Second, multi-user ComfyUI isn't supported: under --multi-user these nodes refuse to run rather than risk using the wrong user's token. Run a single-user instance per PixlStash user.

    CategoryPixlStash

    Inputs (1)

    NameTypeDefaultDescription
    pixlstash_projectCOMBOSelect a project. The dropdown is populated live from your PixlStash instance.

    Outputs (1)

    NameTypeDescription
    pixlstash_projectPIXLSTASH_PROJECT