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 – 자유롭게 사용, 수정 및 재배포가 가능합니다.