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.4.1 closes the remaining workflow-reachable file, model and endpoint boundaries: text logs are limited to text formats, Regional LoRAs to .safetensors files inside the configured LoRA folders, and the Remote LLM destination is no longer a workflow widget. It builds on 1.4.0, which added reference-driven regional editing, one workflow-wide Global LoRA Registry, automatic MODEL/CLIP preparation and improved Registry, catalog and Quick Edit UI. The Wiki contains the full node reference and task-oriented guides.

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.

Registry review remains open in issue #217. Registry publication, security-review status and the version offered by Manager are separate states; Manager may offer an older version while review is pending.

Updating to 1.4.1

• BV Text Log Writer accepts .txt, .json and .log names only. Rename logs that used other endings; a rejected name fails the node with a clear error.
• Regional LoRA stacks and Civitai metadata hashes accept .safetensors files only, inside the configured ComfyUI LoRA folders. Convert pickle-based LoRAs (.pt, .ckpt, .bin) before referencing them.
• BV Remote LLM Provider lost its endpoint widget. Fixed profiles keep their catalog address. For OpenAI Compatible, open Configure API Key, enter the destination there and save the key again. For Local OpenAI Compatible (Custom), set profile_defaults.local-openai-compatible.custom_endpoint in remote_llm_settings.json when the catalog loopback address does not fit. Saved workflows load unchanged apart from the dropped endpoint value.
• Restart ComfyUI and reload the browser after updating both backend and frontend.

Updating to 1.4.0

• Enable Global in the intended LoRA Registry. Only one Registry may be active across the workflow and its Subgraphs. New Registries start with Global off; conflicting saved selections require an explicit choice, never a load-order winner.
• The Regional Editor's Globalen Stack anwenden checkbox defaults to on. Turning it off skips automatic Global LoRAs for that editor while preserving manually selected normal stacks. Supply original MODEL/CLIP inputs when opting out; already applied weights cannot be undone by this checkbox.
• With BV Regional Native Conditioning, connect the source MODEL input and use its MODEL output (slot 2) for the sampler when applying Global LoRAs. Positive and negative outputs remain in slots 0 and 1. Model-specific attention nodes prepare their own MODEL/CLIP through the same automatic service.
• Existing basis groups retain their identities, order, strengths and enabled states inside the Global area. Existing manual global assignments remain separate; they are not copied into the fixed Global stack.
• Registry dialog changes save immediately to the node configuration, including Undo/Redo and catalog additions. Invalid drafts keep the last valid saved state. Save the workflow separately to persist changes to disk.
• Restart ComfyUI and reload the browser after updating both backend and frontend. The catalog identifies an older running backend instead of presenting missing routing fields as a compatibility result.

The following safeguards from 1.3.0 still apply:

• Re-enter existing API keys for custom OpenAI-compatible providers through Configure API Key and confirm the displayed destination. Keys are bound to that full endpoint; redirects are blocked. Fixed-provider legacy keys retain their catalog destination.
• BV Remote LLM Provider has no endpoint widget any more. The destination is decided by the backend only: the catalog address for fixed profiles, the approved API-key binding for custom bearer profiles, and the optional profile_defaults.<profile>.custom_endpoint entry in remote_llm_settings.json for the key-less local custom profile. A workflow cannot select a destination.
• Regional LoRA stacks accept .safetensors files only, and only inside configured ComfyUI LoRA folders, including extra_model_paths.yaml entries. Register additional folders there; absolute paths within configured folders remain supported. Pickle-based formats (.pt, .ckpt, .bin) are rejected with a clear error, so no LoRA reaches torch.load. The same rule applies to the LoRA hashes that BV Regional Image Save embeds as Civitai metadata; files outside those folders are never read.
• Text logs reject linked log files and linked bv_logs directories. Use an ordinary log directory below the configured ComfyUI output root. Log names must end with .txt, .json or .log; other endings are rejected.

Keep ComfyUI and its settings routes restricted to trusted users, and review imported workflows before running them. These safeguards do not constitute Registry approval or a guarantee that arbitrary workflows are safe.

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.

Read the Regional V3 guide →

LUT and LoRA libraries

View the LUT catalog

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.

Read the LUT library guide →

Read the LoRA library guide →

Smart Pipes

Reviewed native wiring diagram; not an executed workflow.

Carry typed workflow state through wired or wireless branches while preserving stable slot identity.

Read the Smart Pipes guide →

Workflow Control

Switch named workflow stages deterministically between active, muted and bypassed states.

Read the Workflow Control guide →

Structured prompts

Reviewed native wiring diagram; not an executed workflow.

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.4.1 — 2026-09-08

• Restrict BV Text Log Writer names to .txt, .json and .log; other endings are rejected before anything is written.
• Approve every workflow-supplied LoRA path with one shared rule: inside the configured ComfyUI LoRA folders and .safetensors only. This covers LoRA loading and the Civitai metadata hashes; pickle-based files never reach torch.load, and files outside those folders are never read.
• Remove the endpoint widget from BV Remote LLM Provider. The destination is resolved by the backend from the provider catalog, the approved API-key binding or the local settings file; the Configure dialog now takes the destination for custom bearer profiles. Workflows saved with earlier versions load unchanged apart from the dropped endpoint value.
• Move internal design notes out of the Registry package.

1.4.0 — 2026-09-08

• Add reference-driven regional editing with BV Reference Registry, inline @ references, regional tool controls and the Krea 2 Identity Edit path.
• Add an exclusive workflow-wide Global LoRA Registry and per-editor opt-out, preserving legacy groups and manual selections. Share occurrence-aware automatic MODEL/CLIP preparation across attention and Native Conditioning consumers.
• Append Native Conditioning's MODEL input/output while retaining positive and negative output ordinals; use the returned MODEL with the sampler.
• Support official Krea 2 LoRA key mappings and header-based routing evidence. Catalog routing distinguishes token candidates, multipass and unknown files; target-model compatibility remains unknown without a concrete model check.
• Autosave valid Registry edits, catalog additions and Undo/Redo. Keep peer Global changes synchronized and preserve invalid drafts without replacing valid state.
• Grow Registry nodes to a bounded content height before scrolling, respecting manual dimensions. Enlarge the catalog and its preview pane and automatically fill and paginate results. Persist header-check results across restarts, invalidate them when a file changes, and continue reading local metadata and previews fresh.
• Show validated Civitai links from local metadata and concise routing information.
• Fix Quick Edit spacing and textarea resize reachability through whole-content scrolling, and improve Smart Pipe/Subgraph lifecycle and sizing behavior.

1.3.0 — 2026-09-05

• Unify Regional negative-prompt policies (auto, prompt, zero_out) across Anima, FLUX.2, Krea 2 and Z-Image, with scoped Anima negatives and CFG token masking.
• Add local embedding: completion to shared prompt editors.
• Improve LoRA catalog refresh, preview sidecar discovery and persistent preview preferences; previews remain opt-in.
• Improve shared resizable previews, window text selection and GraphImage DOM capture.
• Add the built-in Day for Night LUT and image sender preview/pass-through behavior when no target is selected.
• Improve Civitai seed and LoRA hash metadata, and workflow-scoped DG routing through Subgraphs for registries and Smart Pipes.
• Refresh documentation with all 62 public-node screenshots and reviewed native wiring diagrams. Wiring captures do not establish successful workflow execution.
• Bind remote API keys to approved endpoints, block redirects, and harden text-log aliases and Regional LoRA path boundaries.
• Update the frontend build toolchain; the release audit reports no known npm advisories at the time of validation.

1.2.3 — 2026-09-01

• Harden the Comfy Registry package by excluding development tests and UI source files while retaining the committed runtime bundle. Runtime behavior is unchanged.