diffusion-pipe

Pipeline-parallel training script for image and video diffusion models built on DeepSpeed.

Open SourceSelf HostedOffline CapableGPU Required
0.0 (0)

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

Price
Free
Platform
Local/Desktop
Difficulty
Advanced (4/5)
License
GPL-3.0
Added
Jul 29, 2026

Tags