ComfyUI Node
kubakub versions
Many versions of one facade from one queue. The versions sheet lists what changes, one option per line: [look] whole-facade looks, [region windows] ideas for some regions, [rotate a | b | c] ideas that move on by one region per version, [lora] your LoRAs (name : strength : words; a chain with ' + '), [reference] style images, [image] the picture a version starts from, [set denoise] any plan setting, [seed]. Every version is the region plan plus its own rules. quality draft renders small and fast and gives a numbered contact sheet; write the numbers you like into pick, switch to final, and only those are scaled up to the full canvas and resampled tile by tile for full-size detail: a final is its draft, sharper. Versions that did not change come from the region cache.
kubakub versions
- model
- clip
- vae
- plan
- image
- references
- images
- sheet
- report
- save_path
- names
◄versions// one option per line; 'short name = text' gives it a label
[look]
copper = oxidised copper plates, verdigris, rivets
paper = folded white paper, soft daylight
moss = overgrown with moss and ivy, wet stone
[region windows]
warm rooms, people moving inside
aquariums, fish, blue light
[lora]
none
►
◄moderotate►
◄qualitydraft►
◄pick►
◄max_versions12►
◄seed0►
◄draft_mp0.50►
◄final_denoise0.40►
◄draft_long_edge1600►
◄count0►
◄sheet_columns0►
◄steps0►
◄sampler_nameeuler►
◄schedulerauto►
◄picks_folder►
◄save_folderkubakub/versions►
◄unify0.00►
◄generateregions►
◄only►
◄cfg0.0►
Categorykubakub/2d/generate
Inputs (26)
| Name | Type | Default | Description |
|---|---|---|---|
| model | MODEL | The image model (Flux 2 Klein or Qwen Image 2.1). LoRAs of the sheet are added to it per version. | |
| clip | CLIP | The text encoder that matches the model. | |
| vae | VAE | The VAE that matches the model. | |
| plan | KUBA_PLAN | From kubakub region plan: what every version has in common (the base prompt, denoise, order). Each version adds its rules. | |
| image | IMAGE | The canvas every version starts from, e.g. the clay render, exactly the size of the regions. A batch of several images (clay, wireframe, canny ...): each one is an option of the image list, like [image] in the sheet. | |
| versions | STRING | // one option per line; 'short name = text' gives it a label [look] copper = oxidised copper plates, verdigris, rivets paper = folded white paper, soft daylight moss = overgrown with moss and ivy, wet stone [region windows] warm rooms, people moving inside aquariums, fish, blue light [lora] none | The versions sheet: lists of options, one per line. See docs/generate.md (kubakub versions). |
| mode | COMBO | rotate | rotate: version n takes option n of every list (short lists start over). combine: every combination. one by one: the first option of everything, then one change at a time. |
| quality | COMBO | draft | draft: small and fast, for the contact sheet. final: the same picture at the full canvas size with full-size detail, for the picked versions. |
| pick | STRING | Version numbers to render (as on the contact sheet). Empty = all. | |
| max_versions | INT | 121–200 | The sheet never gives more versions than this (combine grows fast). |
| seed | INT | 00–18446744073709550000 | Added to the plan's seed; a [seed] list in the sheet adds to it per version. |
| draft_mp | FLOAT | 0.500.1–2 | Work megapixels per region of the draft (small = fast). |
| final_denoise | FLOAT | 0.400–1 | final: the draft is scaled up to the full canvas and resampled tile by tile at this denoise. Low stays close to the draft, higher adds more detail and changes more; 0 = the scaled-up draft. |
| draft_long_edge | INT | 1600256–8192 | The picture is made on the canvas scaled down to this long edge (draft and final); final scales it up again and adds the detail. |
| referencesopt | IMAGE | Style reference images (a batch): each one is an option of the reference list, after those written in the sheet. | |
| countopt | INT | 00–200 | rotate: how many versions; 0 = as many as the longest list. |
| sheet_columnsopt | INT | 00–16 | Columns of the contact sheet; 0 = automatic. |
| stepsopt | INT | 00–200 | 0 = the model's default (Klein 4, Qwen Image 2.1 25). |
| sampler_nameopt | COMBO | euler | Sampler for every region. |
| scheduleropt | COMBO | auto | auto: the model's own schedule (Flux 2: core's Flux2Scheduler for the crop size; Qwen Image 2.1: simple). simple, beta, sgm_uniform ...: that core scheduler, as in KSampler. qwen21_turbo_5 / pruna_qwen21_8: the trained steps of the Qwen turbo LoRAs. |
| picks_folderopt | STRING | final: a folder with the drafts you like (copy them there from the save folder). Every image in it is scaled up to the full canvas and gets its full-size detail, with the look, LoRAs and style image it was made with; the sheet and pick are not used. Empty = the numbers in pick. | |
| save_folderopt | STRING | kubakub/versions | Where the versions are saved (inside ComfyUI's output folder, or a full path): drafts as r<run>_v<number>_<what it is made of>.png, finals in the subfolder 'final'. Each file knows its version, so it can go into a picks folder. Empty = nothing is saved. |
| unifyopt | FLOAT | 0.000–1 | One more pass over the whole picture after the regions, at this denoise: it ties regions with different prompts into one structure. 0 = off; 0.3 keeps every region's idea, 0.5 and more lets them grow into each other. Costs about one more sample per version. |
| generateopt | COMBO | regions | regions: every region is repainted inside its own mask (the facade keeps its elements). whole picture: one free sample of the whole picture from nothing, with the image only as reference image 1 and the style image as image 2, no masks: forms may grow across the facade and out of it. Per-region rules then only add their words to the one prompt. |
| onlyopt | STRING | Paint only the regions matching these selectors (plan syntax: space = AND, comma = OR); the others stay as they are. Empty = all. A whole picture is still made in one piece; only its full-size detail follows this. | |
| cfgopt | FLOAT | 0.00–30 | Used where the plan says cfg = 0. 0 = the model's default (1.0). |
Outputs (5)
| Name | Type | Description |
|---|---|---|
| images | IMAGE | One image per rendered version, in number order. |
| sheet | IMAGE | The contact sheet: every rendered version with its number and what it is made of. |
| report | STRING | The lists, every version with its number, and each rendered version's rules and time. |
| save_path | STRING | The folder the versions of this run were saved to (finals: the subfolder 'final'). Empty when nothing was saved. |
| names | STRING | One line per version, in the order of 'images': its number and label, as on the contact sheet. |