# huggingface/diffusers

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

Repository: https://github.com/huggingface/diffusers
Canonical: https://ross.abutalabs.com/products/diffusers
Homepage: https://huggingface.co/docs/diffusers
Language: Python
License: Apache-2.0
License Family: permissive
Topics: deep-learning, diffusion, image-generation, pytorch, score-based-generative-modeling, image2image, text2image, stable-diffusion, stable-diffusion-diffusers, latent-diffusion-models, flux, image2video, text2video, video2video, qwen-image
Last push: 2026-08-27T00:14:54+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 86, longevity 100
- inputs: {"age_days": 1556, "days_push": 7, "days_rel": 13, "gap_med": 51.0, "n_releases_24m": 17}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 34385, forks 7268 (observed 2026-08-28T04:12:00.509086+00:00)

## What it is
Hugging Face Diffusers is a Python library providing state-of-the-art pretrained diffusion models for generating images, videos, and audio in PyTorch. It offers ready-to-use DiffusionPipeline APIs for inference, interchangeable noise schedulers, and modular building blocks for training custom diffusion systems.

## Use cases
- generate images from text prompts with stable diffusion
- run text-to-video generation in python
- train or finetune a diffusion model with LoRA
- convert text to audio or speech via audio diffusion models
- build a custom image generation pipeline with custom schedulers
- run large diffusion models on limited GPU memory with cpu offloading
- do image-to-image editing with diffusion models

## When to choose
- you want a well-maintained, widely-adopted library for diffusion model inference or training in PyTorch
- you need to mix and match model components, schedulers, and adapters like LoRA
- you need memory optimizations like CPU offloading and quantization for large models
- you want access to the latest models (Stable Diffusion, Flux, Qwen-Image) from the Hugging Face Hub

## When to avoid
- you need a one-click GUI or hosted API rather than a Python library
- your project is not Python/PyTorch based
- you only need simple image classification or non-generative vision tasks

## Facets
- artifact type: library
- maturity: stable
- function: machine-learning, deep-learning, image-processing, audio-processing, video-processing, gpu-computing
- domain: deep-learning, machine-learning, artificial-intelligence, image-processing
- platform: python, cross-platform
- tags: diffusion-models, stable-diffusion, text-to-image, text-to-video, pytorch, generative-ai, lora, hugging-face, video, audio, gpu

## Member repositories
- huggingface/diffusers (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:12:00.509086+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:27:34.687560+00:00, confidence not recorded.
  - readme: https://github.com/huggingface/diffusers (fetched 2026-08-28T04:12:00.509086+00:00, sha 6c84066aec17)
  - homepage: https://huggingface.co/docs/diffusers (fetched 2026-08-29T07:48:21.760570+00:00, sha 595ce0157b00)
  - site_page: https://huggingface.co/docs (fetched 2026-08-29T07:48:21.763616+00:00, sha bdec26667b98)
  - site_page: https://huggingface.co/docs/diffusers/installation (fetched 2026-08-29T07:48:21.768061+00:00, sha a15d3c8d781e)
  - site_page: https://huggingface.co/docs/diffusers/quicktour (fetched 2026-08-29T07:48:21.769853+00:00, sha 843014f17bfa)
  - site_page: https://huggingface.co/docs/diffusers/stable_diffusion (fetched 2026-08-29T07:48:21.771769+00:00, sha d229bef460b8)
  - site_page: https://huggingface.co/docs/diffusers/v0.40.0/en/api/pipelines/overview (fetched 2026-08-29T07:48:21.773525+00:00, sha 5969fc5b7f2a)
  - registry_pypi: https://pypi.org/pypi/diffusers/json (fetched 2026-08-29T07:48:21.776463+00:00, sha 790dccaeeb08)
  - site_page: https://huggingface.co/pricing (fetched 2026-08-29T07:48:21.765812+00:00, sha de6b7a178be5)
- Data as of 2026-08-30T08:39:29.467469+00:00.