NewYour coding agent can read the release notes before it upgrades.Set up the MCP server β
PyPI, #1669 most downloaded on PyPI
State-of-the-art diffusion in PyTorch.
Latest stable
0.42.1
Last release 26 days ago
27 Oct 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
102 releases Β· first in 2022
Drag across the ruler to compare, or tap a release to open it.
[docs] deprecate pipelines by @stevhliu in #13157
LLaDA2 is a family of discrete diffusion language models that generate text through block-wise iterative refinement. Instead of autoregressive token-by-token generation, LLaDA2 starts with a fully masked sequence and progressively unmasks tokens by confidence over multiple refinement steps.
NucleusMoE-Image is a 2B active 17B parameter model trained with efficiency at its core. Our novel architecture highlights the scalability of a sparse MoE architecture for Image generation.
Thanks to @sippycoder for the contribution.
ERNIE-Image is a powerful and highly efficient image generation model with 8B parameters.
Thanks to @HsiaWinter for the contribution.
LongCat-AudioDiT is a text-to-audio diffusion model from Meituan LongCat.
Thanks to @RuixiangMa for the contribution.
ACE-Step 1.5 generates variable-length stereo audio at 48 kHz (10 seconds to 10 minutes) from text prompts and optional lyrics. The full system pairs a Language Model planner with a Diffusion Transformer (DiT) synthesizer; this pipeline wraps the DiT half of that stack, and consists of three components: an AutoencoderOobleck VAE that compresses waveforms into 25 Hz stereo latents, a Qwen3-based text encoder for prompt and lyric conditioning, and an AceStepTransformer1DModel DiT that operates in the VAE latent space using flow matching.
Thanks to @ChuxiJ for the contribution.
Make your Flux.2 decoding faster with this new small decoder model from the Black Forest Labs. You can check it out here. It was contributed by @huemin-art in this PR.
We added modular support for LTX-2 and Hunyuan 1.5.
ring_anything as a new CP backendlru_cache warnings during torch.compile by @jiqing-feng in #13384--with_prior_preservation by @chenyangzhu1 in #133960.8.0-rc.0 by @McPatate in #13470trust_remote_code by @hlky in #13448The following contributors have made significant changes to the library over the last release:
trust_remote_code (#13448)Your coding agent can read these notes before it upgrades. Set up the MCP server β
Diffusers 0.38.0: New image and audio pipelines, Core library improvements, and more
Compare
Fix for loading ModularPipelines with AutoModel type hints in their modular_model_index.json #13271
ModularPipelines with AutoModel type hints in their modular_model_index.json #13271torchvision import in Cosmos Predict 2.5 #13321fix the warning torch_dtype is deprecated by @msdsm in #12841
Modular Diffusers introduces a new way to build diffusion pipelines by composing reusable blocks. Instead of writing entire pipelines from scratch, you can now mix and match building blocks to create custom workflows tailored to your specific needs! This complements the existing DiffusionPipeline class, providing a more flexible way to create custom diffusion pipelines.
Find more details on how to get started with Modular Diffusers here, and also check out the announcement post.
@apply_lora_scale decorator for simplifying model definitions (#12994)device_map (#12811)A lot of the above features/improvements came as part of the MVP program we have been running. Immense thanks to the contributors!
T5Tokenizer for Transformers v5.0+ compatibility (#12877)num_videos_per_prompt > 1 and CFG (#13121)txt_seq_lens handling (#12702)prefix_token_len bug (#12845)is_fsdp determination (#12960)get_image_features API (#13052)aiter availability check (#13059)prompt and prior_token_ids simultaneously in GlmImagePipeline (#13092)OvisImagePipeline in AUTO_TEXT2IMAGE_PIPELINES_MAPPING by @alvarobartt in #12876T5Tokenizer instead of MT5Tokenizer (removed in Transformers v5.0+) by @alvarobartt in #12877AutoencoderMixin by @sayakpaul in #12873enable_auto_cpu_offload by @sayakpaul in #12578is_fsdp is determined by @sayakpaul in #12960PeftLoraLoaderMixinTests to Enable/Disable Text Encoder LoRA Tests by @dg845 in #12962disable_mmap in pipeline from_pretrained by @hlky in #12854ChromaInpaintPipeline by @hameerabbasi in #12848*pooled_* mentions from Chroma inpaint by @hameerabbasi in #13026from_single_file method for WanAnimateTransformer3DModel by @samadwar in #12691get_image_features API by @JaredforReal in #13052ModularPipeline.blocks attribute by @yiyixuxu in #13014encode_video by Accepting More Input Types by @dg845 in #13057prompt and prior_token_ids to be provided simultaneously in GlmImagePipeline by @JaredforReal in #13092num_videos_per_prompt > 1 and CFG is Enabled by @dg845 in #13121setuptools pkg_resources Errors by @dg845 in #13129setuptools pkg_resources Bug for PR GPU Tests by @dg845 in #13132typing exports where possible by @sayakpaul in #12524ModularPipeline by @yiyixuxu in #13100setuptools CI Fix as the Failing Pipelines are Deprecated by @dg845 in #13149ftfy import for PRX Pipeline by @dg845 in #13154from_config with custom code. by @DN6 in #13123typing Import Error by @dg845 in #13178transformers v5 by @sayakpaul in #12976do_classifier_free_guidance threshold in ZImagePipeline by @kirillsst in #13183auto_map to model config by @DN6 in #13186do_classifier_free_guidance thresholds by @asomoza in #13212The following contributors have made significant changes to the library over the last release:
ModularPipeline.blocks attribute (#13014)ModularPipeline (#13100)AutoencoderMixin (#12873)enable_auto_cpu_offload (#12578)is_fsdp is determined (#12960)typing exports where possible (#12524)transformers v5 (#12976)from_config with custom code. (#13123)auto_map to model config (#13186)disable_mmap in pipeline from_pretrained (#12854)PeftLoraLoaderMixinTests to Enable/Disable Text Encoder LoRA Tests (#12962)encode_video by Accepting More Input Types (#13057)num_videos_per_prompt > 1 and CFG is Enabled (#13121)setuptools pkg_resources Errors (#13129)setuptools pkg_resources Bug for PR GPU Tests (#13132)setuptools CI Fix as the Failing Pipelines are Deprecated (#13149)ftfy import for PRX Pipeline (#13154)typing Import Error (#13178)ChromaInpaintPipeline (#12848)*pooled_* mentions from Chroma inpaint (#13026)get_image_features API (#13052)prompt and prior_token_ids to be provided simultaneously in GlmImagePipeline (#13092)Diffusers 0.37.0: Modular Diffusers, New image and video pipelines, multiple core library improvements, and more π₯
Compare
Handle deprecated transformer classes by @DN6 in #12517
The release features a number of new image and video pipelines, a new caching method, a new training script, new kernels - powered attention backends, and more. It is quite packed with a lot of new stuff, so make sure you read the release notes fully π
kernels-powered attention backendsThe kernels library helps you save a lot of time by providing pre-built kernel interfaces for various environments and accelerators. This release features three new kernels-powered attention backends:
varlen variant)varlen variant)This means if any of the above backend is supported by your development environment, you should be able to skip the manual process of building the corresponding kernels and just use:
# Make sure you have `kernels` installed: `pip install kernels`.
# You can choose `flash_hub` or `sage_hub`, too.
pipe.transformer.set_attention_backend("_flash_3_hub")
For more details, check out the documentation.
TaylorSeer is now supported in Diffusers, delivering upto 3x speedups with negligible-to-none quality compromise. Thanks to @toilaluan for contributing this in https://github.com/huggingface/diffusers/pull/12648. Check out the documentation here.
Our Flux.2 integration features a LoRA fine-tuning script that you can check out here. We provide a number of optimizations to help make it run on consumer GPUs.
AttentionMixin: Making certain compatible models subclass from the AttentionMixin class helped us get rid of 2K LoC. Going forward, users can expect more such refactorings that will help make the library leaner and simpler. Check out https://github.com/huggingface/diffusers/pull/12463 for more details.VAETesterMixin to consolidate tests for slicing and tiling by @sayakpaul in #12374AutoencoderMixin to abstract common methods by @sayakpaul in #12473upper() by @sayakpaul in #12479lodestones/Chroma1-HD by @josephrocca in #12508local_dir by @DN6 in #12381testing_utils.py by @DN6 in #12621test_save_load_float16 by @kaixuanliu in #12500SanaImageToVideoPipeline support by @lawrence-cj in #12634AutoencoderKLWan's dim_mult default value back to list by @dg845 in #12640kernels by @sayakpaul in #12439record_stream in group offloading is not working properly by @KimbingNg in #12721AttentionMixin for compatible classes by @sayakpaul in #12463upcast_vae in SDXL based pipelines by @DN6 in #12619from_single_file by @hlky in #12756The following contributors have made significant changes to the library over the last release:
AutoencoderKLWan's dim_mult default value back to list (#12640)local_dir (#12381)testing_utils.py (#12621)upcast_vae in SDXL based pipelines (#12619)SanaImageToVideoPipeline support (#12634)Diffusers 0.36.0: Pipelines galore, new caching method, training scripts, and more π
Compare
Release: v0.35.1-patch by @sayakpaul (direct commit on v0.35.2-patch)
Thanks to @naykun for the following PRs that improve Qwen-Image Edit:
Thanks to @naykun for the following PRs that improve Qwen-Image Edit:
v0.35.1 for improvements in Qwen-Image Edit
Compare
One column per quarter.