diff --git a/README.md b/README.md index 888552f..a7a6728 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,20 @@ tools, Subgraph controls and deterministic workflow utilities to ComfyUI. > 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.0.0 introduces Regional V3.** The accompanying +> [Wiki](https://blackvortexai.github.io/bv_nodepack_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 @@ -25,12 +39,14 @@ Restart ComfyUI and hard-refresh the browser after installation or update. ### Regional prompting and LoRA routing -[![Two-character Anima regional result](examples/images/anima-android-dance-regional-showcase.png)](examples/images/anima-android-dance-regional-showcase.png) +![Regional V3 Editor with layered character and interaction regions](examples/images/regional-v3-editor.png) 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 →](https://blackvortexai.github.io/bv_nodepack_wiki/node-guides/regional-v3) + ### Smart Pipes ![Smart Pipe wireless merge](examples/images/smart-pipe-wireless-merge.png) @@ -38,6 +54,8 @@ backends. Regional V3 supports independently resolved workflow-local LoRA resour Carry typed workflow state through wired or wireless branches while preserving stable slot identity. +[Read the Smart Pipes guide →](https://blackvortexai.github.io/bv_nodepack_wiki/node-guides/smart-pipes) + ### Workflow Control ![Control Center workflow states](examples/images/control-center-workflow-states.png) @@ -45,6 +63,8 @@ slot identity. Switch named workflow stages deterministically between active, muted and bypassed states. +[Read the Workflow Control guide →](https://blackvortexai.github.io/bv_nodepack_wiki/node-guides/workflow-control) + ### Structured prompts ![Prompt AST categories](examples/images/prompt-ast-categories.png) @@ -52,6 +72,8 @@ states. Encode, filter, route and decode semantic prompt blocks without fragile string replacement. +[Read the Structured Prompt guide →](https://blackvortexai.github.io/bv_nodepack_wiki/node-guides/prompt-processing) + ### Subgraph interface tools ![Subgraph UI layout](examples/images/subgraph-ui-layout.png) @@ -59,12 +81,16 @@ replacement. Project headings, dividers, spacers and controlled choices onto purpose-built Subgraphs. +[Read the Subgraph Interface guide →](https://blackvortexai.github.io/bv_nodepack_wiki/node-guides/subgraph-interface) + ### Latent utilities ![Random-ratio latent workflow](examples/images/empty-latent-random-ratio.png) Create deterministic latent sizes and transformations for reusable workflows. +[Read the Latent Utilities guide →](https://blackvortexai.github.io/bv_nodepack_wiki/node-guides/latent-utilities) + ## Documentation and workflows Detailed guides and references are maintained separately from the runtime repository diff --git a/examples/images/anima-android-dance-regional-showcase.png b/examples/images/anima-android-dance-regional-showcase.png deleted file mode 100644 index c08f918..0000000 Binary files a/examples/images/anima-android-dance-regional-showcase.png and /dev/null differ diff --git a/examples/images/regional-v3-editor.png b/examples/images/regional-v3-editor.png new file mode 100644 index 0000000..13b5143 Binary files /dev/null and b/examples/images/regional-v3-editor.png differ