Change8

Diffusers

AI & LLMs

🤗 Diffusers: State-of-the-art diffusion models for image, video, and audio generation in PyTorch.

Latest: v0.38.011 releases16 common errorsView on GitHub

Release History

v0.38.016 fixes12 features
May 1, 2026

This release introduces five new powerful pipelines: LLaDA2, NucleusMoE-Image, ERNIE-Image, LongCat-AudioDiT, and Ace-Step 1.5, alongside core library enhancements like Flash Attention 4 and modular support for LTX-2/Hunyuan 1.5.

v0.37.13 fixes
Mar 25, 2026

This release focuses on several bug fixes, including issues related to ModularPipelines loading, Flux Klein LoRA loading, and an unguarded torchvision import in Cosmos Predict 2.5.

v0.37.021 fixes23 features
Mar 5, 2026

This release introduces Modular Diffusers for flexible pipeline building and adds numerous new image and video generation pipelines, alongside significant core library improvements in caching and context parallelism.

v0.36.06 fixes13 features
Dec 8, 2025

This release introduces several major image and video pipelines (Flux2, Hunyuan 1.5, Sana-Video), high-performance attention backends via the 'kernels' library, and the TaylorSeer caching method for significant speed improvements.

v0.35.23 fixes1 feature
Oct 15, 2025

This patch release focuses on bug fixes for model initialization, device placement for Wan and LTX models, and ensuring compatibility with PyTorch 2.3.1.

v0.35.11 feature
Aug 20, 2025

This release introduces improvements to the Qwen-Image Edit model within the diffusers library.

v0.35.06 fixes12 features
Aug 19, 2025

This release introduces major new pipelines (Wan 2.2, Flux-Kontext, Qwen-Image), significant performance optimizations via regional compilation and GGUF CUDA kernels, and an experimental modular pipeline system.

v0.34.01 fix10 features
Jun 24, 2025

This release introduces several major video and image generation pipelines including Wan VACE, Cosmos Predict2, and Chroma, while significantly improving torch.compile performance and memory optimization techniques.

v0.33.11 fix
Apr 10, 2025

This release provides a bug fix for the Wan pipeline to correctly handle ftfy imports.

v0.33.010 features
Apr 9, 2025

This release introduces several major video and image generation pipelines including Wan2.1, LTX Video 0.9.5, and Lumina2, alongside significant memory optimization features like Layerwise Casting and Group Offloading.

v0.32.25 fixes4 features
Jan 15, 2025

This patch release fixes regressions in Flux single-file and LoRA loading (including 4-bit support) and resolves several bugs in HunyuanVideo related to batch processing and LoRA compatibility.

Common Errors

UnboundLocalError7 reports

UnboundLocalError occurs when a variable is referenced before it has been assigned a value within its scope, often in conditional statements or loops. To fix this, ensure the variable is assigned a default value before the conditional block or loop where it might be used without prior assignment. Alternatively, verify that all execution paths within the conditional block or loop lead to the variable being assigned a value before it is referenced.

ModuleNotFoundError6 reports

The "ModuleNotFoundError" in diffusers often arises from missing dependencies not automatically installed with the core library. To resolve this, identify the specific missing module (e.g., "xformers") from the error message and install it using pip: `pip install xformers`. Verify that the installation was successful and retry running the code.

CalledProcessError5 reports

CalledProcessError in diffusers often arises from external commands (like `accelerate launch`) failing due to missing dependencies or incorrect environment setup. Ensure all required packages specified in `requirements.txt` or the script itself are installed using `pip install -r requirements.txt`, and that your environment (e.g., CUDA, system libraries) is correctly configured for the executed command. Double-check that any specified paths or commands executed within the training script are valid and accessible within the environment.

ImportError4 reports

ImportError in diffusers often arises from missing dependencies or incorrect installation, especially after recent updates or when working with specialized pipelines. To fix this, ensure all required packages are installed, including optional dependencies (e.g., transformers, accelerate) by running `pip install diffusers[all]` or `pip install -r requirements.txt`, followed by explicitly installing any missing packages identified in the error message with `pip install <package_name>`.

NotImplementedError4 reports

The "NotImplementedError" often arises when attempting to load specific model types or configurations (like meta tensors) with a method that lacks the necessary implementation. To resolve this, either use the correct loading function tailored for the specific model format (e.g., safetensors), ensure all required dependencies are installed, or explicitly move the model to the target device after loading. If loading GGUF, verify that the loading script is specifically designed to handle that format.

OutOfMemoryError3 reports

OutOfMemoryError in diffusers primarily results from exceeding GPU memory capacity during large image generation or complex model operations. Fix this by reducing batch size, image resolution, or using techniques like memory-efficient attention (xFormers) and model offloading. Employ torch.cuda.empty_cache() periodically to clear unused memory and consider gradient checkpointing to reduce memory footprint.

Related AI & LLMs Packages

Subscribe to Updates

Get notified when new versions are released

RSS Feed