A look at openai/guided-diffusion: 7.4k stars on GitHub, written primarily in Python.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
This is the codebase for Diffusion Models Beat GANS on Image Synthesis.
This repository is based on openai/improved-diffusion, with modifications for classifier conditioning and architecture improvements.
Download pre-trained models
We have released checkpoints for the main models in the paper. Before using these models, please review the corresponding model card to understand the intended use and limitations of these models.
Here are the download links for each model checkpoint:
64x64 classifier: 64x64_classifier.pt
64x64 diffusion: 64x64_diffusion.pt
128x128 classifier: 128x128_classifier.pt
128x128 diffusion: 128x128_diffusion.pt
256x256 classifier: 256x256_classifier.pt
256x256 diffusion: 256x256_diffusion.pt
256x256 diffusion (not class conditional): 256x256_diffusion_uncond.pt
To sample from these models, you can use the classifier_sample.py, image_sample.py, and super_res_sample.py scripts.
Here, we provide flags for sampling from all of these models.
We assume that you have downloaded the relevant model checkpoints into a folder called models/.
For these examples, we will generate 100 samples with batch size 4. Feel free to change these values.
Note for these sampling runs that you can set --classifier_scale 0 to sample from the base diffusion model.
You may also use the image_sample.py script instead of classifier_sample.py in that case.
These models are class-unconditional and correspond to a single LSUN class. Here, we show how to sample from lsun_bedroom.pt, but the other two LSUN checkpoints should work as well:
This table summarizes our ImageNet results for pure guided diffusion models:
Dataset
FID
Precision
Recall
ImageNet 64x64
2.07
0.74
0.63
ImageNet 128x128
2.97
0.78
0.59
ImageNet 256x256
4.59
0.82
0.52
ImageNet 512x512
7.72
0.87
0.42
This table shows the best results for high resolutions when using upsampling and guidance together:
Dataset
FID
Precision
Recall
ImageNet 256x256
3.94
0.83
0.53
ImageNet 512x512
3.85
0.84
0.53
Finally, here are the unguided results on individual LSUN classes:
Dataset
FID
Precision
Recall
LSUN Bedroom
1.90
0.66
0.51
LSUN Cat
5.57
0.63
0.52
LSUN Horse
2.57
0.71
0.55
Training models
Training diffusion models is described in the parent repository. Training a classifier is similar. We assume you have put training hyperparameters into a TRAIN_FLAGS variable, and classifier hyperparameters into a CLASSIFIER_FLAGS variable. Then you can run:
mpiexec -n N python scripts/classifier_train.py --data_dir path/to/imagenet $TRAIN_FLAGS $CLASSIFIER_FLAGS
Make sure to divide the batch size in TRAIN_FLAGS by the number of MPI processes you are using.
Here are flags for training the 128x128 classifier. You can modify these for training classifiers at other resolutions:
To sample for 250 timesteps without DDIM, replace --timestep_respacing ddim25 to --timestep_respacing 250, and replace --use_ddim True with --use_ddim False.
Does openai/guided-diffusion have a project website?
No homepage URL was recorded for openai/guided-diffusion in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
Does openai/guided-diffusion have any tags?
TopGit's last sync did not record any GitHub topics for openai/guided-diffusion. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on openai/guided-diffusion?
The most recent commit recorded on openai/guided-diffusion was 2.4 years ago, based on the GitHub push timestamp. The repository has 914 forks — one of the better signals of community interest.
Is openai/guided-diffusion open source?
Yes — openai/guided-diffusion ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/openai/guided-diffusion.
What license does openai/guided-diffusion use?
openai/guided-diffusion is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about openai/guided-diffusion?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/openai/guided-diffusion is the definitive source.
Read full README in the tab above.
Still deciding about guided-diffusion?
One click hands the question to an AI along with this page — see what it says about guided-diffusion.