ComfyUI-Bada-Utils
All-in-One Quality of Life, Smart Presets Hub, Auto Model Assigner & Visual Regional Prompting Suite for ComfyUI
Nodes (5)
A prompt desk that never touches your VRAM
Google Translate inside your graph — no API key, no pip install
A Node With No Inputs, No Outputs, and No Wires
It Builds the Prompt, Not the Mask
The Legacy Node That Isn't Actually Legacy
🌊 ComfyUI-Bada-Utils (Bada Suite)
<div align="center">💡 "A pragmatic collection of utilities crafted to fix small, annoying friction points discovered while building workflows in ComfyUI every single day."
English Documentation • 🇰🇷 한국어 설명서 보기 (README_ko.md) • ⚙️ Settings & i18n • 🚀 Installation
</div> <p align="center"> <img src="docs/images/bada_banner.png" alt="ComfyUI-Bada-Utils Suite Banner" width="100%"> </p>🧭 8 Flagship Tools Overview
For quick evaluation, here is what each tool does and when to use it.
Click [📖 Detailed Guide & Settings] on any item to expand in-depth instructions, visual guides, and screenshots.
⚓ ComfyUI-Bada-Utils (8 Flagship Modules)
├── 1. 📐 Visual Grid Regional Prompt Pro (BadaRegionalPrompt)
├── 2. 🌟 Universal Smart Presets & Master Hub (BadaPresetHub & SmartPresets)
├── 3. 🩺 Node Smart Care (Auto Model Assigner & Missing Node Resolver)
├── 4. 📂 Next-Gen Smart Workflow Manager (Workflows+)
├── 5. ✨ Canvas & Clipboard QoL Master (Canvas & Image QoL)
├── 6. ⚓ Bada Async Gemini Studio (BadaAsyncGeminiStudio)
├── 7. 🌐 Bada Google Translator (BadaGoogleTranslator)
└── 8. 🛡️ PrimeVue Tooltip Bug Auto-Healer (Tooltip Healer)
1. 📐 Visual Grid Regional Prompt Pro (BadaRegionalPrompt)
- What it does: Click and drag across a grid right on your canvas to partition regions and assign 10-category body/shot angles to visually compose complex spatial prompts.
- When to use it: When designing character turnaround sheets (full body, macro face, side, rear) with rock-solid consistency, multi-panel comic spreads, or positioning elements precisely.
🌟 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:
- 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
- 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.
2. 🌟 Universal Smart Presets & Master Hub (BadaPresetHub & SmartPresets)
- What it does: Switches entire workflow node parameter configurations (checkpoints, samplers, LoRAs, upscalers) with a single click on an on-canvas slim radio bar without messy wires.
- When to use it: When switching between SD1.5, SDXL, and Flux settings on a single canvas in one click, or toggling high-res upscale and detailer branches (Bypass/Mute) instantly.
🌟 Key Features
- 🔘 On-Canvas 24px Ultra-Slim Radio Switcher:
- 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: N 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.
3. 🩺 Node Smart Care & Workflow Doctor (Node Smart Care)
- What it does:
- Unifies missing custom node recovery and model/LoRA auto-assignment into a single, clean right-click context menu:
🩺 [Bada] Node Smart Care. - Intelligently detects the user's action and automatically routes between 4 specialized scenarios:
- Right-click empty canvas: Scans the entire workflow and opens a 3-tab modal (
📦 Models & LoRAs,🧩 Missing Nodes,🌐 All-in-One View). - Right-click missing node (red X): Runs a 6-tier search across 40,000+ manager mappings to find the GitHub repo, offering 1-click ComfyUI Manager installation and live "Already Installed" card sync.
- Right-click installed model node: Opens the Windows Explorer-style local folder tree with similarity ranking (%) to auto-mount models/LoRAs and remove red error outlines.
- Right-click missing node with model slots: Prioritizes custom node installation (Priority 1) so the node can be restored before assigning models.
- Right-click empty canvas: Scans the entire workflow and opens a 3-tab modal (
- Fixes ComfyUI's core transparency bug where
#fff0transparent text inLabel (rgthree)turns into an opaque blinding white rectangle, rendering custom author fonts and styling gracefully on the canvas. - Zero canvas clutter: Operates 100% on-demand from the context menu with no intrusive badges on your graph.
- Unifies missing custom node recovery and model/LoRA auto-assignment into a single, clean right-click context menu:
- When to use it: When loading external workflows from Civitai or GitHub that contain uninstalled custom nodes (red X) or missing models/checkpoints, and you want to resolve both in seconds without switching tools.
🎯 4-Case Intelligent Context Menu Routing (🩺 [Bada] Node Smart Care)
| Scenario | Trigger | Action & Interface |
| :--- | :--- | :--- |
| Case 1: Workflow-Wide Diagnosis | Right-click blank canvas | Opens 3-tab Workflow Doctor (📦 Auto-Assign Models, 🧩 Missing Nodes, 🌐 All-in-One View). |
| Case 2: Specific Missing Node | Right-click red 'X' missing node | Focuses solely on finding that missing package with 1-click install card. |
| Case 3: Specific Model Node | Right-click installed model/LoRA node | Opens local directory folder tree and similarity matcher for immediate assignment. |
| Case 4: Missing Node with Model Slots | Right-click missing node with model inputs | Priority 1: Prompts custom node installation first since models cannot attach to missing nodes. |
🌟 Key Features
- 🧩 3-Tab Workflow Doctor (Scroll-Safe & Responsive):
- Instantly switch between
[📦 Models & LoRAs],[🧩 Missing Nodes], and[🌐 All-in-One View]. - Built-in
scrollTop = 0guarantees the modal never unexpectedly jumps to the bottom.
- Instantly switch between
- 🧠 6-Tier High-Speed Repository Matching Engine:
Tier 1 (Exact Class Type Match)➔Tier 2 (Namespace Decomposition)➔Tier 3 (Core Keyword Tokenization)➔Tier 4 (Package Title Match)➔Tier 5 (Manager nodename_pattern Regex)➔Tier 6 (GitHub Stars Popularity Weighted Ranking).- Features client-side dual-layer fallback querying ComfyUI Manager
/v2/customnode/getmappingsdirectly.
- ⚡ 1-Click Direct Installation & Real-Time "Already Installed" Multi-Card Sync:
- 1-Click Direct Install: Executes
git cloneandpip install -r requirements.txtin the background with live progress indicators. - Real-Time Sibling Sync: When installing a package, all other cards in the workflow referencing the same repository automatically update to
[✅ Already Installed (Resolved Together)]with neon status pills, preventing duplicate installation attempts.
- 1-Click Direct Install: Executes
- 🌲 Windows Explorer-Style Folder Tree Explorer & Fuzzy Matcher:
- Browse model directory hierarchies with auto-expand and instant highlighting for currently active model files.
- Normalizes precision (
fp8,bf16,fp16), version (v1,v2,turbo), and punctuation to recommend the best local match sorted by similarity (%). - Full support for third-party multi-LoRA stacks (
Power Lora Loader (rgthree),DaSiWa,Deno,Comfyroll,Efficiency Nodes).
- 🎨
Label (rgthree)Transparency Healer & Graceful Typography:- Intercepts
LGraphNode.prototypecolor getters to prevent ComfyUI's modern frontend from forcingopacity: 0.95on#fff0transparent text. - Respects original author font size (e.g. 129px, 37px), alignment, and color for clean, beautiful workflow title rendering.
- Intercepts
- 🚀 Zero-Overhead & Clean Canvas:
- Zero permanent canvas badges or polling intervals — lightweight, event-driven, and completely out of your way until called.
4. 📂 Next-Gen Smart Workflow Manager (Workflows+)
- What it does: Preserves 0-item empty folders, enables mouse drag-and-drop workflow folder moving, 1.2s hover auto-expansion, real-time active workflow auto-focusing, 100% two-way native SQLite favorites sync, and 4-tier font/row scaling.
- When to use it: When organizing hundreds of workflow files cleanly into folders, when empty folders disappearing is frustrating, or when you need to locate the active open workflow's folder in 1 second.
📊 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_search_highlight.png" alt="Enhanced Workflows+ Tab & Live Search Highlight" width="420"> </p> * 🔍 **Live Search & Keyword Highlighting**: Typing into the search bar instantly highlights matching text with vibrant yellow tags, allowing you to visually spot target workflows across dozens of folders in seconds. * 🎯 **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:
- Drag files with mouse ghost badge to
🏠 Rootdropzone or target subfolders. - Hovering over a collapsed folder for 1.2s automatically expands it.
- Drag files with mouse ghost badge to
-
(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.
5. ✨ Canvas & Clipboard QoL Master (Canvas & Image QoL)
- What it does:
- 🖼️ Clipboard (Ctrl+V) & LoadImage Auto-Error Fixer: Auto-heals red error borders and "Missing Media" validation failures caused by pasting web/clipboard images into
LoadImagenodes. - 🧼 Clean Blank Canvas Startup: Completely blocks ComfyUI's annoying startup missing-model error popups ("2 errors found") and starts fresh with a lightweight, clean canvas.
- 🖱️ Global Canvas Mouse Pan & Zoom Fixer: Keeps middle-click panning and wheel zooming smooth and unblocked even over textareas or custom nodes.
- 🖼️ Clipboard (Ctrl+V) & LoadImage Auto-Error Fixer: Auto-heals red error borders and "Missing Media" validation failures caused by pasting web/clipboard images into
- When to use it:
- When copying images from the web and pressing
Ctrl+VonLoadImagenodes (no more red error outlines!). - When you want to eliminate the useless default AuraFlow template and missing-model popups every time you launch ComfyUI.
- When organizing workflow layouts and preventing wheel zoom or pan freezes over text inputs.
- When copying images from the web and pressing
🌟 Key Features
-
(1) 🖼️ Clipboard (Ctrl+V) & LoadImage Auto-Error Fixer (
LoadImage Fixer):- In native ComfyUI, pasting an image from your clipboard into a
LoadImagenode often triggers red outline validation errors because the frontend fails to recognizepasted/...subpaths. - Bada Utils automatically intercepts
LoadImage,LoadImageMask, andLoadImageOutputcombo widgets to register the pasted file path and immediately clear the red error border (Auto-Heal).
- In native ComfyUI, pasting an image from your clipboard into a
-
(2) 🧼 Clean Blank Canvas Startup (
Clean Blank Startup):- Completely blocks the annoying
2 errors foundpopup caused by ComfyUI v1.48+ forcing the uninstalled AuraFlow blueprint template (10 nodes) on startup. - Ensures initial launches, new tabs, and closed tabs open to a clean, lightweight blank canvas for an uncluttered working environment. (Can be toggled in BADA Settings).
- Completely blocks the annoying
-
(3) 🖱️ Global Canvas Mouse Pan & Zoom Fixer:
- Prevents middle-click panning and wheel zooming from freezing over textareas, DOM widgets, or custom nodes.
6. ⚓ Bada Async Gemini Studio (BadaAsyncGeminiStudio)
- What it does: Formulates high-end cinematic video and photorealistic image prompts with 4 dedicated engines (MiniMax H3, LTX-Video, KREA 2, Uncensored Gemini Chat) without VRAM impact or execution blocks, with 1-click CLIP injection.
- When to use it: When English prompt phrasing is tedious, when you want automatic multi-cut storyboard division for KREA 2, or when brainstorming freely with zero censorship and directly injecting outputs into canvas CLIP nodes.
🌟 4 Dedicated Engine Tabs
- 🎬 ● MiniMax H3 (Video + Audio):
- 5 submodes:
Ref2VA(all-in-one ref),T2VA(text),I2VA(first frame),FL2VA(first-last loop),L2VA(last landing) - 1~30s (up to 721 frames) target duration slider
- 5 submodes:
- 🎥 ● LTX-Video 2.5 (DiT Video):
- Combines 6 cinematic elements: Shot, Lighting, Action, Subject, Camera, Sound
- Supports
LTX 2.5,LTX T2V,LTX I2V,Voice & Audio,Camera Master
- 🟢 ● KREA 2 (Photorealism):
- 🌐 General: 6 curated art style chips (35mm Film, Raw Snapshot, Vintage Retro, Digital Art, 3D Render, Cyberpunk)
- 📜 System Prompt: 5 verified directive cards (Cinematic Anamorphic, Raw UGC, Octane 3D, 90s Polaroid, Vogue Editorial)
- 🎞️ Storyboard: Analyzes scenario and partitions it into 2~15 continuous cuts with individual prompt card views
- ✨ Uncensored Gemini (Google AI Studio-Direct Chat):
- 100% uncensored open conversation with
BLOCK_NONEsafety overrides - 4 specialized Gem personas (Universal, Cinematic Director, Fashion Lookbook, Scenario Writer)
- Real-time Google Search grounding with live web citations
- 100% uncensored open conversation with
🌟 Core Pipeline Features
- 🛡️ 3-Pass Zero-Refusal Pipeline:
- Pass 1: Direct ➔ Pass 2: Cinematic VFX Override ➔ Pass 3: Artistic Metaphor automatic multi-tier fallback bypasses refusal filters completely.
- ⚡ Independent Asynchronous Execution:
- Runs independently on backend REST APIs with Zero VRAM usage and zero ComfyUI queue blockage.
- ➡️ 1-Click Send to Active CLIP:
- Injects the generated English prompt directly into the active
CLIPTextEncodenode on your canvas.
- Injects the generated English prompt directly into the active
7. 🌐 Bada Google Translator (BadaGoogleTranslator)
- What it does: Zero-dependency, blazing-fast Google translation directly in ComfyUI with 429 rate limit bypass, automatic 4-tier failover, and quotes preservation (
preserve_quotes). - When to use it: When prompting in your native language (Korean, Japanese, Chinese, etc.) and translating directly into English prompts without installing heavy external packages (
requests,deep-translator, etc.).
🌟 Key Features
- ⚡ Zero External Dependencies:
- Uses only Python standard libraries (
urllib.request,urllib.parse,json,re,html). No external pip packages required.
- Uses only Python standard libraries (
- 🛡️ 429 Too Many Requests Bypass:
- Emulates official Chrome extension client requests and headers (
client="dict-chrome-ex", Chrome 124 headers) with 4-tier endpoint failover (translate.googleapis.com&clients5.google.com).
- Emulates official Chrome extension client requests and headers (
- 💬 Quotes Preservation (
preserve_quotes):- Preserves artist names, trigger words, and specialized tags enclosed in double quotes (
"..."), translating only descriptive surrounding text.
- Preserves artist names, trigger words, and specialized tags enclosed in double quotes (
- 🌐 Real-Time Bilingual UI:
- Dynamic node widget labels that react instantaneously to UI language switching.
8. 🛡️ PrimeVue Tooltip Bug Auto-Healer (Tooltip Healer)
- What it does: Automatically intercepts and resolves the persistent
(0, 0)ghost tooltip bug (.p-tooltip) in ComfyUI, guaranteeing a clean canvas. - When to use it: When an empty tooltip bubble gets permanently stuck at the top-left corner
(0, 0)of your ComfyUI window due to event capturing in third-party scripts.
🌟 Key Features
- 🛡️ 100% Automatic Ghost Tooltip Healing (
Tooltip Fixer):- In ComfyUI, certain extensions or startup flags cause event capturing in
common.jsthat disrupts PrimeVue coordinate calculations, permanently sticking.p-tooltipat coordinates(0, 0)on the top-left of the screen. - Bada Utils' built-in auto-healer intercepts aggressive capturing listeners and continuously ensures tooltips correctly track their parent elements or despawn cleanly.
- In ComfyUI, certain extensions or startup flags cause event capturing in
⚙️ 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:
📋 Settings Control Center Overview
| Section | Setting Item | Description |
| :--- | :--- | :--- |
| 1. Language | 🌐 UI Language | Switch display language between English and 한국어 (Korean) in real time. |
| 2. Workflows+ | 📁 Sidebar Workflows+ Folder Management | Enables drag-and-drop workflow folder organization, 0-item folder preservation, and Workflows+ in the left sidebar. |
| 3. Sidebar | 📐 Compact Sidebar Mode (Icons Only) | Hides text labels below left sidebar icons to keep the sidebar slim, compact, and icon-centric. |
| 4. Canvas QoL | 🖱️ Mouse Wheel Zoom & Middle-Click Pan Fixer | Fixes middle-click panning and wheel zoom freezes even over textareas, DOM widgets, and custom nodes. |
| 5. Startup | 🧼 Clean Blank Canvas Startup | Starts ComfyUI and new tabs with a clean blank canvas, completely preventing annoying missing-model startup errors (2 errors found). |
| 6. Presets | 🗃️ Global Presets & Inline Overview Panel | Display shortcut preset badges on node roofs and provides full-width interactive preset summary across all node types. |
| 7. Image QoL | 📋 Clipboard & LoadImage Auto-Error Fixer | Automatically fixes red border and input validation errors caused by pasting clipboard images (Ctrl+V) or subfolder paths in LoadImage nodes. |
| 8. Node Smart Care | 🩺 Node Smart Care (Missing Node Resolver & Model Assigner) | Enables the unified right-click context menu (🩺 [Bada] Node Smart Care) and 3-tab workflow diagnosis modal for missing custom nodes and models. |
[!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/bada_utils_workflow.json directly onto your ComfyUI canvas to immediately test the full ComfyUI-Bada-Utils all-in-one flagship suite (BadaPresetHub, BadaGoogleTranslator, BadaRegionalPrompt, and BadaAsyncGeminiStudio).
🚀 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.