ComfyUI 3R3BOS Pack

The ultimate workflow engineering toolkit designed to bring professional control, "Human-in-the-Loop" efficiency, and zero-latency visualization to your ComfyUI environment.

Stop wasting GPU cycles on bad batches, doing mental math for model resolutions, or losing your favorite prompts in external Notepad files. The ComfyUI 3R3BOS Pack unifies your workflow with a sober, monochrome, native canvas aesthetic built for power users.

🚀 The Toolkit

🧠 1. Prompt Selector — Your Interactive Prompt Brain

Stop copying and pasting. This node turns your canvas into a fully interactive local prompt database, making text management dynamic and completely modular.

• In-Canvas Customization: Built-in visual editor lets you create, rename, or delete categories directly inside the ComfyUI interface.

• Organized Tagging: Easily store complex prompts, aesthetic styles, or LoRA trigger words with a custom color-coded system (e.g., tags for NSFW, custom themes, or styles).

• Live Workspace Control: Features a real-time prompt preview panel and a live override engine, letting you tweak text on the fly without breaking your core database structure.

🛑 2. Batch Selector — The Ultimate Visual Gatekeeper

Filter your generations like a pro before committing resources. Replaces complex preview-and-cancel loops with hard algorithmic control over your execution pipeline.

• True Native UI Grid: Draws a responsive image grid directly onto the node canvas with Zero HTML overlays—completely eliminating browser layout issues and scaling mismatches.

• Resource Optimization: Pauses workflow execution dynamically, letting you cherry-pick only the successful generations to pass on to expensive upscalers, refiners, or face-swappers.

• Bulletproof Core Stability: Engineered with a built-in "Heartbeat" mechanism and crash-protection logic to prevent workflow freezing when switching browser tabs or handling corrupted image packets.

• Instant Hard Cancel: Features a dedicated, instant-kill canvas button to immediately halt the workflow if the base batch fails to meet expectations.

⚡ 3. Image Comparer Slider — Absolute Pixel-Peeping

The gold standard for real-time A/B testing. Compare checkpoints, test subtle LoRA weights, or examine before/after upscales with flawless clarity.

• Synchronized Zoom & Pan: Scroll your mouse wheel to zoom and drag to pan across your composition. Both sides remain perfectly locked and synchronized, tracking grain, sharpness, and artifacts at identical pixel coordinates.

• Zero-Lag Scrubbing: Powered by specialized client-side caching to maintain a locked, fluid 60fps performance during side-by-side divider scraping.

• Dynamic Auto-Compaction: Hook up to 20 individual images simultaneously; the node dynamically opens new input slots and auto-compacts itself to keep your graph meticulously clean.

🎯 4. Aspect Ratio Master — The Definitive Resolution Engine

Say goodbye to stretched proportions and generation artifacts. This tool completely automates resolution math for cutting-edge generative architectures.

• Modern Model Database: Out-of-the-box native resolution and configuration blueprints for modern models like Flux.2, Hunyuan 2.1 (2K), Wan 2.2, and LTX Video.

• VAE Constraint Matching: Automatically enforces strict Mod16, Mod32, and Mod64 mathematical boundaries to guarantee your latents seamlessly match VAE decoder requirements.

• Dynamic Quality Tiers: Features an automated preset system toggle (Low, Middle, High Quality) that scales and recalculates target resolutions instantly depending on your current pipeline phase (drafting vs. final rendering).

• Labs Mode 🧪: Unlocks optimized community-tested "Sweet Spot" configurations (such as the premium 1.5MP Flux tuning) for extreme output fidelity.

• Visual Aspect Grid: Renders a beautiful, real-time graphical preview of your bounding box directly on the node surface.

⚠️ Important — Data Safety

Your Prompt Selector library is stored entirely locally on your machine. To ensure you never lose your data, pay close attention to the directory file below:

📂 Database Location: ComfyUI/custom_nodes/ComfyUI-3R3BOS-Pack/prompts_db.json

👉 Critical Action: Always manually back up this file before updating the pack, performing clean reinstalls of ComfyUI, or executing a fresh Git pull from GitHub. Losing this JSON file will permanently clear your custom prompt library.

🛠️ Installation

Method 1: Via ComfyUI Manager (Recommended)

1. Open the ComfyUI Manager menu.

2. Click on Custom Nodes Manager.

3. Search for 3R3BOS Pack.

4. Click Install, and restart your ComfyUI server.

Method 2: Manual Installation (Git Clone)

Open your terminal inside your local custom nodes directory and execute:

Bash

cd ComfyUI/custom_nodes
git clone https://github.com/3R3BOS/ComfyUI-3R3BOS-Pack.git

Restart ComfyUI to allow the frontend scripts to cache into your environment.

Method 3: Direct Manual Archive (.rar)

1. Download the .rar package directly from this page.

2. Extract the archive contents.

3. Move the extracted folder named ComfyUI-3R3BOS-Pack directly into your ComfyUI/custom_nodes/ directory.

4. Restart your ComfyUI server instance.

🔗 Links & Support

⭐ Please leave a star rating on GitHub if you enjoy using the suite—it significantly helps support continued development! Thank you! ❤️

• 📁 Official GitHub Repository

• 🐛 Submit Bug Reports & Feature Requests

📋 Full Update Log

v1.0.7

• PREMIUM SLATE-CYAN THEME: Complete visual redesign of both Aspect Ratio Master and Image Comparer Slider with a unified premium Slate-Steel grey theme (#242730) and soft cyan blue accents (#00b4d8).

• ASPECT RATIO MASTER REFACTOR: Integrated support for modern 2026 architectures (NVIDIA Cosmos, SANA-1.5, Wan Video, Z-Image, OmniGen), direct custom pixel inputs, real-time VAE latent shape tracking, canvas shadow bleed isolation, and layout dimension locks.

• IMAGE COMPARER SLIDER OVERHAUL: Added a Synchronized Texture Inspector (Pointer Pan & Zoom), Auto-Play Ping-Pong loop functionality, dynamic source node name tracking, memory-safe pointer capture handlers, and automated cache cleanup routines.

v1.0.6

• NEW NODE: Prompt Selector launched as a major workflow expansion feature.

• FEATURES: Implemented a comprehensive prompt database manager with real-time text editing, color-coded custom categories, and premium canvas-native interface modules.

v1.0.5

• CRITICAL FIX: Resolved a breaking issue where the Batch Selector would freeze the execution pipeline if the user switched browser tabs during an active generation phase.

• ROBUSTNESS: Deployed an active "Heartbeat" loop protocol to guarantee continuous backend-to-frontend synchronization.

• STABILITY: Integrated crash-protection guards to intercept and drop corrupted or incomplete image payloads gracefully inside the canvas preview matrix.

v1.0.4

• NEW NODE: Introduced Aspect Ratio Master. Complete native resolution logic engine supporting architectures like SDXL, Flux, Wan, and LTX.

• ARCHITECTURES: Hardcoded updated 2026 mathematical parameters for Hunyuan 2.1 and Wan 2.2 pipelines.

• STABILITY: Mandated rigorous Mod32/Mod64 latent validation logic to prevent decoding distortions.

• ORGANIZATION: Migrated the Batch Selector module into the unified 3R3BOS/Image category menu for pristine workflow mapping.

v1.0.3

• BUGFIX: Fixed a core scaling glitch where the Batch Selector image grid incorrectly processed layout borders. Standardized to strict 'contain' rendering to eliminate clipping on non-square image aspect ratios.

v1.0.2

• NEW NODE: Released Batch Selector as the feature-complete architectural replacement for the legacy Visual Gatekeeper module.

• DESIGN LANGUAGE: Complete UI overhaul across all native widgets—standardizing on a clean, unobtrusive monochrome design philosophy to keep the main graph context-focused.