Symbiotica Regional Prompt

ERPK-style Gemini edit nodes want their prompts in a specific shape: numbered box_2d placements per region, the base sheet as image 1, per-region reference images numbered from 2. Writing that by hand is misery and it's exactly where layout edits fall apart. Symbiotica Regional Prompt turns a template bundle into that layout-aware edit prompt automatically - the strongest lever it has against position drift being set-of-mark placement dots.

How it works

From the template and the base_sheet (which becomes image 1), the node builds the ERPK Regional Prompt Builder format: each region gets a numbered box_2d placement and a prompt line, and per-region reference images get numbers from 2 onward. With placement_markers on (default), it draws a labeled colored dot at each region's center on image 1 and cites the dot in that region's prompt - set-of-mark prompting, the same trick the vision-model world converged on. The edit model places each element on its dot and paints the dot out. It's the single most effective thing this node does.

Optionally, enhance_prompts rewrites each region's client text into a dense production prompt via Claude, grounded in the task sheet - the same machinery as the pack's Prompt Enhancer, folded in.

The inputs that matter

• template (required) - the SYMBIOTICA_TEMPLATE.
• base_sheet (required) - becomes image 1.
• ref_mode - per-region reference: region_crop (crop of the task sheet at the region's box - the default), the first checked ref file, or none.
• task_sheet (optional) - where region_crop refs are cut from.
• placement_markers - the set-of-mark dots; leave on.
• enhance_prompts - the Claude rewrite step. Needs Settings → Symbiotica → ANTHROPIC_API_KEY when enabled.
• ref_framing - restyle_to_base (take the design from the reference but redraw it in image 1's style) or reproduce_exact (copy the reference as-is, ERPK parity).

The outputs

prompt (the composed edit prompt) and image (image 1 with markers), plus image_refs (the ERPK_IMAGE_REFS for an ERPK edit node's image_refs socket) and refs_batch (the same refs as one padded IMAGE batch for generic edit nodes). It also emits bboxes, masks, width/height, and the desc_1..10 / ref_1..10 pairs for the ERPK per-socket lanes.

Install

Standard pack install:

cd ComfyUI/custom_nodes
git clone https://github.com/symbiotica-ai/comfyui-nodes.git symbiotica
pip install -r symbiotica/requirements.txt

Restart, or search Symbiotica in ComfyUI Manager. The core prompt-building needs no key; the Claude enhancement does.

Gotchas

Turn placement_markers off and watch position drift come back - that's the clearest before/after experiment you can run with this node. The Claude enhancement is per-region API calls, so keep the same cost and data-leave-the-machine caveats you'd have with any LLM step; llm_seed re-rolls the rewrites while the rest of the prompt caches with the template, so bump only that when you want new text. And if you wire into an ERPK node, use image_refs (the native type), not refs_batch - the batch is for edit nodes that only speak IMAGE.