2022-09-15 14:53:41 +00:00
---
title: Home
---
2022-09-15 18:35:22 +00:00
<!--
2022-09-17 01:49:11 +00:00
The Docs you find here (/docs/*) are built and deployed via mkdocs. If you want to run a local version to verify your changes, it's as simple as::
2022-09-15 18:35:22 +00:00
```bash
pip install -r requirements-mkdocs.txt
mkdocs serve -a localhost:8080
```
-->
2022-09-15 14:53:41 +00:00
< h1 align = 'center' > < b > Stable Diffusion Dream Script< / b > < / h1 >
< p align = 'center' >
2022-09-17 01:49:11 +00:00
< img src = "assets/logo.png" / >
2022-09-15 14:53:41 +00:00
< / p >
< p align = "center" >
2022-09-17 01:49:11 +00:00
< a href = "https://github.com/lstein/stable-diffusion/releases" > < img src = "https://flat.badgen.net/github/release/lstein/stable-diffusion/development?icon=github" alt = "release" / > < / a >
< a href = "https://github.com/lstein/stable-diffusion/stargazers" > < img src = "https://flat.badgen.net/github/stars/lstein/stable-diffusion?icon=github" alt = "stars" / > < / a >
< a href = "https://useful-forks.github.io/?repo=lstein%2Fstable-diffusion" > < img src = "https://flat.badgen.net/github/forks/lstein/stable-diffusion?icon=github" alt = "forks" / > < / a >
< br / >
< a href = "https://github.com/lstein/stable-diffusion/actions/workflows/test-dream-conda.yml" > < img src = "https://flat.badgen.net/github/checks/lstein/stable-diffusion/main?label=CI%20status%20on%20main&cache=900&icon=github" alt = "CI status on main" / > < / a >
< a href = "https://github.com/lstein/stable-diffusion/actions/workflows/test-dream-conda.yml" > < img src = "https://flat.badgen.net/github/checks/lstein/stable-diffusion/development?label=CI%20status%20on%20dev&cache=900&icon=github" alt = "CI status on dev" / > < / a >
< a href = "https://github.com/lstein/stable-diffusion/commits/development" > < img src = "https://flat.badgen.net/github/last-commit/lstein/stable-diffusion/development?icon=github&color=yellow&label=last%20dev%20commit&cache=900" alt = "last-dev-commit" / > < / a >
< br / >
< a href = "https://github.com/lstein/stable-diffusion/issues?q=is%3Aissue+is%3Aopen" > < img src = "https://flat.badgen.net/github/open-issues/lstein/stable-diffusion?icon=github" alt = "open-issues" / > < / a >
< a href = "https://github.com/lstein/stable-diffusion/pulls?q=is%3Apr+is%3Aopen" > < img src = "https://flat.badgen.net/github/open-prs/lstein/stable-diffusion?icon=github" alt = "open-prs" / > < / a >
2022-09-15 14:53:41 +00:00
< / p >
This is a fork of [CompVis/stable-diffusion ](https://github.com/CompVis/stable-diffusion ), the open
source text-to-image generator. It provides a streamlined process with various new features and
options to aid the image generation process. It runs on Windows, Mac and Linux machines, and runs on
GPU cards with as little as 4 GB or RAM.
2022-09-18 02:54:20 +00:00
!!! note
This fork is rapidly evolving. Please use the
[Issues ](https://github.com/lstein/stable-diffusion/issues ) tab to report bugs and make feature
requests. Be sure to use the provided templates. They will help aid diagnose issues faster.
2022-09-15 14:53:41 +00:00
## Installation
This fork is supported across multiple platforms. You can find individual installation instructions
below.
2022-09-15 18:35:22 +00:00
- [Linux ](installation/INSTALL_LINUX.md )
- [Windows ](installation/INSTALL_WINDOWS.md )
- [Macintosh ](installation/INSTALL_MAC.md )
2022-09-15 14:53:41 +00:00
## Hardware Requirements
2022-09-15 18:35:22 +00:00
### System
2022-09-15 14:53:41 +00:00
You wil need one of the following:
- An NVIDIA-based graphics card with 4 GB or more VRAM memory.
- An Apple computer with an M1 chip.
2022-09-15 18:35:22 +00:00
### Memory
2022-09-15 14:53:41 +00:00
- At least 12 GB Main Memory RAM.
2022-09-15 18:35:22 +00:00
### Disk
2022-09-15 14:53:41 +00:00
- At least 6 GB of free disk space for the machine learning model, Python, and all its dependencies.
2022-09-18 02:54:20 +00:00
!!! note
2022-09-15 14:53:41 +00:00
2022-09-18 02:54:20 +00:00
If you are have a Nvidia 10xx series card (e.g. the 1080ti), please run the dream script in
full-precision mode as shown below.
2022-09-15 14:53:41 +00:00
2022-09-18 02:54:20 +00:00
Similarly, specify full-precision mode on Apple M1 hardware.
2022-09-15 14:53:41 +00:00
2022-09-18 02:54:20 +00:00
To run in full-precision mode, start `dream.py` with the `--full_precision` flag:
2022-09-15 14:53:41 +00:00
2022-09-18 02:54:20 +00:00
```bash
(ldm) ~/stable-diffusion$ python scripts/dream.py --full_precision
```
2022-09-15 14:53:41 +00:00
## Features
### Major Features
2022-09-15 18:35:22 +00:00
- [Interactive Command Line Interface ](features/CLI.md )
- [Image To Image ](features/IMG2IMG.md )
- [Inpainting Support ](features/INPAINTING.md )
- [GFPGAN and Real-ESRGAN Support ](features/UPSCALE.md )
- [Seamless Tiling ](features/OTHER.md#seamless-tiling )
- [Google Colab ](features/OTHER.md#google-colab )
- [Web Server ](features/WEB.md )
- [Reading Prompts From File ](features/OTHER.md#reading-prompts-from-a-file )
- [Shortcut: Reusing Seeds ](features/OTHER.md#shortcuts-reusing-seeds )
- [Weighted Prompts ](features/OTHER.md#weighted-prompts )
- [Variations ](features/VARIATIONS.md )
- [Personalizing Text-to-Image Generation ](features/TEXTUAL_INVERSION.md )
- [Simplified API for text to image generation ](features/OTHER.md#simplified-api )
2022-09-15 14:53:41 +00:00
### Other Features
2022-09-15 18:35:22 +00:00
- [Creating Transparent Regions for Inpainting ](features/INPAINTING.md#creating-transparent-regions-for-inpainting )
- [Preload Models ](features/OTHER.md#preload-models )
2022-09-15 14:53:41 +00:00
## Latest Changes
2022-09-15 18:35:22 +00:00
### v1.14 <small>(11 September 2022)</small>
- Memory optimizations for small-RAM cards. 512x512 now possible on 4 GB GPUs.
- Full support for Apple hardware with M1 or M2 chips.
- Add "seamless mode" for circular tiling of image. Generates beautiful effects.
([prixt](https://github.com/prixt)).
- Inpainting support.
- Improved web server GUI.
- Lots of code and documentation cleanups.
### v1.13 <small>(3 September 2022</small>
- Support image variations (see [VARIATIONS ](features/VARIATIONS.md )
([Kevin Gibbons](https://github.com/bakkot) and many contributors and reviewers)
- Supports a Google Colab notebook for a standalone server running on Google hardware
[Arturo Mendivil ](https://github.com/artmen1516 )
- WebUI supports GFPGAN/ESRGAN facial reconstruction and upscaling
[Kevin Gibbons ](https://github.com/bakkot )
- WebUI supports incremental display of in-progress images during generation
[Kevin Gibbons ](https://github.com/bakkot )
- A new configuration file scheme that allows new models (including upcoming stable-diffusion-v1.5)
to be added without altering the code. ([David Wager](https://github.com/maddavid12))
- Can specify --grid on dream.py command line as the default.
- Miscellaneous internal bug and stability fixes.
- Works on M1 Apple hardware.
- Multiple bug fixes.
2022-09-15 14:53:41 +00:00
For older changelogs, please visit the ** [CHANGELOG ](features/CHANGELOG.md )**.
## Troubleshooting
Please check out our ** [Q&A ](help/TROUBLESHOOT.md )** to get solutions for common installation
problems and other issues.
## Contributing
Anyone who wishes to contribute to this project, whether documentation, features, bug fixes, code
cleanup, testing, or code reviews, is very much encouraged to do so. If you are unfamiliar with how
to contribute to GitHub projects, here is a
[Getting Started Guide ](https://opensource.com/article/19/7/create-pull-request-github ).
A full set of contribution guidelines, along with templates, are in progress, but for now the most
important thing is to **make your pull request against the "development" branch** , and not against
"main". This will help keep public breakage to a minimum and will allow you to propose more radical
changes.
## Contributors
This fork is a combined effort of various people from across the world.
[Check out the list of all these amazing people ](other/CONTRIBUTORS.md ). We thank them for their
time, hard work and effort.
## Support
For support, please use this repository's GitHub Issues tracking service. Feel free to send me an
email if you use and like the script.
Original portions of the software are Copyright (c) 2020
[Lincoln D. Stein ](https://github.com/lstein )
## Further Reading
Please see the original README for more information on this software and underlying algorithm,
located in the file [README-CompViz.md ](other/README-CompViz.md ).
