Amused is a lightweight text to image model based off of the muse architecture. Amused is particularly useful in applications that require a lightweight and fast model such as generating many images quickly at once.
image/png
The diagram shows the training and inference pipelines for aMUSEd. aMUSEd consists
of three separately trained components: a pre-trained CLIP-L/14 text encoder, a VQ-GAN, and a
U-ViT. During training, the VQ-GAN encoder maps images to a 16x smaller latent resolution. The
proportion of masked latent tokens is sampled from a cosine masking schedule, e.g. cos(r · π
2 )
with r ∼ Uniform(0, 1). The model is trained via cross-entropy loss to predict the masked tokens.
After the model is trained on 256x256 images, downsampling and upsampling layers are added, and
training is continued on 512x512 images. During inference, the U-ViT is conditioned on the text
encoder’s hidden states and iteratively predicts values for all masked tokens. The cosine masking
schedule determines a percentage of the most confident token predictions to be fixed after every
iteration. After 12 iterations, all tokens have been predicted and are decoded by the VQ-GAN into
image pixels.
Amused inherits performance benefits from original muse.
Parallel decoding: The model follows a denoising schedule that aims to unmask some percent of tokens at each denoising step. At each step, all masked tokens are predicted, and some number of tokens that the network is most confident about are unmasked. Because multiple tokens are predicted at once, we can generate a full 256x256 or 512x512 image in around 12 steps. In comparison, an autoregressive model must predict a single token at a time. Note that a 256x256 image with the 16x downsampled VAE that muse uses will have 256 tokens.
Fewer sampling steps: Compared to many diffusion models, muse requires fewer samples.
Additionally, amused uses the smaller CLIP as its text encoder instead of T5 compared to muse. Amused is also smaller with ~600M params compared the largest 3B param muse model. Note that being smaller, amused produces comparably lower quality results.
image/png
Muse performance knobs
Uncompiled Transformer + regular attention
Uncompiled Transformer + flash attention (ms)
Compiled Transformer (ms)
Speed Up
256 Batch Size 1
594.7
507.7
212.1
58%
512 Batch Size 1
637
547
249.9
54%
256 Batch Size 8
719
628.6
427.8
32%
512 Batch Size 8
1000
917.7
703.6
23%
Flash attention is enabled by default in the diffusers codebase through torch F.scaled_dot_product_attention
torch.compile
To use torch.compile, simply wrap the transformer in torch.compile i.e.
1import torch
2from diffusers import AmusedPipeline
34pipe = AmusedPipeline.from_pretrained(5"huggingface/amused-256", variant="fp16", torch_dtype=torch.float16
6)78# HERE use torch.compile9pipe.transformer = torch.compile(pipe.transformer)1011pipe.vqvae.to(torch.float32)# vqvae is producing nans in fp1612pipe = pipe.to("cuda")1314prompt ="cowboy"15image = pipe(prompt, generator=torch.Generator('cuda').manual_seed(8)).images[0]16image.save('text2image_256.png')
3. Training
Amused can be finetuned on simple datasets relatively cheaply and quickly. Using 8bit optimizers, lora, and gradient accumulation, amused can be finetuned with as little as 5.5 GB. Here are a set of examples for finetuning amused on some relatively simple datasets. These training recipies are aggressively oriented towards minimal resources and fast verification -- i.e. the batch sizes are quite low and the learning rates are quite high. For optimal quality, you will probably want to increase the batch sizes and decrease learning rates.
All training examples use fp16 mixed precision and gradient checkpointing. We don't show 8 bit adam + lora as its about the same memory use as just using lora (bitsandbytes uses full precision optimizer states for weights below a minimum size).
1accelerate launch training/training.py \
2 --output_dir <output path> \
3 --train_batch_size <batch size> \
4 --gradient_accumulation_steps <gradient accumulation steps> \
5 --learning_rate 1e-4 \
6 --pretrained_model_name_or_path amused/amused-256 \
7 --instance_data_dataset 'm1guelpf/nouns' \
8 --image_key image \
9 --prompt_key text \
10 --resolution 256 \
11 --mixed_precision fp16 \
12 --lr_scheduler constant \
13 --validation_prompts \
14 'a pixel art character with square red glasses, a baseball-shaped head and a orange-colored body on a dark background' \
15 'a pixel art character with square orange glasses, a lips-shaped head and a red-colored body on a light background' \
16 'a pixel art character with square blue glasses, a microwave-shaped head and a purple-colored body on a sunny background' \
17 'a pixel art character with square red glasses, a baseball-shaped head and a blue-colored body on an orange background' \
18 'a pixel art character with square red glasses' \
19 'a pixel art character' \
20 'square red glasses on a pixel art character' \
21 'square red glasses on a pixel art character with a baseball-shaped head' \
22 --max_train_steps 10000 \
23 --checkpointing_steps 500 \
24 --validation_steps 250 \
25 --gradient_checkpointing
Full finetuning + 8 bit adam
Note that this training config keeps the batch size low and the learning rate high to get results fast with low resources. However, due to 8 bit adam, it will diverge eventually. If you want to train for longer, you will have to up the batch size and lower the learning rate.
1accelerate launch training/training.py \
2 --output_dir <output path> \
3 --train_batch_size <batch size> \
4 --gradient_accumulation_steps <gradient accumulation steps> \
5 --learning_rate 2e-5 \
6 --use_8bit_adam \
7 --pretrained_model_name_or_path amused/amused-256 \
8 --instance_data_dataset 'm1guelpf/nouns' \
9 --image_key image \
10 --prompt_key text \
11 --resolution 256 \
12 --mixed_precision fp16 \
13 --lr_scheduler constant \
14 --validation_prompts \
15 'a pixel art character with square red glasses, a baseball-shaped head and a orange-colored body on a dark background' \
16 'a pixel art character with square orange glasses, a lips-shaped head and a red-colored body on a light background' \
17 'a pixel art character with square blue glasses, a microwave-shaped head and a purple-colored body on a sunny background' \
18 'a pixel art character with square red glasses, a baseball-shaped head and a blue-colored body on an orange background' \
19 'a pixel art character with square red glasses' \
20 'a pixel art character' \
21 'square red glasses on a pixel art character' \
22 'square red glasses on a pixel art character with a baseball-shaped head' \
23 --max_train_steps 10000 \
24 --checkpointing_steps 500 \
25 --validation_steps 250 \
26 --gradient_checkpointing
1accelerate launch training/training.py \
2 --output_dir <output path> \
3 --train_batch_size <batch size> \
4 --gradient_accumulation_steps <gradient accumulation steps> \
5 --learning_rate 8e-4 \
6 --use_lora \
7 --pretrained_model_name_or_path amused/amused-256 \
8 --instance_data_dataset 'm1guelpf/nouns' \
9 --image_key image \
10 --prompt_key text \
11 --resolution 256 \
12 --mixed_precision fp16 \
13 --lr_scheduler constant \
14 --validation_prompts \
15 'a pixel art character with square red glasses, a baseball-shaped head and a orange-colored body on a dark background' \
16 'a pixel art character with square orange glasses, a lips-shaped head and a red-colored body on a light background' \
17 'a pixel art character with square blue glasses, a microwave-shaped head and a purple-colored body on a sunny background' \
18 'a pixel art character with square red glasses, a baseball-shaped head and a blue-colored body on an orange background' \
19 'a pixel art character with square red glasses' \
20 'a pixel art character' \
21 'square red glasses on a pixel art character' \
22 'square red glasses on a pixel art character with a baseball-shaped head' \
23 --max_train_steps 10000 \
24 --checkpointing_steps 500 \
25 --validation_steps 250 \
26 --gradient_checkpointing
Finetuning the 512 checkpoint
These examples finetune on this minecraft dataset.
Styledrop is an efficient finetuning method for learning a new style from a small number of images. It has an optional first stage to generate human picked additional training samples. The additional training samples can be used to augment the initial images. Our examples exclude the optional additional image selection stage and instead we just finetune on a single image.
This is our example style image:
example
256
Example results:
glowing_256_1
glowing_256_2
glowing_256_3
Learning rate: 4e-4, Gives decent results in 1500-2000 steps
sh
1accelerate launch ./training/training.py \
2 --output_dir <output path> \
3 --mixed_precision fp16 \
4 --report_to wandb \
5 --use_lora \
6 --pretrained_model_name_or_path amused/amused-256 \
7 --train_batch_size 1 \
8 --lr_scheduler constant \
9 --learning_rate 4e-4 \
10 --validation_prompts \
11 'A chihuahua walking on the street in [V] style' \
12 'A banana on the table in [V] style' \
13 'A church on the street in [V] style' \
14 'A tabby cat walking in the forest in [V] style' \
15 --instance_data_image './training/A mushroom in [V] style.png' \
16 --max_train_steps 10000 \
17 --checkpointing_steps 500 \
18 --validation_steps 100 \
19 --resolution 256
accelerate launch ./training/training.py \
--output_dir ../styledrop \
--mixed_precision fp16 \
--report_to wandb \
--use_lora \
--pretrained_model_name_or_path amused/amused-512 \
--train_batch_size 1 \
--lr_scheduler constant \
--learning_rate 1e-3 \
--validation_prompts \
'A chihuahua walking on the street in [V] style' \
'A banana on the table in [V] style' \
'A church on the street in [V] style' \
'A tabby cat walking in the forest in [V] style' \
--instance_data_image './training/A mushroom in [V] style.png' \
--max_train_steps 100000 \
--checkpointing_steps 500 \
--validation_steps 100 \
--resolution 512 \
--lora_alpha 1
4. Acknowledgements
Suraj led training. William led data and supported training. Patrick supported both training and
data and provided general guidance. Robin trained the VQ-GAN and provided general guidance.
Also, immense thanks to community contributor Isamu Isozaki for helpful discussions and code
contributions.
5. Citation
@misc{patil2024amused,
title={aMUSEd: An Open MUSE Reproduction},
author={Suraj Patil and William Berman and Robin Rombach and Patrick von Platen},
year={2024},
eprint={2401.01808},
archivePrefix={arXiv},
primaryClass={cs.CV}
}
