A stateful, loop-friendly utility belt for ComfyUI, built to make workflows feel less like “one-shot vending machines” and more like… actual processes. Keep in mind this is a Massive project and is currently STILL IN DEVELOPMENT.

[!WARNING] SYSTEM ALERT: Apologies for the lag currently present in the toolkit (especially in SmartSave). While the node operates with 100% precision, the load time for thumbnails and initial previews can occasionally be latent. I'm working on it. lol — h4

[!IMPORTANT] STABILITY STATUS: The core engine and high-impact nodes (especially H4_SmartSave) have been transitioned to STABLE. While the toolkit is now production-hardened, you may experience occasional lag in external HUD interfaces (History Rail, Comparinator) during heavy backend processing. Current development focus (WIP) is centered on the H4_NodeTranslator and the H4_Pythonipulator-inator kernel extension.

[!WARNING] CIVITAI API & NETWORK ADVISORY (h4_Link_QoL): The Civitai Bridge (h4_Link_QoL) module communicates directly with the official Civitai REST API (civitai.com/api/v1). Searching models, fetching thumbnails, or streaming downloads may occasionally experience rate-limiting (HTTP 429), request throttling, or connection timeouts. Please note: Any timeouts or rate limits are strictly governed by Civitai's external server infrastructure and bandwidth controls—they are NOT a bug or limitation of the h4_Live QoL toolkit engine.

Join our community for support and updates: Discord: https://discord.gg/hDCHn4aJe5

⚡ TACTICAL PROGRESS REPORT (v10.2.0)

H4_LinkQoL (Civitai Bridge): NEW RELEASE. High-performance model search, preview gallery carousel, automated trigger word sidecars, and direct canvas node injection.
H4_SmartSave: Promoted to STABLE. Optimized for surgical canvas sovereignty. Resolved thumbnail desync issues (Lag monitoring ongoing).
H4_DeadWeightDetector (D.W.D): STABLE RELEASE. Static graph hygiene engine active. Identify and purge unreachable nodes in real-time.
H4_NodeTranslator: Current WIP. Multilingual prompt synthesis and graph-level node type mapping.
H4_Pythonipulator-inator: Current WIP hardening. Transitioning to a distributed image kernel with enhanced glitch and geometric primitives.

[!IMPORTANT] CDE COMPATIBILITY: This node pack is optimized for the standard ComfyUI web interface. While it functions in ComfyUI Desktop Edition (CDE), the tactical flair, HUD overlays, and advanced terminal visualizers may be degraded or disabled by CDE's sandboxed rendering engine.

What this is

h4_Live is a ComfyUI node pack that adds memory, loop control, traffic routing, context bundling, and a pile of “why the hell doesn’t Comfy already do this?” utilities.

ComfyUI is amazing, but most workflows are basically: generate, forget, done.
h4_Live makes workflows capable of doing stuff like:

“First pass, do the heavy work.”
“Then loop, refine, and improve it a few times.”
“Change settings each loop.”
“Compare results.”
“Run test grids without losing your mind.”

This started as a simple switch node. Then we blinked. Now it’s an ecosystem.

Read this first: QoL features (OFF by default)

Important reality check

All QoL features ship OFF by default now.

There is no global QoL master toggle for h4_Live. If you want QoL features, you must enable them individually inside ComfyUI’s settings.

Why we do it this way:

Some people want a clean canvas with zero UI behavior changes.
Some people are sensitive to extra overlays, snap behavior, or louder errors.
And honestly, consent matters. Your UI should not get possessed without permission.

Where to enable them

In ComfyUI Settings, find the h4_Live-related toggles and enable only what you actually want. You will typically need to refresh the page after enabling UI features.

If you cannot find the toggles:

Make sure the node pack is installed correctly.
Make sure the frontend extensions are actually loading.
Check the browser console for extension load messages.

What you get (when enabled)

Below is the “in painful detail” breakdown of every QoL enhancement. This section is long on purpose, because people deserve to know what they are turning on.

1) Smart node snapping

What you’ll notice: nodes “want” to line up when you drag them. What it’s for: clean graphs, less time fiddling, fewer cursed spaghetti canvases.

2) Dynamic I/O coloring

What you’ll notice: sockets become easier to read at a glance. What it’s for: preventing dumb mistakes like “why won’t this latent connect to this image thing” at 2:13 AM.

3) Auto-context memory

What you’ll notice: settings stick around more reliably between sessions, reloads, or node recreations. What it’s for: reducing repeated setup work.

4) Visual debug overlays

What you’ll notice: extra on-canvas visibility into what is happening. What it’s for: debugging without adding five display nodes and praying.

5) Enhanced error reporting (jarring popup warning)

What you’ll notice: when something fails, the error dialog might feel… intense. It can be a little shocking the first time because it’s louder and more informative than stock comfy logging.

6) Caffeine Mode (Wake Lock)

What you’ll notice: a UI toggle that helps keep your screen awake during long runs. Perfect for long batch runs or overnight grids.

7) Dead Weight Detector (D.W.D)

What you’ll notice: a tactical Kirby (v_v) button in the toolbar. What it’s for: real-time graph hygiene. Identifies isolated, broken, or bypassed nodes that are wasting canvas space or compute cycles.

8) Civitai Bridge & Model Manager (h4_Link_QoL)

🟢 Plain English Overview (Simple Language)

What you’ll notice: a 🔗 Civitai button sitting in the top bar to the left of the Dead Weight Detector. What it’s for: browser-free model management directly inside ComfyUI!

Search & Explore: Search Civitai for any LoRA, Checkpoint, or VAE right inside ComfyUI without opening a browser tab.
Example Gallery: Click any thumbnail to slide out a secondary detail panel with a high-resolution image carousel showing showcase images and prompts.
Copy Trigger Words: One-click button to copy trained trigger words directly to your clipboard.
Direct Downloads: Downloads models straight to the correct folder (models/loras, models/checkpoints, models/vae) in the background while creating .txt trigger word and .json metadata sidecars.
Load into Node: Click "Load into Node" to push the downloaded model filename directly into your active loader node on the canvas.

⚙️ Dev Corner Specification (Technical Deep Dive)

API Transport Protocol: Asynchronous REST client querying https://civitai.com/api/v1/models with query parameter filtering (types=LORA|Checkpoint|VAE, sort=Highest Rated|Most Downloaded, limit=20).
Target Storage Resolution: Uses ComfyUI folder_paths.get_folder_paths() API to resolve real filesystem target directories dynamically (models/loras, models/checkpoints, models/vae, models/controlnet).
Background Downloader Engine: Asynchronous chunked HTTP stream writer (1MB chunk buffers) executing on background executor threads to preserve 60FPS UI responsiveness. Includes real-time byte counters and status telemetry exposed via /h4/link/status.
Metadata Sidecar Serialization: Automatically writes adjacent UTF-8 metadata sidecars upon download completion: <model_name>.txt containing comma-separated trainedWords arrays and <model_name>.json storing raw Civitai version payloads.
Glassmorphic Dual-Drawer Frontend: #h4-link-drawer-panel (width: 400px, z-index: 100005) and #h4-link-details-panel (width: 420px, z-index: 100004) rendered with CSS backdrop-filter: blur(12px) and dynamic viewport offset calculation (window.innerWidth - dwdRect.left + 12).
Canvas Injection Pipeline: Graph AST walker parsing app.canvas.selected_nodes, locating target widget parameters (lora_name, model_name, active_model_name), and mutating LiteGraph widget values in-place with app.canvas.setDirty(true, true).

Node index (jump to any node)

Nodes (friendly guide, minimal jargon)

The Book of H4 (In-App Help)

What it is: A massive, built-in documentation system inside the node pack itself. How to use it: Look at the top-right of ANY h4_Live node. See that little ? button? Click it. A drawer slides out and explains everything about that node.

Lore Injection: The system parses The_Book_of_H4.json to provide consistent, narrative-driven documentation.
Wireless Access: The documentation is synchronized across the toolkit, ensuring that any logic change in the backend is instantly reflected in the UI.
Viewport Sovereignty: For advanced nodes like H4_SmartSave, the help system integrates with the Three-Mode Panel System, allowing help drawers and forensic panels to be Pinned or Popped Out for persistent reference.

H4_SmartSave (The Forensic Vault)

Status: STABLE. What it is: The definitive preview and save infrastructure for the h4 toolkit. Features:

Three-Mode Panel System (The Book of H4 Edition):
- Mode A: Docked: Standard behavior. The forensic drawers anchor to the node and move with the canvas.
- Mode B: Pinned / Locked: The drawers detach and lock to the screen edge (left). Includes a "Canvas Margin Nudge" to keep your graph visible.
- Mode C: Popout: The drawers are mirrored into a standalone browser window. Perfect for dual-monitor setups or focusing purely on the canvas while tracking settings.
Viewport Sovereignty: Operates a high-performance visual overlay that does not interfere with canvas interaction.
DNA Extraction: Automatically parses workflow parameters and injects them as forensic metadata into your PNG files.
Lightbox Sovereignty: High-resolution image inspection with keyboard traversal (ArrowKeys) and telemetry readouts.

[!WARNING] FIELD ADVISORY: Apologies for the lag that's currently an active bug with the Smart Save. The node operates perfectly, except the load time for the thumbnails and the initial preview isn't the greatest... sometimes it can take a long time to load. I'm confident this is an issue on my end of the machine. However, in the event I am wrong and you come across this issue yourself—I'm working on it. lol. All the best, h4.

Note: Large history states may cause occasional UI lag during metadata parsing passes.

H4_DeadWeightDetector (The Graph Scavenger)

What it is: A static graph hygiene engine that "Crawls" your workflow to find logical abandoned components. How to use it: Toggle the (v_v) button in the toolbar. Color Matrix:

🩷 Hot Pink: Active Session Error (Intercepted via console).
🟡 Yellow: Critical logic break (Missing required inputs).
🔵 Blue: Intentionally Bypassed (Mode 4).
🟣 Fuchsia: Dead Chain Member (Compute waste leading nowhere).
🟠 Orange: Terminal Dead End (Disconnected from Save/Preview results).
🔴 Red: Total Isolation (Floating node, safely deletable). Tactical Action: Use the legend panel to execute a NUCLEAR PURGE of all red nodes.

H4_NodeTranslator (The Babel Fish - WIP)

Status: IN DEVELOPMENT. What it is: An on-the-fly graph transformation engine. It maps unknown node types to H4 equivalents and provides multi-language prompt synthesis for international workflows.

H4_Pythonipulator-inator (The Image Kernel - WIP)

Status: HARDENING PHASE. What it is: A high-performance image manipulation kernel that combines OpenCV, Pillow, and scikit-image into a single, tactical node. Currently Tuning: Distributed edge detection and the Cyberpunk glitch-engine primitives.

H4_Oxidine (The Sentient Conduit)

What it is: The ultimate node-wire declutter tool. An "omniproxy" that bundles all your node connections into a single cable. How it works: It automatically shape-shifts. When KSampler asks for a Model, Oxidine hands it the Model. No more spaghetti.

H4_DoubleSampler (The Two-Pass Engine)

What it is: The monster truck of samplers. Handles two-stage generation (Primary + Refiner), prompt transformation (Stutter/Wildcards), and CFG sliding all in one node.

H4_Gridinator (The Grid Maker)

What it is: A monolithic node that renders entire X/Y/Z grids in one go. Supports fuzzy model loading and automated ramp scales.

H4_Comparinator (The Final Forensic Utility)

What it is: A 3-pane forensic lab for A/B testing and pixel-diffing. Features a sliding reticle, Sniper-Scope magnification, and a telemetry drawer for comparing settings across generations.

H4_LinkQoL (The Civitai Bridge)

Status: STABLE RELEASE.

🟢 Plain English Overview (Simple Language)

What it is: The direct bridge between Civitai and ComfyUI. Eliminates switching back and forth between web browsers and model folders. How to use it:

Click 🔗 Civitai in the top bar to open the main search panel.
Search models by keyword or tag (LoRA, Checkpoint, VAE).
Click any thumbnail to slide out the Model Specifications Drawer to inspect full showcase images via the high-res carousel.
Click Download Model to save it directly into your ComfyUI models folder while auto-generating trigger word sidecars (.txt).
Select a LoRA/Loader node on your canvas and click Load into Node to push the model filename straight into the node.

⚙️ Dev Corner Specification (Technical Deep Dive)

Node Signature: H4_LinkQoL registered under category h4/loaders as 🔗 h4_Link (Civitai Bridge).
Backend Architecture: REST API gateway (nodes/h4_link_qol/civitai_api.py) exposing custom aiohttp routes (/h4/link/search, /h4/link/download, /h4/link/status).
Dynamic Path Mapping: Interoperates with comfy.cmd.folder_paths to resolve destination root dirs (loras, checkpoints, vae, controlnet, unet, clip).
Concurrent Streaming Downloader: Non-blocking async chunked HTTP stream writer (1048576 byte buffer chunks) operating on daemon executor threads with atomic status updates (percent, downloaded_bytes, total_bytes).
Sidecar Generator: Serializes adjacent .txt trigger word arrays and .json version payloads into the target model directory.
Frontend Architecture: Dual slide-out panel layout (#h4-link-drawer-panel and #h4-link-details-panel) with dynamic real-time viewport positioning (positionButton()), ultra-high z-index (100005), and LiteGraph canvas node widget mutation (loraWidget.value = filename).

Face manipulation suite (h4_faceforge/)

H4_FaceForge: Robust all-in-one face swap engine with occlusion-aware handling and micro-detail restoration.

H4_IdentityEngine: Extracts and serializes face "DNA" (embeddings) for consistent character creation across sessions.

Frontend extensions (js/)

H4_BigBrother: The QoL backbone. Provides node snapping, socket colorization, and enhanced error reporting. H4_SovereignCore: The aesthetic governor. Enforces the H4 visual identity across all custom UI elements. H4_LinkQoL: The Civitai bridge. Provides slide-out search drawer, secondary image carousel details drawer, trigger word copying, background downloader, and canvas loader injection.

Version History & Changelog

v10.2.0 - THE CIVITAI BRIDGE & OVERHAUL PROTOCOL

H4_LinkQoL (v1.0.0): Released the official Civitai Bridge module. Features slide-out search drawer, secondary details drawer with image carousel, .txt/.json sidecar creation, and direct canvas node injection.
Windows Unicode Stream Safety: Resolved UnicodeEncodeError console crashes when printing non-UTF8 characters on Windows standard output streams.
API Security & Path Traversal Safeguards: Applied path sanitization to all preset and image endpoint parameters in h4_server.py.
JS Asset Harvester Protection: Overhauled harvest_js_assets() to dynamically preserve existing extension scripts without accidental pruning.
ComfyUI Version Compatibility: Added defensive count_blocks fallback implementation in h4_loaders.
Database Concurrency: Hardened SQLite connection timeouts (30.0s) and WAL mode in h4_smart_save to eliminate database is locked errors.
VRAM & Memory Management: Integrated soft cache flushing and garbage collection in h4_model_merger.

v10.1.0 - THE HYGIENE PROTOCOL

Infrastructure Cleanup: Executed the 'Clean House' protocol, purging redundant binaries (node.zip) and scratch logic to optimize repository weight.
H4_DeadWeightDetector (v1.0.0): Officially released the D.W.D graph scavenger. Features BFS backward-crawling for live-set detection and tactical overlay viz.
H4_SmartSave: Promoted to STABLE. Hardened history rail concurrency and resolved final viewport occlusion bugs.
Version Synchronization: Aligned all modules to the v10.1.0 specification.
Status Update: Marked NodeTranslator and Pythonipulator-inator as the current active WIP frontiers.

v9.5.1 - THE KERNEL & HUD HARDENING

H4_Pythonipulator-inator: Introduced the definitive image manipulation kernel.
H4_SmartSave: Resolved canvas interaction occlusions and optimized parameter extraction for complex graphs.

License and credits

This is a clean node pack. If you ship it, keep it tidy. If you remix it, be cool about it.

We build weird tools so people can make cool stuff. And also because we got mad at the canvas one night and chose violence.

Be Your Best h4 - (b^_^)b

Built for the h4_Live Ecosystem. No compromise. No placeholders. Just power.

h4_Live

Nodes (51)

⚡ TACTICAL PROGRESS REPORT (v10.2.0)

Quick links

What this is

Read this first: QoL features (OFF by default)

Important reality check

Where to enable them

What you get (when enabled)

1) Smart node snapping

2) Dynamic I/O coloring

3) Auto-context memory

4) Visual debug overlays

5) Enhanced error reporting (jarring popup warning)

6) Caffeine Mode (Wake Lock)

7) Dead Weight Detector (D.W.D)

8) Civitai Bridge & Model Manager (h4_Link_QoL)

🟢 Plain English Overview (Simple Language)

⚙️ Dev Corner Specification (Technical Deep Dive)

Node index (jump to any node)

Core logic and traffic control

Context and data bundling

Mission control and scheduling

Gridinator and testing suite

Data processing and batch tools

Face manipulation suite (h4_faceforge/)

Loaders and file operations

Masking and inpainting

Display and debugging

Nodes (friendly guide, minimal jargon)

The Book of H4 (In-App Help)

H4_SmartSave (The Forensic Vault)

H4_DeadWeightDetector (The Graph Scavenger)

H4_NodeTranslator (The Babel Fish - WIP)

H4_Pythonipulator-inator (The Image Kernel - WIP)

H4_Oxidine (The Sentient Conduit)

H4_DoubleSampler (The Two-Pass Engine)

H4_Gridinator (The Grid Maker)

H4_Comparinator (The Final Forensic Utility)

H4_LinkQoL (The Civitai Bridge)

🟢 Plain English Overview (Simple Language)

⚙️ Dev Corner Specification (Technical Deep Dive)

Face manipulation suite (h4_faceforge/)

Frontend extensions (js/)

Version History & Changelog

v10.2.0 - THE CIVITAI BRIDGE & OVERHAUL PROTOCOL

v10.1.0 - THE HYGIENE PROTOCOL

v9.5.1 - THE KERNEL & HUD HARDENING

License and credits

Be Your Best h4 - (b^_^)b