Claude
87991e8fb0
- Emphasizes testing and verification over assumptions - Documents codebase structure and development workflows - Includes critical technical patterns and anti-patterns - Stresses importance of keeping CONTEXT.md updated with failures - Warns against using pre-2025 resources for ComfyUI compatibility - Provides testing guidelines and common task workflows - References specific code locations for key functionality This guide helps future AI assistants avoid repeating mistakes by documenting what doesn't work as thoroughly as what does work.
ComfyUI Regional Conditioning
Control different parts of your image with separate prompts using visual box drawing.
Quick Start
- Install: Clone to
ComfyUI/custom_nodes/or use ComfyUI Manager - Add Node: Search for "Regional Prompter"
- Connect: CLIP → Regional Prompter → Sampler
- Draw: Use canvas to position regions, type prompts
- Generate: Connect to your sampler and run
Nodes
Regional Prompter (Mask-Based)
For: Flux, Chroma, SD3, SD3.5, Qwen-Image
Inputs:
clip: CLIP from checkpointwidth/height: Must match your latent dimensionssoften_masks: Feathering at edges (recommended ON)background_prompt: Scene descriptionregion1-4_prompt: Region-specific prompts
Tips:
- Use CFG 1.0-3.5 with Flux (higher = blur)
- Keep to 3-4 regions max for Flux/Chroma
- Default strength 0.8 works well
Regional Prompter (Area-Based)
For: SD1.5, SD2.x, SDXL
Same interface, uses area-based conditioning instead of masks.
Canvas Controls
- index: Select which region to edit
- box_x, box_y: Region top-left position
- box_w, box_h: Region dimensions
- strength: Conditioning strength (0-10, default 0.8)
Example Workflow
Checkpoint Loader
├→ CLIP → Regional Prompter (Mask-Based)
│ ├ width: 1024
│ ├ height: 1024
│ ├ soften_masks: true
│ ├ background: "city street"
│ ├ region1: "red sports car"
│ └ region2: "street vendor"
├→ MODEL → KSampler ← conditioning
└→ VAE → VAE Decode
Troubleshooting
Regions not showing:
- Check width/height match your latent exactly
- Try lower CFG (1.0-2.0) with Flux
- Verify boxes aren't outside image bounds
Validation errors:
- Ensure width/height are multiples of 64
- Check no regions overlap fullscreen
Blurry output:
- Lower CFG (Flux likes 1.0-3.5)
- Try strength 0.6-0.8 instead of 1.0
Advanced Nodes
Original nodes available for complex workflows:
- Multi Area Conditioning: Area-based, requires external CLIP encode
- Multi Area Conditioning Mask: Mask-based, requires external CLIP encode
- Multi Latent Composite: Visual latent compositing with feathering
Credits
Based on visual area conditioning by Davemane42.
Maintained by EnragedAntelope - github.com/EnragedAntelope/ComfyUI_RegionalConditioning
License
MIT License - use freely in personal and commercial projects.