BD Save File

ComfyUI's built-in SaveImage only speaks IMAGE. BD Save File speaks everything the BrainDead pack actually produces - IMAGE, MASK, AUDIO, LATENT, STRING, TRIMESH - and it's the node that ties the pack's file discipline together. Whether you're caching a mesh, dumping a PBR map, or parking a prompt string next to your renders, one node does it, and it slots into the BD Save Context system so filenames stop being a mess.

What it is

A universal save node: wire in data of almost any type, it picks the right native format and writes it to disk, then hands you back the file_path as a STRING (and passes the data through unchanged). It's the same "save" node the README builds the whole caching/iteration story on.

How it works

The type determines the format - IMAGE → PNG, MASK → PNG, LATENT → safetensors, AUDIO → WAV, STRING → TXT, TRIMESH → PLY. You don't pick the format; it detects it. Where it gets interesting is context integration:

• With a BD Save Context registered and context_id matched, the path resolves from the context's template plus this node's suffix / filename / name_prefix / custom_vars. One context, N save nodes, all consistent.
• Without a context (or with zero/multiple contexts registered and an empty context_id), it falls back to legacy behavior: filename + optional name_prefix into the output folder.

The inputs that matter

• data - the any-type input. This is the whole reason to use it.
• filename - with a context it overrides %name%/%filename% in the template; without one it's the literal filename.
• context_id + suffix - _albedo, _shoes, _head. The README suggests wiring suffix from BD For Each Run.label or an iterator's tag for per-iteration filenames.
• skip_if_exists (default true) - don't clobber existing files; report the existing path instead.
• extension - override the auto-detected one, for the rare case you want a different container.
• alpha_mask / invert_alpha / save_alpha_separately - bake a mask into the saved file's alpha channel (white = opaque), and optionally write a sidecar _alpha.png. Conventions matter here: white = opaque, black = transparent, and ComfyUI's LoadImage mask output is the inverse of the subject - flip invert_alpha if your mask has white=background.

Outputs: data (passthrough, so you can chain), file_path (absolute path as a STRING - wire it into anything that wants a path), and status.

Where it shines

The README's example says it best: [BD Prompt Iterator] → [BD Qwen Character Edit] → [BD Save File] with name_prefix: MyCharacter - iterate through a character sheet and land clean, sequentially-named files. And in the PBR pipeline, five maps out of BD Derive PBR Maps all funnel into one context-aware save. If you've ever hunted through output/ for the file that SaveImage_0001 actually wrote, you'll appreciate getting a real path back.

Installing it

ComfyUI Manager: search "BrainDead" → install. Manual:

cd ComfyUI/custom_nodes
git clone https://github.com/BizaNator/ComfyUI-BrainDead
cd ComfyUI-BrainDead
pip install -r requirements.txt

Restart, find it under 🧠BrainDead/Cache. No extra dependencies beyond what ComfyUI already has - trimesh (for TRIMESH saves) ships with modern ComfyUI, and the audio/latent paths use native ComfyUI formats.