# cloneofsimo/minDiffusion

Self-contained, minimalistic implementation of diffusion models with Pytorch.

Repository: https://github.com/cloneofsimo/minDiffusion
Canonical: https://ross.abutalabs.com/products/mindiffusion
Language: Python
License Family: other
Topics: diffusion, pytorch
Last push: 2022-06-28T18:33:35+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 1602, "days_push": 1527, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1196, forks 152 (observed 2026-08-28T04:03:57.270176+00:00)

## What it is
A self-contained, minimalistic PyTorch implementation of denoising diffusion probabilistic models (DDPM) intended for education. The core implementation fits in under 200 lines of code and includes training scripts for MNIST, CIFAR-10, and CelebA datasets.

## Use cases
- learn how diffusion models work from a minimal codebase
- understand DDPM training and sampling in PyTorch
- generate images with a simple diffusion model
- study U-Net and time embedding implementations for diffusion
- get a starting point before reading larger diffusion codebases
- train a small diffusion model on CIFAR-10 or MNIST

## When to choose
- you want to learn the internals of diffusion models with minimal code
- you need a compact, readable DDPM reference implementation
- you are teaching or studying generative diffusion models
- you want a quick baseline before moving to larger frameworks like Hugging Face diffusers

## When to avoid
- you need production-ready or feature-complete diffusion tooling
- you require DDIM, classifier guidance, or latent diffusion
- you want a maintained library with a license and active releases
- you need efficient large-scale training or high-resolution image generation

## Facets
- artifact type: learning-resource
- maturity: maintenance
- function: machine-learning, deep-learning
- domain: machine-learning, deep-learning, artificial-intelligence, tutorials
- platform: python
- tags: diffusion-models, ddpm, educational, pytorch, image-generation, gpu

## Member repositories
- cloneofsimo/minDiffusion (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:57.270176+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-30T06:22:01.775851+00:00, confidence not recorded.
  - readme: https://github.com/cloneofsimo/minDiffusion (fetched 2026-08-28T04:03:57.270176+00:00, sha 693624abdb71)
- Data as of 2026-08-30T08:39:29.467469+00:00.