Advanced Install

Start Scripts

Start scripts webui.bat and webui.sh create and activate venv (a Python virtual environment), then start the launcher.
The scripts do not perform any other setup tasks.

The launcher itself is started with python launch.py.

If you start the launcher manually without creating and activating venv first, dependencies are installed system-wide.
This can be intentional when running SD.Next in a dedicated container where extra virtual-environment isolation is not needed.

VENV

By default, SD.Next uses venv to install dependencies.
Using venv is optional, but recommended to avoid dependency conflicts with other applications.

You can pre-create venv with specific options. For example:

python -m venv venv --system-site-packages

This setup uses system site packages where available and installs only missing or incompatible packages inside venv.

Upgrades

SD.Next includes a built-in upgrade path with the --upgrade flag, and manual upgrades with git pull are also supported.

Important

If you use manual upgrades with git pull, also update all submodules.