mirror of https://github.com/easydiffusion/easydiffusion.git synced 2024-12-29 10:29:22 +01:00

Easiest 1-click way to create beautiful artwork on your PC using AI, with no tech knowledge. Provides a browser UI for generating images from text prompts and images. Just enter your text prompt, and see the generated image.

art diffusion generative-art gui stable

Go to file

Marc-Andre Ferland 5237f55a71 Removed extra line, use only save_render_devices_to_config		2022-11-14 22:29:55 -05:00
.github	Updating issues to allow multiple cats	2022-09-12 10:36:54 -07:00
media	Task queue screenshot	2022-10-08 18:00:23 +05:30
scripts	Make custom VAE an Image Setting, rather than a System Setting; Don't load a VAE into memory by default	2022-11-08 16:54:15 +05:30
ui	Removed extra line, use only save_render_devices_to_config	2022-11-14 22:29:55 -05:00
.gitignore	Revert "Merge branch 'react' into main"	2022-10-07 20:01:15 +05:30
build.bat	No need to generate arch-specific installers	2022-10-26 18:28:21 +05:30
build.sh	No need to generate arch-specific installers	2022-10-26 18:28:21 +05:30
CONTRIBUTING.md	Update CONTRIBUTING.md to instruct commenting out multiple lines	2022-09-10 15:39:38 -05:00
CreativeML Open RAIL-M License	Update license to mention Restricted uses, and include the CreativeML Open RAIL-M License	2022-08-25 16:14:08 +05:30
environment.yaml	v2 moving to the main branch	2022-09-04 19:31:34 +05:30
How to install and run.txt	Check if the installation dir isn't at the top of a drive (on windows) and show a warning	2022-09-07 13:02:41 +05:30
LICENSE	Update license to mention Restricted uses, and include the CreativeML Open RAIL-M License	2022-08-25 16:14:08 +05:30
README BEFORE YOU RUN THIS.txt	Show a warning if running build.bat, that it is meant for developers not users who accidentally downloaded the repo	2022-09-07 13:26:09 +05:30
README.md	Update README.md	2022-10-26 18:31:39 +05:30
Troubleshooting.md	Update Troubleshooting.md	2022-10-17 15:12:47 +05:30

README.md

Stable Diffusion UI

Easiest way to install and use Stable Diffusion on your own computer. No dependencies or technical knowledge required. 1-click install, powerful features.

(for support, and development discussion) | Troubleshooting guide for common problems

Step 1: Download the installer

Step 2: Run the program

On Windows: Double-click Start Stable Diffusion UI.cmd
On Linux: Run ./start.sh in a terminal

Step 3: There is no step 3!

It's simple to get started. You don't need to install or struggle with Python, Anaconda, Docker etc.

The installer will take care of whatever is needed. A friendly Discord community will help you if you face any problems.

Easy for new users, powerful features for advanced users

Features:

No Dependencies or Technical Knowledge Required: 1-click install for Windows 10/11 and Linux. No dependencies, no need for WSL or Docker or Conda or technical setup. Just download and run!
Clutter-free UI: a friendly and simple UI, while providing a lot of powerful features
Supports "Text to Image" and "Image to Image"
Custom Models: Use your own .ckpt file, by placing it inside the models/stable-diffusion folder!
Live Preview: See the image as the AI is drawing it
Task Queue: Queue up all your ideas, without waiting for the current task to finish
In-Painting: Specify areas of your image to paint into
Face Correction (GFPGAN) and Upscaling (RealESRGAN)
Image Modifiers: A library of modifier tags like "Realistic", "Pencil Sketch", "ArtStation" etc. Experiment with various styles quickly.
Loopback: Use the output image as the input image for the next img2img task
Negative Prompt: Specify aspects of the image to remove.
Attention/Emphasis: () in the prompt increases the model's attention to enclosed words, and [] decreases it
Weighted Prompts: Use weights for specific words in your prompt to change their importance, e.g. red:2.4 dragon:1.2
Prompt Matrix: (in beta) Quickly create multiple variations of your prompt, e.g. a photograph of an astronaut riding a horse | illustration | cinematic lighting
Lots of Samplers: ddim, plms, heun, euler, euler_a, dpm2, dpm2_a, lms
Multiple Prompts File: Queue multiple prompts by entering one prompt per line, or by running a text file
NSFW Setting: A setting in the UI to control NSFW content
JPEG/PNG output
Save generated images to disk
Use CPU setting: If you don't have a compatible graphics card, but still want to run it on your CPU.
Auto-updater: Gets you the latest improvements and bug-fixes to a rapidly evolving project.
Low Memory Usage: Creates 512x512 images with less than 4GB of VRAM!
Developer Console: A developer-mode for those who want to modify their Stable Diffusion code, and edit the conda environment.

Easy for new users:

Powerful features for advanced users:

Live Preview

Useful for judging (and stopping) an image quickly, without waiting for it to finish rendering.

Task Queue

System Requirements

Windows 10/11, or Linux. Experimental support for Mac is coming soon.
An NVIDIA graphics card, preferably with 4GB or more of VRAM. If you don't have a compatible graphics card, it'll automatically run in the slower "CPU Mode".
Minimum 8 GB of RAM.

You don't need to install or struggle with Python, Anaconda, Docker etc. The installer will take care of whatever is needed.

Installation

Download for Windows or for Linux.
Extract:

For Windows: After unzipping the file, please move the stable-diffusion-ui folder to your C: (or any drive like D:, at the top root level), e.g. C:\stable-diffusion-ui. This will avoid a common problem with Windows (file path length limits).
For Linux: After extracting the .tar.xz file, please open a terminal, and go to the stable-diffusion-ui directory.

Run:

For Windows: Start Stable Diffusion UI.cmd by double-clicking it.
For Linux: In the terminal, run ./start.sh (or bash start.sh)

This will automatically install Stable Diffusion, set it up, and start the interface. No additional steps are needed.

To Uninstall: Just delete the stable-diffusion-ui folder to uninstall all the downloaded packages.

How to use?

Please use our guide to understand how to use the features in this UI.

Bugs reports and code contributions welcome

If there are any problems or suggestions, please feel free to ask on the discord server or file an issue.

We could really use help on these aspects (click to view tasks that need your help):

If you have any code contributions in mind, please feel free to say Hi to us on the discord server. We use the Discord server for development-related discussions, and for helping users.

Disclaimer

The authors of this project are not responsible for any content generated using this interface.

The license of this software forbids you from sharing any content that violates any laws, produce any harm to a person, disseminate any personal information that would be meant for harm, spread misinformation, or target vulnerable groups. For the full list of restrictions please read the license. You agree to these terms by using this software.