Diffusers
AI & LLMs🤗 Diffusers: State-of-the-art diffusion models for image, video, and audio generation in PyTorch.
Release History
v0.38.016 fixes12 featuresThis 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 fixesThis 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 featuresThis 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 featuresThis 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 featureThis 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 featureThis release introduces improvements to the Qwen-Image Edit model within the diffusers library.
v0.35.06 fixes12 featuresThis 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 featuresThis 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 fixThis release provides a bug fix for the Wan pipeline to correctly handle ftfy imports.
v0.33.010 featuresThis 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 featuresThis 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 reportsUnboundLocalError 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 reportsThe "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 reportsCalledProcessError 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 reportsImportError 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 reportsThe "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 reportsOutOfMemoryError 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
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.
Get up and running with OpenAI gpt-oss, DeepSeek-R1, Gemma 3 and other models.
🦜🔗 The platform for reliable agents.
The most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.
LLM inference in C/C++
GPT4All: Run Local LLMs on Any Device. Open-source and available for commercial use.
Subscribe to Updates
Get notified when new versions are released