|
--- |
|
library_name: diffusers |
|
base_model: stabilityai/stable-diffusion-xl-base-1.0 |
|
tags: |
|
- lora |
|
- text-to-image |
|
license: openrail++ |
|
inference: false |
|
--- |
|
|
|
# Latent Consistency Model (LCM) LoRA: SDXL |
|
|
|
Latent Consistency Model (LCM) LoRA was proposed in [LCM-LoRA: A universal Stable-Diffusion Acceleration Module](TODO:) |
|
by *Simian Luo, Yiqin Tan, Suraj Patil, Daniel Gu et al.* |
|
|
|
It is a distilled consistency adapter for [`stable-diffusion-xl-base-1.0`](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0) that allows |
|
to reduce the number of inference steps to only between **2 - 8 steps**. |
|
|
|
| Model | Params / M | |
|
|----------------------------------------------------------------------------|------------| |
|
| [lcm-lora-sdv1-5](https://huggingface.co/latent-consistency/lcm-lora-sdv1-5) | 67.5 | |
|
| [lcm-lora-ssd-1b](https://huggingface.co/latent-consistency/lcm-lora-ssd-1b) | 105 | |
|
| [**lcm-lora-sdxl**](https://huggingface.co/latent-consistency/lcm-lora-sdxl) | **197M** | |
|
|
|
## Usage |
|
|
|
LCM-LoRA is supported in 🤗 Hugging Face Diffusers library from version v0.23.0 onwards. To run the model, first |
|
install the latest version of the Diffusers library as well as `peft`, `accelerate` and `transformers`. |
|
audio dataset from the Hugging Face Hub: |
|
|
|
```bash |
|
pip install --upgrade pip |
|
pip install --upgrade diffusers transformers accelerate peft |
|
``` |
|
|
|
### Text-to-Image |
|
|
|
The adapter can be loaded with it's base model `stabilityai/stable-diffusion-xl-base-1.0`. Next, the scheduler needs to be changed to [`LCMScheduler`](https://huggingface.co/docs/diffusers/v0.22.3/en/api/schedulers/lcm#diffusers.LCMScheduler) and we can reduce the number of inference steps to just 2 to 8 steps. |
|
Please make sure to either disable `guidance_scale` or use values between 1.0 and 2.0. |
|
|
|
```python |
|
import torch |
|
from diffusers import LCMScheduler, AutoPipelineForText2Image |
|
|
|
model_id = "stabilityai/stable-diffusion-xl-base-1.0" |
|
adapter_id = "latent-consistency/lcm-lora-sdxl" |
|
|
|
pipe = AutoPipelineForText2Image.from_pretrained(model_id, torch_dtype=torch.float16, variant="fp16") |
|
pipe.scheduler = LCMScheduler.from_config(pipe.scheduler.config) |
|
pipe.to("cuda") |
|
|
|
# load and fuse lcm lora |
|
pipe.load_lora_weights(adapter_id) |
|
pipe.fuse_lora() |
|
|
|
|
|
prompt = "Self-portrait oil painting, a beautiful cyborg with golden hair, 8k" |
|
|
|
# disable guidance_scale by passing 0 |
|
image = pipe(prompt=prompt, num_inference_steps=4, guidance_scale=0).images[0] |
|
``` |
|
|
|
### Image-to-Image |
|
|
|
Works as well! TODO docs |
|
|
|
### Inpainting |
|
|
|
Works as well! TODO docs |
|
|
|
### ControlNet |
|
|
|
Works as well! TODO docs |
|
|
|
### T2I Adapter |
|
|
|
Works as well! TODO docs |
|
|
|
## Speed Benchmark |
|
|
|
TODO |
|
|
|
## Training |
|
|
|
TODO |
|
|
