wjluoxiao/XB_ToolBox

XB_ToolBox: An easy-to-use ComfyUI custom node suite that streamlines workflow generation. Featuring exclusive data-flow logic and pioneering experimental kernel optimizations dedicated to the native AMD GPU ecosystem.

📦 What is ComfyUI XB‑BOX (XB_ToolBox)?

A plug‑in collection for ComfyUI, the visual node‑based interface used to run diffusion models locally. XB_ToolBox adds a set of ready‑made nodes and a small dashboard that make it easier for newcomers to control image‑ and video‑generation pipelines and to squeeze very large 3‑D diffusion models onto consumer‑grade GPUs.

🔑 Core features (as described in the README)

Area	What the toolbox provides
Unified parameter hubs	Image Parameters Master and Video Parameters Master let you set width, height, batch size, FPS, etc. in one place and automatically enforce safe values (e.g., the `1+8N` rule for frame counts).
Visual debugging	Spatiotemporal Chunk Visualization shows how an image is tiled and how video frames are sliced, with a 2‑D spatial view and a 3‑D temporal cylinder view.
VRAM‑saving tricks	Sampler Chunk Master performs spatial‑temporal tiling in latent space; Model Block Swap can unload early transformer blocks to RAM; VRAM Cleaner forces PyTorch garbage‑collection and cache clearing.
Workflow ergonomics	XB Dashboard Zen clones scattered nodes into a single control panel; Dynamic Bus is a generic N‑in/N‑out bus node that reduces “noodle‑wire” clutter.
Music generation support	A suite of nodes that wrap the official YuE2 text‑to‑music workflow (style prompt, lyrics, score workbench, transcription intake, cover preparation). They only pass strings/parameters to the official YuE2 nodes, keeping everything on‑device.
Helper utilities	Storyboard Image Slicer (grid‑based image splitting), VRAM Calculator & Data Radar (estimates memory usage for different quantizations), and a VRAM Optimizer set of nodes.

🛠️ How to install

ComfyUI Manager – search for XB_ToolBox and click Install (recommended).
Manual – clone the repo into the custom_nodes folder of your ComfyUI installation:
```
git clone https://github.com/wjluoxiao/XB_ToolBox.git
```

The extension does not require any extra Python packages; it works with the standard ComfyUI build.

🎯 Who will benefit?

AI beginners who want a single place to tweak image/video parameters without digging through many separate nodes.
Artists working with large 3‑D diffusion models (14‑22 B parameters) who need VRAM‑saving tricks to avoid OOM errors on a consumer GPU.
Music‑generation hobbyists who already use the official YuE2 nodes and want a more convenient UI for style, lyric, and score handling.

📜 License

Apache‑2.0 – free to use, modify, and redistribute.