ComfyUI-AutoMultiGPU
A ComfyUI extension with 11 custom nodes.
Nodes (11)
⚡ ComfyUI-AutoMultiGPU
🚀 High-Performance Zero-OOM Multi-GPU Distribution & Memory Management Engine for ComfyUI
ComfyUI-AutoMultiGPU is a production multi-GPU engine designed to run massive generative AI models (FLUX.2 / Klein 9B, LTX-Video 2.5, SDXL, Wan2.1, MiniMax H3, and GGUF quants) across dual or multi-GPU configurations with Zero Out-Of-Memory (OOM) errors.
🏛️ Core Engines
1. ⚙️ AutoMultiGPU - PyTorch Engine (Native Device Split)
Splits pipeline components natively across separate physical CUDA devices:
- Primary GPU (
cuda:0): Dedicated exclusively to UNet / Diffusion Transformer inference. - Secondary GPU (
cuda:1): Hosts Text Encoders (CLIP, T5, Qwen3), VAE Encoders/Decoders, and ControlNets. - Zero-OOM CPU Offloading: Dynamically swaps non-active weights to system RAM.
2. ⚡ AutoMultiGPU - DisTorch Engine (Layer Sharding)
- Shards individual Transformer blocks of large DiT models (e.g. Klein 9B / FLUX) across GPUs:
- GPU 0: Layers 0 → 18
- GPU 1: Layers 19 → 37
- Provides massive speedup by utilizing combined VRAM without tensor duplication.
3. 🧠 AutoMultiGPU - Automatic Engine (Zero-OOM Governor)
- Dynamically detects available VRAM across all installed NVIDIA GPUs at runtime and balances workloads automatically.
📊 Benchmark Comparison (Dual RTX 5060 Ti 16GB)
| Model & Workflow | Single GPU (16GB) | AutoMultiGPU Engine (2x 16GB) | Speedup & Stability | | :--- | :--- | :--- | :--- | | FLUX.2 Klein 9B (5-Ref Scene) | ⚠️ OOM / Crash | ✅ 0.42s per step (Zero-OOM) | 100% Stable | | LTX-Video 2.5 (High Res Take) | ⚠️ OOM at Frame 49 | ✅ 121 Frames Generated | Zero VRAM Spills | | 4K Super-Resolution Refiner | ⚠️ Swapping to CPU (Slow) | ✅ Full GPU Acceleration | 3.8x Faster |
📥 Installation
Method 1: Via ComfyUI Manager (Recommended)
- Open ComfyUI Manager.
- Search for
ComfyUI-AutoMultiGPU. - Click Install and restart ComfyUI.
Method 2: Manual Git Clone
cd ComfyUI/custom_nodes
git clone https://github.com/nexusfinancial-dev/ComfyUI-AutoMultiGPU.git
cd ComfyUI-AutoMultiGPU
pip install -r requirements.txt
📂 Example Workflows
Sample workflows are available in the examples/ folder. Drag and drop any .json file directly into ComfyUI!
📜 License
This project is open-source and licensed under the MIT License. Created with ❤️ by nexusfinancial-dev.