Diffusers

Get started

🧨 Diffusers Quicktour Effective and efficient diffusion Installation

Tutorials

Overview Understanding pipelines, models and schedulers AutoPipeline Train a diffusion model Inference with PEFT

Using Diffusers

Loading & Hub

Overview Load pipelines, models, and schedulers Load and compare different schedulers Load community pipelines and components Load safetensors Load different Stable Diffusion formats Load adapters Push files to the Hub

Tasks

Overview Unconditional image generation Text-to-image Image-to-image Inpainting Depth-to-image

Techniques

Textual inversion Distributed inference with multiple GPUs Improve image quality with deterministic generation Control image brightness Prompt weighting Improve generation quality with FreeU

Specific pipeline examples

Overview Stable Diffusion XL Latent Consistency Models Kandinsky ControlNet Callback Shap-E DiffEdit Distilled Stable Diffusion inference Create reproducible pipelines Community pipelines Contribute a community pipeline

Training

Overview Create a dataset for training Adapt a model to a new task Unconditional image generation Textual Inversion DreamBooth Text-to-image Low-Rank Adaptation of Large Language Models (LoRA) ControlNet InstructPix2Pix Training Custom Diffusion T2I-Adapters Reinforcement learning training with DDPO

Taking Diffusers Beyond Images

Other Modalities

Optimization

Overview

General optimizations

Speed up inference Reduce memory usage Torch 2.0 xFormers Token merging

Optimized model types

JAX/Flax ONNX OpenVINO Core ML

Optimized hardware

Metal Performance Shaders (MPS) Habana Gaudi

Conceptual Guides

Philosophy Controlled generation How to contribute? Diffusers' Ethical Guidelines Evaluating Diffusion Models

API

Main Classes

Configuration Loaders Logging Outputs

Models

Overview UNet1DModel UNet2DModel UNet2DConditionModel UNet3DConditionModel UNetMotionModel VQModel AutoencoderKL AsymmetricAutoencoderKL Tiny AutoEncoder ConsistencyDecoderVAE Transformer2D Transformer Temporal Prior Transformer ControlNet

Pipelines

Overview AltDiffusion AnimateDiff Attend-and-Excite Audio Diffusion AudioLDM AudioLDM 2 AutoPipeline BLIP Diffusion Consistency Models ControlNet ControlNet with Stable Diffusion XL Cycle Diffusion Dance Diffusion DDIM DDPM DeepFloyd IF DiffEdit DiT InstructPix2Pix Kandinsky 2.1 Kandinsky 2.2 Latent Consistency Models Latent Diffusion MultiDiffusion MusicLDM Paint By Example Parallel Sampling of Diffusion Models Pix2Pix Zero PixArt PNDM RePaint Score SDE VE Self-Attention Guidance Semantic Guidance Shap-E Spectrogram Diffusion

Stable Diffusion

Overview Text-to-image Image-to-image Inpainting Depth-to-image Image variation Safe Stable Diffusion Stable Diffusion 2 Stable Diffusion XL Latent upscaler Super-resolution LDM3D Text-to-(RGB, Depth) Stable Diffusion T2I-Adapter GLIGEN (Grounded Language-to-Image Generation)

Stable unCLIP Stochastic Karras VE Text-to-image model editing Text-to-video Text2Video-Zero unCLIP Unconditional Latent Diffusion UniDiffuser Value-guided sampling Versatile Diffusion VQ Diffusion Wuerstchen

Schedulers

Overview CMStochasticIterativeScheduler ConsistencyDecoderScheduler DDIMInverseScheduler DDIMScheduler DDPMScheduler DEISMultistepScheduler DPMSolverMultistepInverse DPMSolverMultistepScheduler DPMSolverSDEScheduler DPMSolverSinglestepScheduler EulerAncestralDiscreteScheduler EulerDiscreteScheduler HeunDiscreteScheduler IPNDMScheduler KarrasVeScheduler KDPM2AncestralDiscreteScheduler KDPM2DiscreteScheduler LCMScheduler LMSDiscreteScheduler PNDMScheduler RePaintScheduler ScoreSdeVeScheduler ScoreSdeVpScheduler UniPCMultistepScheduler VQDiffusionScheduler

Internal classes

Overview Attention Processor Custom activation functions Custom normalization layers Utilities VAE Image Processor

You are viewing v0.23.1 version. A newer version v0.31.0 is available.

Join the Hugging Face community

and get access to the augmented documentation experience

Collaborate on models, datasets and Spaces

Faster examples with accelerated inference

Switch between documentation themes

to get started

Using Diffusers with other modalities

Diffusers is in the process of expanding to modalities other than images.

Example type	Colab	Pipeline
Molecule conformation generation		❌

More coming soon!

←Reinforcement learning training with DDPO Overview→

Using Diffusers with other modalities