diffusion-pipe
Pipeline-parallel training script for image and video diffusion models built on DeepSpeed.
About
Splitting large diffusion models across several GPUs is what diffusion-pipe by tdrussell handles: it trains LoRAs and full models using pipeline parallelism through DeepSpeed, combining hybrid data and pipeline parallelism so models too big for one card can still be fine-tuned on consumer hardware. Supported architectures span more than 20 models, including SDXL, FLUX, LTX-Video, HunyuanVideo, and the Wan family, which made it a fixture of the video LoRA training community. Latents and text embeddings are precached to disk before training, cutting VRAM pressure and keeping text encoders out of GPU memory during the run. Setup involves cloning with submodules, a Python 3.12 conda environment, a separate PyTorch install, and the NVIDIA CUDA toolkit; development targets Linux, native Windows is essentially unsupported, and WSL 2 is the recommended path for Windows users, with RTX 4090 class cards used for testing. Configuration lives in commented example files in the examples directory. The project is GPL-3.0 licensed, has around 2,000 stars, and saw active development into 2026.
Should you use diffusion-pipe?
Pick it when
Pick diffusion-pipe when you have two or more NVIDIA GPUs on Linux and need to train Wan, HunyuanVideo, or FLUX LoRAs or full fine-tunes that will not fit on one card, and you are comfortable editing config files by hand.
Look elsewhere when
Skip it on native Windows, which is essentially unsupported, or if you have one GPU and want an easier path: Musubi Tuner covers video LoRAs on a single card with block swapping, and AI Toolkit adds a web UI under MIT.
Alternatives to diffusion-pipe
- Musubi Tuner
Fits video LoRA training on one card through block swapping to system RAM, with a pip install and Apache-2.0 code, but no pipeline-parallel split across GPUs.
- AI Toolkit
MIT licensed with a web UI, job queue, and Windows support, easier for single-GPU LoRA work, but not built around splitting one model over several GPUs.
- SimpleTuner
Near substitute that shards training across GPUs with DeepSpeed or FSDP2 instead of pipeline parallelism, covers Wan, LTX, and HunyuanVideo, and adds a web UI, under AGPL-3.0.
Reviews (0)
Leave a Review
No reviews yet. Be the first to review!
Details
- Category
- Diffusion Model Tools & UIs
- Price
- Free
- Platform
- Local/Desktop
- Difficulty
- Advanced (4/5)
- License
- GPL-3.0
- Added
- Jul 29, 2026