Skip to content

Installation

Aptronymist edited this page Jul 26, 2023 · 25 revisions

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.
    • Run webui.bat --debug (Windows) or webui.sh --debug (Linux/Mac) to start the web interface.
    • It is recommended to include the --debug for more detailed information during the initial setup and for later tech support
      if necessary, at least for the time being for support purposes until the Diffusers backend is feature complete from HF, as well
      as potential compatibility issues.
    • 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.

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.
Clone this wiki locally