ComfyUI-Bada-Utils
A ComfyUI extension with 3 custom nodes.
Nodes (3)
π ComfyUI-Bada-Utils (Bada Suite)
<div align="center">The Ultimate All-in-One Quality of Life (QoL), Smart Presets Master Hub, Auto Model Assigner & Visual Regional Prompting Suite for ComfyUI.
Seamlessly unifying 4 flagship productivity tools into a single, high-performance package.
English Documentation β’ π°π· νκ΅μ΄ μ€λͺ μ 보기 (README_ko.md) β’ πΈ Visual Walkthrough β’ βοΈ Settings & i18n β’ π Installation
</div>π 4 Flagship Integrated Modules
ComfyUI-Bada-Utils integrates Quality of Life enhancements, master preset switching, intelligent model auto-detection, and interactive visual regional prompting to accelerate your workflow creation and generation speed.
π ComfyUI-Bada-Utils
βββ π Module 1: Visual Grid Regional Prompt Pro (Visual Grid Regional Prompt)
β βββ Diagonal drag partitioning, 10-category shot explorer, SVG silhouette preview, 6 AI format outputs
βββ π Module 2: Universal Smart Presets & Master Hub (Universal Smart Presets)
β βββ 24px slim on-canvas radio switcher, Ctrl+drag batch snapshot, 2-tier roof badges, global presets
βββ β‘ Module 3: Auto Model & LoRA Assigner (Auto Model Assigner)
β βββ Missing model detection on workflow load, intelligent fuzzy matching (%), folder tree explorer
βββ β¨ Module 4: Quality of Life (QoL) Master (Quality of Life Utils)
βββ Workflows+ sidebar explorer (drag-and-drop / 0-item folder preservation), active tracking, blank startup, mouse pan/zoom fixer
πΈ Module Visual Guides & Features
π Module 1. Visual Grid Regional Prompt Pro (BadaRegionalPrompt)
<p align="center"> <img src="docs/images/vrp/node_overview.png" alt="Visual Grid Regional Prompt Node Overview" width="850"> </p>Interactive multi-panel spatial composition prompt generator
(Optimized for Krea 2, MiniMax, Flux, SD3, ComfyUI BREAK, Midjourney, Imagen 3, ChatGPT, Gemini)
π Key Features
- π±οΈ Click & Drag Interactive Area Partitioning:
- Click and drag diagonally across grid cells to immediately create neon-highlighted rectangular areas.
- π 10-Category Character Sheet Shot Explorer:
- Windows Explorer-style collapsible tree with real-time keyword search:
- π€ Face & Head (Hair to Collarbone): Front, Profile, 3/4 View, High Angle, Low Angle, Back Head
- ποΈ Extreme Macro Close-up: Front, Side, 3/4 View
- π Bust Shot: Front, Profile, 3/4 View, High/Low Angle
- π Waist Shot: Front, Profile, 3/4 View, High/Low Angle
- β¨ Chest & Neckline: Front, Side, 3/4 View, High/Low Angle
- π§ Full Body Turnaround: Front, Side, 3/4 View, Back View, Walking Pose
- 𦡠Lower Body (Hips to Legs): Front, Side, 3/4 View, Back View, Dynamic Pose
- π Hips & Buttocks: Front Pelvis, Side Hip, Back View, Low Angle
- ποΈ Hands & Fingers: Back of Hand, Palm
- π¦Ά Feet & Toes: Barefoot Top, Sole, Front, 3/4, Side
- Windows Explorer-style collapsible tree with real-time keyword search:
- π§ Vector SVG Silhouette Dynamic Viewer: Full body, macro face, bust, hands, feet, and seated poses render dynamic SVG silhouettes with automatic 16:9, 9:16, and 1:1 aspect ratio scaling.
- π¨ 5 Art Styles & White Backdrop Lock: Hyper-realistic, Semi-realistic, 2D Anime, Concept Art, 3D CG β your
White Backdroptoggle remains permanently preserved across style changes. - π€ Master Character Profile Anchor: Global top input bar enforces character facial, hair, and costume consistency across all partitioned panels.
- π§© 6 Multi-AI Formats:
- Natural Spatial: Krea 2, MiniMax, Gemini, GPT-4o, Flux, Midjourney.
- ComfyUI / SD BREAK:
(prompt:1.1) BREAKsyntax. - Structured Tags:
[Area 1 | LEFT (50% W, 100% H)]. - Coordinates Bounding Box:
<area_1 bbox="[0.0, 0.0, 0.5, 1.0]">. - Comma-Separated List and Raw JSON.
π Module 2. Universal Smart Presets & Master Hub (BadaPresetHub & SmartPresets)
<p align="center"> <img src="docs/images/usp/01_universal_hub_node.png" alt="Universal Preset Hub Node" width="600"> </p>Wire-free master controller that switches complete workflow configurations with a single click
π Key Features
- π On-Canvas 24px Ultra-Slim Radio Switcher (Fast Groups Style):
- Instantly switch complete workflow parameter snapshots right on the canvas without opening modal dialogs.
- π― 2 Canvas Selection Modes for Instant Snapshot:
Ctrl + Mouse Drag(Box Area Selection): Drag a box around dozens of nodes to capture them all (π― Canvas Selection: 11 Nodes).Ctrl + Mouse Click(Multi-Node Point Selection): Select only the required nodes (Checkpoints, VAE, KSampler, etc.).
- π£ Full Bypass & π΄ Mute Branch Support:
- Effortlessly store and toggle execution states (Active, Bypass, Mute) for upscalers, detailers, and face enhancers across different presets.
- π Universal Preset Hub Manager:
- Review node pill tags, reorder (β²/βΌ), rename (βοΈ), and export/import
.jsonbackup profiles.
- Review node pill tags, reorder (β²/βΌ), rename (βοΈ), and export/import
- π·οΈ 2-Tier Roof Badges:
- Canvas nodes automatically display
[π N](Global Presets count) and[π N](Universal Hub linkage count) badges for 1-click modal popup access.
- Canvas nodes automatically display
- π Per-Node Global Presets & Parameter ON/OFF Pill Toggles:
- Access node-specific global presets via right-click context menu.
- Disable
seed(strike-through) to keep the active seed while injecting steps, cfg, sampler, and scheduler.
- π§ 3-Tier Smart Node Matching Engine:
Tier 1 (Node ID)βTier 2 (Title + Type)βTier 3 (Left-to-Right Canvas Coordinate Mapping)ensures 100% collision-free preset restoration on third-party workflows.
β‘ Module 3. Auto Model & LoRA Assigner (Auto Assigner)
Automatically detect missing models upon loading external workflows and link them to local files in 1 click
| 1. Right-Click Blank Canvas (Batch Assign) | 2. All Models Batch Smart Match Modal |
| :---: | :---: |
|
|
|
| Click β‘ Auto-Assign All Models/LoRAs at the bottom | Scans missing models with 100% path matching & similarity rankings |
| 3. Right-Click Specific Node (Single Node) | 4. Single Node Smart Match Modal |
| :---: | :---: |
|
|
|
| Click β‘ Auto-Assign This Node | Instantly inspect and swap models for the selected node |
π Key Features
- π² Windows Explorer-Style Folder Tree Explorer:
- Browse model directory hierarchies with auto-expand and instant highlighting for currently active model files.
- π§© Universal Slot Adapter for Third-Party Multi-LoRA Nodes:
- Full support for
Power Lora Loader (rgthree),DaSiWa LoRA Loader,Deno Multi LoRA Loader,Comfyroll,Efficiency Nodes, and custom loader stacks.
- Full support for
- π§ Intelligent Fuzzy Matcher:
- Normalizes precision (
fp8,bf16,fp16), version (v1,v2,turbo), and punctuation to recommend the best local match sorted by similarity (%).
- Normalizes precision (
- π 1-Click Smart Web Search:
- Cleaned model filenames with instant search links to
π Google Search,π€ HuggingFace, andπ Civitai.
- Cleaned model filenames with instant search links to
- π‘οΈ Automatic Red Error Border Removal:
- Instantly removes red error outlines and refreshes canvas widgets once models are assigned.
β¨ Module 4. Quality of Life (QoL) Master (Workflows+ & Canvas Fixer)
Sidebar workflow manager, active workflow live tracker, clean startup canvas & global mouse fixer
π Native Workflows vs Enhanced Workflows+ Comparison
| Feature | π Native Workflows Tab | β¨ Enhanced Workflows+ Tab |
| :--- | :---: | :---: |
| Native State Preserved | 100% Native | 1-Click Tab Switch (Workflows β Workflows+) |
| Empty Folders (0 items) | β Hidden when empty | β Preserved with grey item count badge |
| Mouse Drag & Drop | β Not supported | β Drag to any folder or Root dynamically |
| Hover Auto-Expand | β Not supported | β 1.2s hover auto-opens subfolders |
| Font & Row Size Control | β Fixed | β 4-level size switch (Aβ» ~ AβΊβΊ) with persistence |
| Active Workflow Tracking | β Manual search | β π― Real-time auto-focus & smooth scroll into view |
| Favorites (β/β
) | β Basic | β 100% 2-way live sync with native SQLite DB |
| Context Menu | β Basic | β Load / Move to / Favorite / Rename / Delete |
πΈ Feature Highlights
-
(1) β¨ Workflows+ Explorer & ποΈ Quick Toolbar:
<p align="center"> <img src="docs/images/qol/02_workflows_plus.png" alt="Enhanced Workflows+ Tab" width="380"> <img src="docs/images/qol/04_toolbar_menu.png" alt="Quick Toolbar" width="380"> </p> * π― **Focus Active Workflow**: Smoothly scrolls to and highlights the currently active workflow in bright green. * **`AβΊβΊ` Font & Row Scaling**: Left-click cycles through 4 levels (`Aβ»` to `AβΊβΊ`), right-click opens quick selector. * β **New Folder**, π **Expand/Collapse All**, π **Refresh**. -
(2) π±οΈ Drag & Drop Folder Moving:
<p align="center"> <img src="docs/images/qol/05_drag_and_drop.png" alt="Drag and Drop Moving" width="380"> <img src="docs/images/qol/03_context_menu.png" alt="Context Menu" width="320"> </p> * Drag files with mouse ghost badge to `π Root` dropzone or target subfolders. * Hovering over a collapsed folder for 1.2s automatically expands it. -
(3) π― Real-Time Active Workflow Focus & Favorites Sync:
<p align="center"> <img src="docs/images/qol/06_active_workflow_focus.png" alt="Active Workflow Auto Focus" width="500"> </p> * Automatically marks the open workflow with a blue `[β’ Active]` badge and centers it in the view. * 100% two-way synchronized with native ComfyUI SQLite database (`comfyui.db`) and favorites bar. -
(4) π§Ό Clean Blank Canvas Startup:
- Eliminates startup missing model errors ("2 errors found") and starts with a clean, empty canvas.
-
(5) π±οΈ Global Canvas Mouse Pan & Zoom Fixer:
- Prevents middle-click panning and wheel zooming from freezing over textareas, DOM widgets, or custom nodes.
βοΈ BADA Unified Settings (βοΈ Settings -> π Bada Utils)
Open the ComfyUI Settings dialog (βοΈ Settings) and select the π Bada Utils tab to access the centralized bilingual control center:
π 5 Control Sections Overview
| Section | Setting Item | Description |
| :--- | :--- | :--- |
| 1. General (μΌλ°) | π UI Language (UI μΈμ΄ μ€μ ) | Switch display language between English (μμ΄) and νκ΅μ΄ (Korean). Operates independently from ComfyUI native locale to ensure complete UI consistency. |
| 2. Smart Features (μ€λ§νΈ κΈ°λ₯) | π Sidebar Workflow Folder Management<br>(μ¬μ΄λλ° μν¬νλ‘μ° ν΄λ μ 리 λ° μ΄λ) | Enables drag-and-drop workflow folder organization, 0-item folder preservation, and Workflows+ tabs in the left sidebar. |
| 3. Workflow & QoL (μν¬νλ‘μ° & νΈμμ±) | π±οΈ Smooth Mouse Pan & Wheel Zoom Fixer<br>(λ§μ°μ€ ν μ€ & μ€κ° λ²νΌ ν¨λ 보μ κΈ°) | Fixes middle-click panning and wheel zoom freezes even over textareas, DOM widgets, and custom nodes. |
| 4. Startup Behavior (μμ νκ²½) | π§Ό Clean Blank Canvas Startup<br>(μμ μ ν΄λ¦° λΉ μΊλ²μ€λ‘ μ΄κΈ°) | Starts ComfyUI and new tabs with a clean blank canvas, completely preventing annoying missing-model startup errors (2 errors found). |
| 5. Global Presets<br>(κΈλ‘λ² ν리μ
λ±λ‘ νν© λ° κ΄λ¦¬) | ποΈ Inline Overview & Management Panel | Full-width interactive preset summary across all node types. Features 1-click Collapse/Expand, Backup All (JSON), Import, and Open Full Popup. |
[!NOTE] π‘ Recommended ComfyUI Canvas Mode:
Likergthree-comfyand other advanced visual canvas suites, Classic Canvas Rendering (Nodes 1.0) is recommended for the best interactive experience.
If you have experimental Nodes 2.0 enabled in ComfyUI Settings (βοΈ -> Use New Nodes 2.0), please set it to Disabled (OFF) for full interactive grid dragging and on-canvas radio buttons.
π Included Example Workflow
Drag and drop workflows/visual_grid_prompt_workflow.json directly onto your ComfyUI canvas to immediately test the full regional prompt character turnaround pipeline.
π Installation
Method 1: 1-Click Symlink Installer (Windows Recommended)
Double-click install_junction.bat in the repository root to automatically link ComfyUI-Bada-Utils into your ComfyUI/custom_nodes/ directory.
Method 2: ComfyUI Manager
- Open ComfyUI Manager.
- Search for
ComfyUI-Bada-Utilsand click Install. - Restart ComfyUI and press
Ctrl + F5(Hard Refresh) in your browser.
Method 3: Git Clone
cd ComfyUI/custom_nodes
git clone https://github.com/bada-ya/ComfyUI-Bada-Utils.git
π‘οΈ 100% Backward Compatibility
All existing workflows built with UniversalPresetHub, VisualGridPromptNode, or VisualGridPrompt load seamlessly with zero missing node errors thanks to built-in class alias resolution.
π License
This project is open-sourced under the MIT License.