Installation

Prerequisites: Install Python and Git

General Installation

1. Clone SD.Next:

   • Clone the repository by running git clone https://github.com/vladmandic/automatic <optional directory name> in your desired location.
   • Navigate into the cloned directory.
   • DirectML/AMD owners on Windows should additionally start with --use-directml
   • ROCm/Linux users can optionally start with --use-rocm if your setup is not autodetected.
   • Intel OneAPI XPU users should start with --use-ipex
   • Run webui.bat --debug (Windows) or webui.sh --debug (Linux/Mac) to start the web interface.
   • For the initial setup and future tech support, it is advisable to include the --debug option. This will provide
     more detailed information, which can be helpful until the Diffusers backend becomes fully feature complete from
     HF (Huggingface) and any potential compatibility issues are resolved.
   • When asked to download the default model, you can safely choose "N" to skip the download.

2. Initial Setup:

   • Once the web interface starts running adjust these settings in the Settings tab:
   • If you already have models, LoRAs, Embeddings, LyCORIS, etc. set your System Paths now, especially if you started with --models-dir, you
     won't need to use it afterwards.
     Pay special attention to the Diffusers entry as that is where diffusers models will download to if you use the Huggingface downloader.
   • If you intend to use the Diffusers backend and/or SDXL, go to Setup/User Interface and select sd_model_refiner, diffusers_pipeline,
     and sd_backend to the Quicksettings, this will make controlling SDXL much easier.
   • Optionally, we have just added a new theme, Amethyst-Nightfall, (It's purple!) you can select that at the top in UI theme.
   • Apply the settings, which will also apply some defaults from built-in extensions, then hit Restart Server.

Installing SDXL

To use SDXL with SD.Next, all you need to do is download these two files into your models folder.
SD-XL Base
SD-XL Refiner

More detailed instructions for installation and use here.

Install Python and Git

To install Python and Git on Windows and macOS, please follow the instructions below:

For Windows:

1. Git:

   • Download Git for Windows from the following link: Git for Windows
   • Run the downloaded .exe file and follow the installation wizard.
   • During the installation process, make sure to check the box for "Use Git from the Windows Command line and also from 3rd-party-software" to add Git to your system's PATH.
   • Complete the installation by following the on-screen instructions.

2. Python:

   • Download Python for Windows from the following link: Python for Windows
   • Run the downloaded .exe file and follow the installation wizard.
   • On the "Customize Python" screen, make sure to check the box for "Add Python to PATH."
   • Continue the installation by following the prompts.
   • Once the installation is complete, you can open the command prompt and verify that Python is installed by typing python --version and pip --version to check the Python and Pip versions respectively.

For macOS:

1. Git:

   • Download Git for macOS from the following link: Git for macOS
   • Open the downloaded .pkg file and follow the installation instructions.
   • During the installation process, make sure to check the box for "Install Git Bash" to have a command-line Git interface.
   • Complete the installation by following the prompts.

2. Python:

   • Download Python for macOS from the following link: Python for macOS
   • Open the downloaded .pkg file and follow the installation instructions.
   • On the "Introduction" screen, click "Continue," and then "Install" on the subsequent screen.
   • Authenticate the installation using your macOS password.
   • On the "Install Python 3.10" screen, make sure to check the box for "Add Python 3.10 to PATH."
   • Continue the installation by following the prompts.
   • Once the installation is complete, open the Terminal application and verify that Python is installed by typing python3 --version and pip3 --version to check the Python and Pip versions respectively.