Sygil-Dev/sygil-webui
1
1
Fork 0
mirror of https://github.com/Sygil-Dev/sygil-webui.git synced 2024-12-14 22:13:41 +03:00
Code Issues Projects Releases Wiki Activity

Improved Linux Docs (#1269)

Browse Source
This commit is contained in:
Joshua Kimsey 2022-09-22 16:41:32 -04:00 committed by GitHub
parent 75eac9c5c0
commit 1a5c8d91f2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 2 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/2.linux-installation.md
View File

@ -5,24 +5,13 @@
[To install on Windows, see this page.](https://github.com/sd-webui/stable-diffusion-webui/blob/master/docs/1.windows-installation.md)
**Note: This guide describes how to use the automated installation script created by [Joshua Kimsey](https://github.com/JoshuaKimsey). It is my personal recommendation to use this script as it will automatically handle downloading and updating the repo for you. This is not a requirement to running the Stable Diffusion WebUI on Linux, but you will need to install your own conda environment manually. Once comnpleted, simply run `webui.sh` to run the Stable Diffusion WebUI.**
**Note: This guide describes how to use the automated installation script created by [Joshua Kimsey](https://github.com/JoshuaKimsey). It is my personal recommendation to use this script as it will automatically handle downloading and updating the repo for you. This is not a requirement to running the Stable Diffusion WebUI on Linux, but you will need to install your own conda environment manually and then run `webui.sh` to run the Stable Diffusion WebUI.**
## Features
- Automates the process of installing and running hlky's fork of Stable Diffusion with the WebUI for Linux-based OS users.
- Handles updating from the hlky fork automatically if the users wishes to do so.
- Allows the user to preset their configs for running their setup (Gradio version only).
## Change Log
**PLEASE NOTE: If you are upgrading from using the 1.x versions of the script, it is my strong suggestion that you consider deleting the repo folder created by the script and letting it redownload to ensure everything is properly updated. To do so easily and without losing images you have already generated, simply copy the `outputs` folder to another location outside of the GitHub repo folder. Also, if you do not have a copy of the SD models you are using, make sure you copy the `model.ckpt` file from `models/ldm/stable-diffusion-v1` to another location as well. Delete the repo folder and rerun `linus-sd.sh` to reinstall. When it asks for the model files, if you copied a backup somewhere else, make sure the file is (re)named to `sd-v1-4.ckpt` before you move it to the repo folder as the script requests. Once installation is complete, feel free to copy your `outputs` folder back to the repo folder as well.**
* Version 2.0:
- Brand new redesign of the script to work with both the newer Streamlit and older Gradio interfaces.
- Now integrates with the in-built `webui.sh` file in the repo itself for better compatibility.
* Version 1.0 - 1.9:
- Initial versions supporting the single Gradio Interface.
## Initial Start Guide
**Note:** This guide assumes you have installed Anaconda already, and have it set up properly. If you have not, please visit the [Anaconda](https://www.anaconda.com/products/distribution) website to download the file for your system and install it.
@ -53,7 +42,7 @@ The user will have the ability to set these to yes or no using the menu choices.
**Step 7:** The script will then proceed to call the `webui.sh` file within the repo folder. This will handle the creation and updating of the conda environment, named `ldm`, as well as handle the downloading of the upsclaer models used by both Streamlit and Gradio. It will also download the Concepts Library for using custom models in the Streamlit version.
**Building the Conda environment may take upwards of 15 minutes, depending on your network connection and system specs. This is normal, just leave it be and let it finish. If you are trying to update and the script hangs at `Installing PIP Dependencies`, you will need to `Ctrl-C` to stop the script, delete your `src` folder, and rerun `linux-sd.sh` again.**
**Building the Conda environment may take upwards of 15 minutes, depending on your network connection and system specs. This is normal, just leave it be and let it finish. If you are trying to update and the script hangs at `Installing PIP Dependencies` for more than 10 minutes, you will need to `Ctrl-C` to stop the script, delete your `src` folder, and rerun `linux-sd.sh` again.**
**Step 8:** Once the conda environment has been created and the upscaler models have been downloaded, then the user is presented with a choice to choose between the Streamlit or Gradio versions of the WebUI Interface.
- Streamlit: