SDXL-Play

Note: this is a work-in-progress. If you follow these instructions you will hit a dead end.

This repository will try to provide instructions and a Python script for invoking SDXL txt2img.

SDXL useful links:

This repository assumes that you already have access to the base/refiner weights (e.g. you have been granted Researcher Early Access).

Setup

All instructions are written assuming your command-line shell is bash, and your OS is Linux.

Repository setup

Clone this repository (this will also retrieve the generative-models submodule):

git clone --recursive https://github.com/Birch-san/sdxl-play.git
cd sdxl-play

Create + activate a new virtual environment

This is to avoid interfering with your current Python environment (other Python scripts on your computer might not appreciate it if you update a bunch of packages they were relying on).

Follow the instructions for virtualenv, or conda, or neither (if you don't care what happens to other Python scripts on your computer).

Using `venv`

Create environment:

python -m venv venv
pip install --upgrade pip

Activate environment:

. ./venv/bin/activate

(First-time) update environment's pip:

pip install --upgrade pip

Using `conda`

Download conda.

Skip this step if you already have conda.

Install conda:

Skip this step if you already have conda.

Assuming you're using a bash shell:

# Linux installs Anaconda via this shell script. Mac installs by running a .pkg installer.
bash Anaconda-latest-Linux-x86_64.sh
# this step probably works on both Linux and Mac.
eval "$(~/anaconda3/bin/conda shell.bash hook)"
conda config --set auto_activate_base false
conda init

Create environment:

conda create -n p311-sdxl python=3.11

Activate environment:

conda activate p311-sdxl

Install package dependencies

Ensure you have activated the environment you created above.

Install dependencies:

pip install -r requirements_diffusers.txt
pip install invisible-watermark --no-deps

(Optional) treat yourself to latest nightly of PyTorch, with support for Python 3.11 and CUDA 12.1:

# CUDA
pip install --upgrade --pre torch torchvision --extra-index-url https://download.pytorch.org/whl/nightly/cu121
# Mac
pip install --upgrade --pre torch torchvision --extra-index-url https://download.pytorch.org/whl/nightly/cpu

We deliberately avoid installing generative-models' requirements files, as lots of the dependencies there exist to support training or watermarking.

Run:

From root of repository:

python -m scripts.sdxl_diffusers_play

License

3-clause BSD license; see LICENSE.txt

ttjjmm/sdxl-play