---
id: diffusers
version: "0.39.0"
license: Apache 2.0 License
license_treatment: permissive
maintenance: active
---

# diffusers — State-of-the-art diffusion in PyTorch and JAX.

License: permissive · Maintenance: active · Downloads: 8.1M/mo

## What it is and what it does

Diffusers is a modular library for working with state-of-the-art pretrained diffusion models. It provides three core components: ready-to-use inference pipelines that require only a few lines of code, interchangeable noise schedulers for controlling diffusion speed and quality, and pretrained model building blocks that can be combined to create custom end-to-end systems. The library emphasizes usability and customizability, making it accessible to both practitioners wanting quick inference and researchers building novel diffusion architectures.

The package depends on common ecosystem libraries (numpy, Pillow, requests, httpx, huggingface-hub, safetensors, regex, filelock, importlib_metadata) and integrates tightly with the Hugging Face Hub, where thousands of pretrained checkpoints are hosted. It supports generating images from text, image-to-image transformations, unconditional generation, and other modalities. The library is actively maintained, production-stable, and licensed permissively under Apache 2.0.

Use it for:

- Generate images from text prompts using pretrained models with minimal setup code.
- Build custom diffusion pipelines by combining pretrained models with different schedulers for specific quality or speed requirements.
- Train your own diffusion models on custom datasets using the library's training guides and modular components.
- Perform image-to-image transformations and guided generation tasks using conditional diffusion techniques.
- Integrate diffusion-based generation into production applications via the Hugging Face Hub infrastructure.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Diffusers provides pretrained diffusion models and pipelines for generating images, audio, and 3D structures, along with interchangeable schedulers and model components for building custom diffusion systems.

Yes. Diffusers is production-stable, actively maintained, permissively licensed, and has low install friction. It offers both high-level pipelines for quick prototyping and low-level components for research. The main constraint is the Python 3.10.0 requirement and practical need for GPU hardware. Install it if you need to work with diffusion models.

## Install

pip install diffusers
uv add diffusers
poetry add diffusers

## Installing diffusers

Before you install: Low friction install with a pure-Python wheel. Active maintenance with a recent release 42 days ago and strong community engagement (34314 stars). Requires Python 3.10 or later.

License in practice: Apache 2.0 permissive license allows commercial and private use with minimal restrictions, making it suitable for production applications.

Quickstart:

pip install diffusers

from diffusers import DiffusionPipeline

pipeline = DiffusionPipeline.from_pretrained("stable-diffusion-v1-5/stable-diffusion-v1-5")
pipeline("An image of a squirrel in Picasso style").images[0]

Requires Python 3.10.0 or later; practical inference typically requires a GPU, though CPU-only usage is possible.

Verify before relying:

- Whether the package supports quantization or memory-optimization techniques beyond what the documentation excerpt shows.
- Performance characteristics and typical inference latency for different model sizes and hardware configurations.
- Support status for JAX backend mentioned in the summary but not detailed in the excerpt.

## Package facts

- License: Apache 2.0 License (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 8.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

text to image generation, diffusion models library, stable diffusion pipeline, image synthesis, diffusion model training, noise schedulers, generative ai models, pretrained diffusion checkpoints, generative-ai, diffusion-models, image-synthesis

[View on SkillFed](https://skillfed.io/packages/diffusers) · [View on PyPI](https://pypi.org/project/diffusers/)