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.

📦 ComfyUI XB-BOX (XB_ToolBox) とは？

ローカルで拡散モデルを実行するためのビジュアルノードベースのインターフェースである ComfyUI 用のプラグインコレクションです。XB_ToolBoxは、すぐに使えるノードセットと小型ダッシュボードを追加し、初心者でも画像や動画の生成パイプラインを簡単に制御できるようにします。また、非常に大規模な 3-D 拡散モデルをコンシューマー向け GPU で実行するための工夫も盛り込まれています。

🔑 主な機能 (READMEより)

カテゴリ	ツールボックスが提供するもの
統合パラメータハブ	Image Parameters Master と Video Parameters Master により、幅、高さ、バッチサイズ、FPSなどを一箇所で設定でき、安全な値（例：フレーム数の `1+8N` ルール）を自動的に適用します。
視覚的デバッグ	Spatiotemporal Chunk Visualization は、画像がどのようにタイル化され、動画フレームがどのようにスライスされるかを、2-D 空間ビューと 3-D 時間円柱ビューで表示します。
VRAM節約テクニック	Sampler Chunk Master は潜在空間で時空間タイル化を実行します。Model Block Swap は初期の Transformer ブロックを RAM にアンロードできます。VRAM Cleaner は PyTorch のガベージコレクションとキャッシュクリアを強制します。
ワークフローの人間工学	XB Dashboard Zen は散らばったノードを単一のコントロールパネルにクローンします。Dynamic Bus は汎用的な N-in/N-out バスノードで、「スパゲッティ配線」の混乱を軽減します。
音楽生成サポート	公式 YuE2 テキスト・トゥ・ミュージックワークフロー（スタイルプロンプト、歌詞、スコアワークベンチ、文字起こし入力、カバー準備）をラップするノードスイートです。これらは文字列やパラメータを公式の YuE2 ノードに渡すだけで、すべてデバイス内で完結します。
補助ユーティリティ	Storyboard Image Slicer（グリッドベースの画像分割）、VRAM Calculator & Data Radar（異なる量子化でのメモリ使用量推定）、および VRAM Optimizer ノードセット。

🛠️ インストール方法

ComfyUI Manager – XB_ToolBox を検索して Install をクリック (推奨)。
手動 – ComfyUI インストール先の custom_nodes フォルダにリポジトリをクローンします：
```
git clone https://github.com/wjluoxiao/XB_ToolBox.git
```

この拡張機能は追加の Python パッケージを必要とせず、標準の ComfyUI ビルドで動作します。

🎯 どのような人向けか？

AI 初心者：多くの個別のノードを探し回ることなく、一箇所で画像/動画パラメータを調整したい方。
大規模な 3-D 拡散モデル (14-22 B パラメータ) を扱うアーティスト：コンシューマー向け GPU で OOM エラーを回避するために VRAM 節約テクニックが必要な方。
音楽生成愛好家：すでに公式の YuE2 ノードを使用しており、スタイル、歌詞、スコアの処理においてより便利な UI を求めている方。

📜 ライセンス

Apache-2.0 – 自由に使用、変更、再配布が可能です。