ColossalAI/examples/images/dreambooth
Maruyama_Aya 730a092ba2 modify shell for check 2023-06-08 13:38:18 +08:00
..
README.md change directory 2023-06-06 15:50:03 +08:00
colossalai.sh modify shell for check 2023-06-08 13:38:18 +08:00
debug.py [zero] reorganize zero/gemini folder structure (#3424) 2023-04-04 13:48:16 +08:00
dreambooth.sh modify file path 2023-06-07 11:02:19 +08:00
inference.py [example] fix save_load bug for dreambooth (#2280) 2023-01-03 17:13:29 +08:00
requirements.txt [dreambooth] fixing the incompatibity in requirements.txt (#3190) 2023-03-21 16:01:13 +08:00
test_ci.sh modify shell for check 2023-06-08 13:36:05 +08:00
train_dreambooth.py [example] support Dreamblooth (#2188) 2022-12-23 16:47:30 +08:00
train_dreambooth_colossalai.py modify shell for check 2023-06-08 13:17:58 +08:00
train_dreambooth_colossalai_lora.py fixed model saving bugs 2023-06-06 16:07:34 +08:00
train_dreambooth_inpaint.py [example] support Dreamblooth (#2188) 2022-12-23 16:47:30 +08:00

README.md

DreamBooth by colossalai

DreamBooth is a method to personalize text2image models like stable diffusion given just a few(3~5) images of a subject. The train_dreambooth_colossalai.py script shows how to implement the training procedure and adapt it for stable diffusion.

By accommodating model data in CPU and GPU and moving the data to the computing device when necessary, Gemini, the Heterogeneous Memory Manager of Colossal-AI can breakthrough the GPU memory wall by using GPU and CPU memory (composed of CPU DRAM or nvme SSD memory) together at the same time. Moreover, the model scale can be further improved by combining heterogeneous training with the other parallel approaches, such as data parallel, tensor parallel and pipeline parallel.

Installation

To begin with, make sure your operating system has the cuda version suitable for this exciting training session, which is cuda11.6-11.8. Notice that you may want to make sure the module versions suitable for the whole environment. Before running the scripts, make sure to install the library's training dependencies:

pip install -r requirements.txt

Install colossalai

pip install colossalai

From source

git clone https://github.com/hpcaitech/ColossalAI.git
python setup.py install

Dataset for Teyvat BLIP captions

Dataset used to train Teyvat characters text to image model.

BLIP generated captions for characters images from genshin-impact fandom wikiand biligame wiki for genshin impact.

For each row the dataset contains image and text keys. image is a varying size PIL png, and text is the accompanying text caption. Only a train split is provided.

The text include the tag Teyvat, Name,Element, Weapon, Region, Model type, and Description, the Description is captioned with the pre-trained BLIP model.

Training

We provide the script colossalai.sh to run the training task with colossalai. Meanwhile, we also provided traditional training process of dreambooth, dreambooth.sh, for possible comparation. For instance, the script of training process for [stable-diffusion-v1-4] model can be modified into:

export MODEL_NAME="CompVis/stable-diffusion-v1-4"
export INSTANCE_DIR="path-to-instance-images"
export OUTPUT_DIR="path-to-save-model"

torchrun --nproc_per_node 2 train_dreambooth_colossalai.py \
  --pretrained_model_name_or_path=$MODEL_NAME  \
  --instance_data_dir=$INSTANCE_DIR \
  --output_dir=$OUTPUT_DIR \
  --instance_prompt="a photo of sks dog" \
  --resolution=512 \
  --train_batch_size=1 \
  --learning_rate=5e-6 \
  --lr_scheduler="constant" \
  --lr_warmup_steps=0 \
  --max_train_steps=400 \
  --placement="cuda"
  • MODEL_NAME refers to the model you are training.
  • INSTANCE_DIR refers to personalized path to instance images, you might need to insert information here.
  • OUTPUT_DIR refers to local path to save the trained model, you might need to find a path with enough space.
  • resolution refers to the corresponding resolution number of your target model. Note: Change the resolution to 768 if you are using the stable-diffusion-2 768x768 model.
  • placement refers to the training strategy supported by Colossal AI, default = 'cuda', which refers to loading all the parameters into cuda memory. On the other hand, 'cpu' refers to 'cpu offload' strategy while 'auto' enables 'Gemini', both featured by Colossal AI.

Training with prior-preservation loss

Prior-preservation is used to avoid overfitting and language-drift. Refer to the paper to learn more about it. For prior-preservation we first generate images using the model with a class prompt and then use those during training along with our data.

According to the paper, it's recommended to generate num_epochs * num_samples images for prior-preservation. 200-300 works well for most cases. The num_class_images flag sets the number of images to generate with the class prompt. You can place existing images in class_data_dir, and the training script will generate any additional images so that num_class_images are present in class_data_dir during training time. The general script can be then modified as the following.

export MODEL_NAME="CompVis/stable-diffusion-v1-4"
export INSTANCE_DIR="path-to-instance-images"
export CLASS_DIR="path-to-class-images"
export OUTPUT_DIR="path-to-save-model"

torchrun --nproc_per_node 2 train_dreambooth_colossalai.py \
  --pretrained_model_name_or_path=$MODEL_NAME  \
  --instance_data_dir=$INSTANCE_DIR \
  --class_data_dir=$CLASS_DIR \
  --output_dir=$OUTPUT_DIR \
  --with_prior_preservation --prior_loss_weight=1.0 \
  --instance_prompt="a photo of sks dog" \
  --class_prompt="a photo of dog" \
  --resolution=512 \
  --train_batch_size=1 \
  --learning_rate=5e-6 \
  --lr_scheduler="constant" \
  --lr_warmup_steps=0 \
  --max_train_steps=800 \
  --placement="cuda"

New API

We have modified our previous implementation of Dreambooth with our new Booster API, which offers a more flexible and efficient way to train your model. The new API is more user-friendly and easy to use. You can find the new API in train_dreambooth_colossalai.py. We have also offer a shell script test_ci.sh for you to go through all our plugins for the booster. For more information about the booster API you can refer to https://colossalai.org/docs/basics/booster_api/.

Performance

Strategy #GPU Batch Size GPU RAM(GB) speedup
Traditional 1 16 oom \
Traditional 1 8 61.81 1
torch_ddp 4 16 oom \
torch_ddp 4 8 41.97 0.97
gemini 4 16 53.29 \
gemini 4 8 29.36 2.00
low_level_zero 4 16 52.80 \
low_level_zero 4 8 28.87 2.02

The evaluation is performed on 4 Nvidia A100 GPUs with 80GB memory each, with GPU 0 & 1, 2 & 3 connected with NVLink. We finetuned the stable-diffusion-v1-4 model with 512x512 resolution on the Teyvat dataset and compared the memory cost and the throughput for the plugins.

Inference

Once you have trained a model using above command, the inference can be done simply using the StableDiffusionPipeline. Make sure to include the identifier(e.g. --instance_prompt="a photo of sks dog" in the above example) in your prompt.

from diffusers import StableDiffusionPipeline
import torch

model_id = "path-to-save-model"
pipe = StableDiffusionPipeline.from_pretrained(model_id, torch_dtype=torch.float16).to("cuda")

prompt = "A photo of sks dog in a bucket"
image = pipe(prompt, num_inference_steps=50, guidance_scale=7.5).images[0]

image.save("dog-bucket.png")

Invitation to open-source contribution

Referring to the successful attempts of BLOOM and Stable Diffusion, any and all developers and partners with computing powers, datasets, models are welcome to join and build the Colossal-AI community, making efforts towards the era of big AI models!

You may contact us or participate in the following ways:

  1. Leaving a Star to show your like and support. Thanks!
  2. Posting an issue, or submitting a PR on GitHub follow the guideline in Contributing.
  3. Join the Colossal-AI community on Slack, and WeChat(微信) to share your ideas.
  4. Send your official proposal to email contact@hpcaitech.com

Thanks so much to all of our amazing contributors!