JeyzerMC-comfyui-flakes/README.md

ComfyUI Flakes

A single ComfyUI node — Flake Stack — that inserts an ordered list of reusable presets ("flakes") between a checkpoint loader and a sampler. Each flake bundles a prompt fragment, optional LoRA, optional target resolution, optional ControlNets, and optional named variant groups (e.g. outfit: winter | summer).

The goal: keep your day-to-day workflow graphs unchanged while swapping characters, poses, and styles by editing a small list instead of rewiring nodes.

Install

Via ComfyUI Manager

Search for ComfyUI Flakes and install.

Manual

cd ComfyUI/custom_nodes
git clone https://github.com/JeyzerMC/comfyui-flakes

PyYAML is the only external dependency and is already part of ComfyUI's core requirements.

The node

Flake Stack (category: flakes) takes:

Input	Type	Notes
model	MODEL	Output of a checkpoint loader.
clip	CLIP	Same.
flakes_json	STRING	Managed by the in-node grid UI — you don't edit this directly.

It returns: model, clip, positive, negative, latent, width, height — wire those into your sampler.

The widget renders a grid of flake blocks. The first block is the default flake: an inline flake that lives in the workflow itself (not on disk), holding base prompts, default dimensions, and any one-off LoRA / ControlNet settings. Subsequent blocks reference saved flakes from models/flakes/.

• + New flake — opens the editor; saves to models/flakes/<path>.yaml and adds it to the stack.
• ↑ Load existing — picker listing on-disk flakes not yet in this stack.
• Double-click a block — opens the editor. Edits to saved flakes write back to disk; edits to the default flake live in this workflow only.
• Drag any non-default block to reorder.
• ✕ removes a block from the stack (the on-disk YAML is untouched; use the modal's Delete to remove the file).

The first flake in the stack that declares a resolution wins; if none does, the default is 1024 × 1024.

Flake files

Flakes live as .yaml files under ComfyUI/models/flakes/ (auto-created on first launch). The directory layout is freeform — subfolders become part of the flake name (e.g. characters/musashi.yaml → characters/musashi).

Schema

# Optional LoRA (filename or stem under ComfyUI/models/loras/)
path: my_lora_folder/vagabond_musashi
strength: 0.9

# Prompt fragments
prompt:
  positive: "1boy, miyamoto musashi, long wild black hair, fierce eyes, scarred face, weathered ronin, daito and wakizashi, sumi-e ink shading"
  negative: "modern clothing, suit, glasses, clean shaven youth, soft features"

# Optional fixed resolution (first flake with one wins)
resolution: [832, 1216]

# Optional named variant groups; pick one variant per group from the UI
# (`options:` is also accepted as a legacy alias).
variants:
  outfit:
    ronin:
      positive: "tattered kimono, frayed hakama, travelling cloak, dusty road"
      negative: ""
    shirtless:
      positive: "shirtless, muscular torso, hakama only, sweat, training in dojo"
      negative: ""

# Optional ControlNets — image stems live under ComfyUI/input/
controlnets:
  - type: openpose
    model: control_openpose_xl.safetensors   # under ComfyUI/models/controlnet/
    image: standing_openpose                  # .png/.jpg/.jpeg/.webp under ComfyUI/input/
    strength: 0.8
    start_percent: 0.0
    end_percent: 1.0

All keys are optional except a flake must contain something useful. A pure-prompt "quality base" flake is just a prompt: block.

Joining behaviour

• Between flakes in the stack: positives are joined with BREAK, negatives with , .
• Within a flake (variant group additions to the base flake): joined with , .

This separation lets each flake act like an independent CLIP region while variants layer modifiers onto a single flake.

Folder layout example

ComfyUI/models/flakes/
├── styles/
│   └── quality_base.yaml
├── characters/
│   └── musashi.yaml
└── poses/
    └── standing.yaml

In the node UI, click + Add flake, pick styles/quality_base, then characters/musashi, then poses/standing. Reorder with ↑/↓, set per-entry strength, and pick variants from the dropdowns.

License

MIT.