BV Node Pack for ComfyUI
BV Node Pack adds visual regional prompting, model-specific regional attention, regional LoRA routing, sequential detailer workflows, Smart Pipes, structured prompt tools, Subgraph controls and deterministic workflow utilities to ComfyUI.
Note
BV Node Pack is developed with extensive generative-AI assistance. Product direction, architecture, review and real-workflow validation remain human-led.
Important
BV Node Pack 1.2.0 is prepared but not yet released. The current source includes Regional V3 plus the new workflow-local LoRA and LUT library tooling. The accompanying Wiki is online but still under construction, so missing screenshots or incomplete pages do not indicate missing runtime features.
Existing Regional workflows retain compatibility and supported node-local data is migrated when a workflow is loaded. Loading does not overwrite the workflow file, and deprecated Regional wiring is not silently rebuilt. Keep a backup, migrate any remaining legacy connections to the V3 resource flow, then save, reload and run the updated workflow once. Press Ctrl+Alt+B to toggle Regional Legacy Debug Mode when hidden legacy ports or V3 provider links are needed for inspection. The shortcut can be changed in ComfyUI Settings → Shortcuts.
Installation
Install BV Node Pack through ComfyUI Manager, or clone it into
ComfyUI/custom_nodes:
git clone https://github.com/BlackVortexAI/bv_nodepack.git
Restart ComfyUI and hard-refresh the browser after installation or update.
Feature overview
Regional prompting and LoRA routing
Create named regions with layered geometry, prompts and stable identities, then compile them through native conditioning or supported model-specific attention backends. Regional V3 supports independently resolved workflow-local LoRA resources.
LUT and LoRA libraries
Configure workflow-local LUT and LoRA resources through the shared BV interfaces.
The LUT catalog has separate Stable and Experimental channels, retains a local
working copy for offline startup, refreshes asynchronously and verifies downloads
against pinned checksums. Built-in LUTs and files below ComfyUI/models/luts use
the same loader and registry path.
Smart Pipes
Carry typed workflow state through wired or wireless branches while preserving stable slot identity.
Workflow Control
Switch named workflow stages deterministically between active, muted and bypassed states.
Read the Workflow Control guide →
Structured prompts
Encode, filter, route and decode semantic prompt blocks without fragile string replacement.
Read the Structured Prompt guide →
Subgraph interface tools
Project headings, dividers, spacers and controlled choices onto purpose-built Subgraphs.
Read the Subgraph Interface guide →
Latent utilities
Create deterministic latent sizes and transformations for reusable workflows.
Read the Latent Utilities guide →
Documentation and workflows
Detailed guides and references are maintained separately from the runtime repository in the BV Node Pack Wiki.
Only selected, verified examples are published in workflows.
Support
Report reproducible bugs and feature requests through GitHub Issues.
License and notices
BV Node Pack is licensed under GPL-3.0. Third-party attribution and provenance are listed in THIRD_PARTY_NOTICES.md.
Changelog
The README keeps the four most recent version entries. The complete history is maintained in the Wiki changelog.
1.2.0 — prepared 2026-08-29, not released
- Add the workflow-local
BV LoRA Registry, catalog library and Full/Quick selection flows while retaining the published V2 registry chain. - Complete the asynchronous LUT catalog with separate Stable and Experimental channels, offline working-copy fallback, manual refresh and checksum-verified downloads.
- Add nine deterministic built-in looks: Digital Green, Machine Blue, Dustfire, Steel Action, Sunbleached Coast, Expired Film, Classic Monochrome, Grayscale and HDR Color Boost.
- Expand the Experimental LUT channel to 46 profile- and license-documented candidates without changing the tested Stable channel.
- Normalize newly discovered LUT paths across Windows and browser-facing choices so Registry and Loader selections remain interoperable.
The built-in looks were manually tested and the Experimental catalog was confirmed to load on 2026-08-29. This entry describes the prepared source state; it does not claim a release, tag, published package or verification of every external LUT download.
1.1.0 — 2026-08-28
- Add Regional LUT authoring and execution workflows, including registry, plan, loop, catalog, download and prototype tooling.
- Unify Classic, Nodes 2.0 and Node Library presentation for technical, provider and legacy ports, including connection-aware Legacy Debug visibility.
- Stabilize node sizing and widget projection across mode changes, Subgraphs and hot reloads without overwriting user-resized dimensions.
- Refresh Regional graph-dependent selectors and sender targets when relevant nodes, editors or regions are created, replaced or removed.
- Normalize Control Center, Seed, prompt-debug and text-preview presentation and add regression coverage for the shared UI rules.
1.0.1 — 2026-08-26
- Add deterministic PNG export for the active graph, selected nodes and groups, and open BV-managed windows.
- Add transparent, BV Documentation Grid and current ComfyUI background modes with configurable scale and padding.
- Add optional complete-workflow PNG metadata and the versioned
window.bvNodepack.export.v1automation API. - Preserve native Subgraph capture compatibility with guarded offscreen-canvas attachment and cleanup.
1.0.0 — 2026-08-25
- Release Regional V3 with workflow-scoped documents, stable region identity, resource providers and model-specific execution paths.
- Add migration support and temporary Legacy Debug visibility for compatible pre-1.0 Regional workflows.
- Publish the task-oriented documentation site and runtime-derived node reference.
Continue with the BV Node Pack Wiki
Installation details, complete node references, migration guidance, acknowledgements and task-oriented workflow guides are maintained in the BV Node Pack Wiki →