diff --git a/README.md b/README.md index a5c9d3f..5705d77 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ #
Web-based UI for Stable Diffusion
-## Created by [sd-webui](https://github.com/sd-webui) +## Created by [Sygil.Dev](https://github.com/sygil-dev) -## [Visit sd-webui's Discord Server](https://discord.gg/gyXNe4NySY) [![Discord Server](https://user-images.githubusercontent.com/5977640/190528254-9b5b4423-47ee-4f24-b4f9-fd13fba37518.png)](https://discord.gg/gyXNe4NySY) +## [Join us at Sygil.Dev's Discord Server](https://discord.gg/gyXNe4NySY) [![Discord Server](https://user-images.githubusercontent.com/5977640/190528254-9b5b4423-47ee-4f24-b4f9-fd13fba37518.png)](https://discord.gg/gyXNe4NySY) ## Installation instructions for: @@ -11,7 +11,7 @@ ### Want to ask a question or request a feature? -Come to our [Discord Server](https://discord.gg/gyXNe4NySY) or use [Discussions](https://github.com/sd-webui/stable-diffusion-webui/discussions). +Come to our [Discord Server](https://discord.gg/gyXNe4NySY) or use [Discussions](https://github.com/sygil-dev/stable-diffusion-webui/discussions). ## Documentation @@ -21,7 +21,7 @@ Come to our [Discord Server](https://discord.gg/gyXNe4NySY) or use [Discussions] Check the [Contribution Guide](CONTRIBUTING.md) -[sd-webui](https://github.com/sd-webui) main devs: +[sygil-dev](https://github.com/sygil-dev) main devs: * ![hlky's avatar](https://avatars.githubusercontent.com/u/106811348?s=40&v=4) [hlky](https://github.com/hlky) * ![ZeroCool940711's avatar](https://avatars.githubusercontent.com/u/5977640?s=40&v=4)[ZeroCool940711](https://github.com/ZeroCool940711) @@ -29,23 +29,15 @@ Check the [Contribution Guide](CONTRIBUTING.md) ### Project Features: -* Two great Web UI's to choose from: Streamlit or Gradio - -* No more manually typing parameters, now all you have to do is write your prompt and adjust sliders - * Built-in image enhancers and upscalers, including GFPGAN and realESRGAN - +* Generator Preview: See your image as its being made * Run additional upscaling models on CPU to save VRAM -* Textual inversion 🔥: [info](https://textual-inversion.github.io/) - requires enabling, see [here](https://github.com/hlky/sd-enable-textual-inversion), script works as usual without it enabled +* Textual inversion: [Reaserch Paper](https://textual-inversion.github.io/) -* Advanced img2img editor with Mask and crop capabilities - -* Mask painting 🖌️: Powerful tool for re-generating only specific parts of an image you want to change (currently Gradio only) - -* More diffusion samplers 🔥🔥: A great collection of samplers to use, including: +* K-Diffusion Samplers: A great collection of samplers to use, including: - - `k_euler` (Default) + - `k_euler` - `k_lms` - `k_euler_a` - `k_dpm_2` @@ -54,35 +46,31 @@ Check the [Contribution Guide](CONTRIBUTING.md) - `PLMS` - `DDIM` -* Loopback ➿: Automatically feed the last generated sample back into img2img +* Loopback: Automatically feed the last generated sample back into img2img -* Prompt Weighting 🏋️: Adjust the strength of different terms in your prompt +* Prompt Weighting & Negative Prompts: Gain more control over your creations -* Selectable GPU usage with `--gpu ` +* Selectable GPU usage from Settings tab -* Memory Monitoring 🔥: Shows VRAM usage and generation time after outputting +* Word Seeds: Use words instead of seed numbers -* Word Seeds 🔥: Use words instead of seed numbers +* Automated Launcher: Activate conda and run Stable Diffusion with a single command -* CFG: Classifier free guidance scale, a feature for fine-tuning your output - -* Automatic Launcher: Activate conda and run Stable Diffusion with a single command - -* Lighter on VRAM: 512x512 Text2Image & Image2Image tested working on 4GB +* Lighter on VRAM: 512x512 Text2Image & Image2Image tested working on 4GB (with *optimized* mode enabled in Settings) * Prompt validation: If your prompt is too long, you will get a warning in the text output field -* Copy-paste generation parameters: A text output provides generation parameters in an easy to copy-paste form for easy sharing. - -* Correct seeds for batches: If you use a seed of 1000 to generate two batches of two images each, four generated images will have seeds: `1000, 1001, 1002, 1003`. +* Sequential seeds for batches: If you use a seed of 1000 to generate two batches of two images each, four generated images will have seeds: `1000, 1001, 1002, 1003`. * Prompt matrix: Separate multiple prompts using the `|` character, and the system will produce an image for every combination of them. -* Loopback for Image2Image: A checkbox for img2img allowing to automatically feed output image as input for the next batch. Equivalent to saving output image, and replacing input image with it. +* [Gradio] Advanced img2img editor with Mask and crop capabilities -# Stable Diffusion Web UI +* [Gradio] Mask painting 🖌️: Powerful tool for re-generating only specific parts of an image you want to change (currently Gradio only) -A fully-integrated and easy way to work with Stable Diffusion right from a browser window. +# SD WebUI + +An easy way to work with Stable Diffusion right from your browser. ## Streamlit @@ -90,30 +78,41 @@ A fully-integrated and easy way to work with Stable Diffusion right from a brows **Features:** -- Clean UI with an easy to use design, with support for widescreen displays. -- Dynamic live preview of your generations -- Easily customizable presets right from the WebUI (Coming Soon!) -- An integrated gallery to show the generations for a prompt or session (Coming soon!) -- Better optimization VRAM usage optimization, less errors for bigger generations. -- Text2Video - Generate video clips from text prompts right from the WEb UI (WIP) -- Concepts Library - Run custom embeddings others have made via textual inversion. -- Actively being developed with new features being added and planned - Stay Tuned! -- Streamlit is now the new primary UI for the project moving forward. -- *Currently in active development and still missing some of the features present in the Gradio Interface.* +- Clean UI with an easy to use design, with support for widescreen displays +- *Dynamic live preview* of your generations +- Easily customizable defaults, right from the WebUI's Settings tab +- An integrated gallery to show the generations for a prompt +- *Optimized VRAM* usage for bigger generations or usage on lower end GPUs +- *Text2Video:* Generate video clips from text prompts right from the WebUI (WIP) +- *Concepts Library:* Run custom embeddings others have made via textual inversion. +- **Currently in development: [Stable Hord](https://stablehorde.net/) integration; ImgLab, batch inputs, & mask editor from Gradio + +**Prompt Weights & Negative Prompts:** + +To give a token (tag recognized by the AI) a specific or increased weight (emphasis), add `:0.##` to the prompt, where `0.##` is a decimal that will specify the weight of all tokens before the colon. +Ex: `cat:0.30, dog:0.70` or `guy riding a bicycle :0.7, incoming car :0.30` + +Negative prompts can be added by using `###` , after which any tokens will be seen as negative. +Ex: `cat playing with string ### yarn` will negate `yarn` from the generated image. + +Negatives are a very powerful tool to get rid of contextually similar or related topics, but **be careful when adding them since the AI might see connections you can't**, and end up outputting gibberish + +**Tip:* Try using the same seed with different prompt configurations or weight values see how the AI understands them, it can lead to prompts that are more well-tuned and less prone to error. Please see the [Streamlit Documentation](docs/4.streamlit-interface.md) to learn more. -## Gradio +## Gradio [Legacy] ![](images/gradio/gradio-t2i.png) **Features:** -- Older UI design that is fully functional and feature complete. +- Older UI that is functional and feature complete. - Has access to all upscaling models, including LSDR. - Dynamic prompt entry automatically changes your generation settings based on `--params` in a prompt. - Includes quick and easy ways to send generations to Image2Image or the Image Lab for upscaling. -- *Note, the Gradio interface is no longer being actively developed and is only receiving bug fixes.* + +**Note: the Gradio interface is no longer being actively developed by Sygil.Dev and is only receiving bug fixes.** Please see the [Gradio Documentation](docs/5.gradio-interface.md) to learn more. @@ -157,7 +156,7 @@ Please see the [Image Enhancers Documentation](docs/6.image_enhancers.md) to lea ----- -### *Original Information From The Stable Diffusion Repo* +### *Original Information From The Stable Diffusion Repo:* # Stable Diffusion