Within the final couple of years, I’ve labored primarily with giant language fashions, coaching, fine-tuning, prompting and so forth, since this was extremely requested out there and by customers. However I consider that LLMs that work primarily on textual content is just the start of GenAI. At a sure level, all people will need bodily AI, the place fashions can see, hear, really feel, and motive in a extra grounded, human means.
So let’s get began with multimodality. On this pocket book, I introduce LLaVA, an structure able to deciphering each pictures and textual content to generate multimodal responses.
On this tutorial, we’re going to use a lighter-weight element appropriate to run the pocket book on a free-tier atmosphere resembling Google Colab.
The parts we’re going to use are:
1️⃣ CLIP-ViT B/32 because the picture encoder
2️⃣ TinyLlama-1.1B because the language mannequin
3️⃣ A 2-layer MLP adapter to bridge the 2
Setup
Earlier than we are able to dive into the code, let’s arrange our surroundings.
Let’s first set up the datasets library.
!pip set up -U datasetsWe now must import the required packages from Hugging Face and PyTorch. These imports present pre-trained fashions and utilities for multimodal processing.
import json
from pathlib import Path
import requests
import safetensors
import torch
from datasets import load_dataset
from huggingface_hub import hf_hub_download
from PIL import Picture
from transformers import (
AutoConfig,
AutoTokenizer,
LlamaTokenizer,
LlavaConfig,
LlavaForConditionalGeneration,
LlavaProcessor,
Seq2SeqTrainer,
Seq2SeqTrainingArguments,
)
from transformers.fashions.clip.modeling_clip import CLIPVisionModel
from transformers.fashions.clip.image_processing_clip import CLIPImageProcessorObtain pre-trained mannequin parts
Our LLaVA mannequin shall be composed of:
The hf_hub_download is a hub we’re exploring with the intention to retrieve pre-trained weights:
vision_backbone_name = "openai/clip-vit-base-patch32"
text_backbone_name = "TinyLlama/TinyLlama-1.1B-Chat-v1.0"_ = hf_hub_download(
vision_backbone_name, filename="pytorch_model.bin", local_dir="/content material"
)
_ = hf_hub_download(
text_backbone_name, filename="mannequin.safetensors", local_dir="/content material"
)Mannequin
Instantiate a brand new LLaVA mannequin
Let’s now instantiate a brand new LlaVA mannequin. As defined above, a LlaVA mannequin consists of two elements, a visible encoder and a textual decoder that we’ve got simply downloaded.
vision_config = AutoConfig.from_pretrained(vision_backbone_name).vision_config
text_config = AutoConfig.from_pretrained(text_backbone_name)We specify the spine fashions within the LlaVA config. We then instantiate the precise mannequin with LlavaForConditionalGeneration(llava_config).
llava_config = LlavaConfig(vision_config=vision_config, text_config=text_config)mannequin = LlavaForConditionalGeneration(llava_config).cuda()
mannequinCarry out some surgical operations
Beforehand, we mentioned we may assemble an LLaVA mannequin by ranging from a pre-trained picture encoder and a pre-trained LLM. Let’s do exactly that!
The unique LLaVA mannequin is initialised from a CLIP-ViT L/14 and a Vicuna v1.5 7B. To make issues extra manageable with the assets offered by the free plan of Google Colab, we’ll use a CLIP-ViT B/16 and a TinyLlama 1.1B.
The one element we’ll prepare is a 2-layer MLP adapter in between them.
With a purpose to use the CLIP and TinyLlama fashions, we have to load their pre-trained weights. However these weights can come in numerous codecs like .safetensors or .bin. The load_weights perform handles this for us. It checks the file kind and calls the proper loading perform.
def load_weights(path_to_weights: str):
if path_to_weights.endswith(".safetensors"):
return load_safetensors_weights(path_to_weights)
elif path_to_weights.endswith(".bin"):
return load_bin_weights(path_to_weights)
else:
increase ValueError(f"Unsupported weights file: {path_to_weights}")
def load_bin_weights(path_to_weights: str):
return torch.load(path_to_weights, weights_only=True)
def load_safetensors_weights(path_to_weights: str):
return safetensors.torch.load_file(path_to_weights)vision_backbone_state_dict = load_weights("/content material/pytorch_model.bin")
text_backbone_state_dict = load_weights("/content material/mannequin.safetensors")Inject the imaginative and prescient spine’s weights into the mannequin 💉
The subsequent traces hundreds the weights into the imaginative and prescient a part of the mannequin. We set strict=False to be versatile because it permits us to skip any weights that don’t completely match the mannequin’s anticipated construction.
incompatible_keys = mannequin.vision_tower.load_state_dict(
vision_backbone_state_dict, strict=False
)
assert len(incompatible_keys.missing_keys) == 0, (
f"Lacking keys in state dict: {incompatible_keys.missing_keys}"
)
incompatible_keys.unexpected_keysInject the textual content spine’s weights into the mannequin 💉
Similar logic as earlier than, but in addition for the textual content mannequin.
incompatible_keys = mannequin.language_model.load_state_dict(
text_backbone_state_dict, strict=True
)Freeze the pre-trained parts ❄️
We wish now to freeze the spine visible and textual content fashions, as a result of we don’t need to replace their weights whereas coaching.
We are going to solely prepare the small adapter (the MLP that connects imaginative and prescient and language), which is way lighter and quicker to coach.
_ = mannequin.vision_tower.requires_grad_(False)
_ = mannequin.language_model.requires_grad_(False)# Then we outline a helper perform to rely mannequin parameters
def count_parameters(mannequin, trainable_only=False):
return sum(
p.numel()
for p in mannequin.parameters()
if not trainable_only or p.requires_grad
)
print(f"Complete parameters: {count_parameters(mannequin)}")
print(f"Trainable parameters: {count_parameters(mannequin, trainable_only=True)}")Processor
Earlier than feeding some textual content into our mannequin, we have to convert phrases into numbers. That is what the tokenizer is required for.
tokenizer = LlamaTokenizer.from_pretrained(
text_backbone_name, additional_special_tokens=["", ""]
)
tokenizer.pad_token_id = 32001 Beneath is the format we’ll use to talk with our LLaVA mannequin.
The primary half is the so-called system immediate, which incorporates common tips for a way the mannequin ought to reply to the consumer.
The second half is a Jinja template (principally code) that determines how the dialog is rendered primarily based on some structured enter (see instance under).
LLAVA_CHAT_TEMPLATE = (
"A chat between a curious consumer and a man-made intelligence assistant. The assistant provides useful, detailed, and well mannered solutions to the consumer's questions. "
"{% for message in messages %}{% if message['role'] == 'consumer' %}USER: {% else %}ASSISTANT: {% endif %}{% for merchandise in message['content'] %}{% if merchandise['type'] == 'textual content' %}{{ merchandise['text'] }}{% elif merchandise['type'] == 'picture' %}{% endif %}{% endfor %}{% if message['role'] == 'consumer' %} {% else %}{{eos_token}}{% endif %}{% endfor %}"
)
tokenizer.chat_template = LLAVA_CHAT_TEMPLATE sample_messages = [
{
"content": [
{
"index": 0,
"text": None,
"type": "image"
},
{
"index": None,
"text": "nWhat potential activities might be popular at this location?",
"type": "text"
}
],
"function": "consumer"
},
{
"content material": [
{
"index": None,
"text": (
"At this location, with a sandy path leading to the ocean where multiple boats, including "
"sailboats, are moored, popular activities might include boating, sailing, swimming, and "
"beachcombing. Additionally, the sandy path and shoreline provide an ideal setting for leisurely "
"strolls and picnics, while the ocean view offers a serene environment for relaxation and "
"photography. Depending on the specific area and available facilities, other water sports such as "
"kayaking, paddleboarding, and snorkeling could also be prevalent."
),
"type": "text"
}
],
"function": "assistant"
}
]Let’s apply the chat template to our samples.
tokenizer.apply_chat_template(
sample_messages, tokenize=False, add_generation_prompt=False
)At this level we’ve arrange our tokenizer and downloaded the imaginative and prescient mannequin. We convey them collectively into one unified processor.
processor = LlavaProcessor(
image_processor=CLIPImageProcessor.from_pretrained(vision_backbone_name),
tokenizer=tokenizer,
patch_size=mannequin.config.vision_config.patch_size,
)
processor.chat_template = LLAVA_CHAT_TEMPLATESince we added particular tokens like
mannequin.resize_token_embeddings(len(tokenizer), pad_to_multiple_of=8)Dataset
Let’s obtain the dataset we’re going to use from Hugging Face.
The dataset containing samples of image-text {couples} is publicly obtainable and could be discovered here.
train_dataset = load_dataset(
"HuggingFaceH4/llava-instruct-mix-vsft", cut up="prepare", streaming=True
)What do our coaching examples appear like?
subsequent(iter(train_dataset))How can we construct a batch of examples?
The next perform takes uncooked image-text examples and turns them into model-ready inputs. It codecs the messages utilizing the chat template, processes each the textual content and picture with the LlavaProcessor we outlined beforehand, and creates correct coaching labels whereas ignoring padding.
def get_data_collator(processor, ignore_index):
def collate_examples(examples):
# Extract texts and pictures from the uncooked examples
texts = []
pictures = []
for instance in examples:
messages = instance["messages"]
textual content = processor.tokenizer.apply_chat_template(
messages, tokenize=False, add_generation_prompt=False
)
texts.append(textual content)
pictures.append(instance["images"][0])
# Course of the inputs (tokenize textual content and rework pictures)
batch = processor(texts, pictures, return_tensors="pt", padding=True)
# Create labels
labels = batch["input_ids"].clone()
if processor.tokenizer.pad_token_id shouldn't be None:
labels[labels == processor.tokenizer.pad_token_id] = ignore_index
batch["labels"] = labels
return batch
return collate_examples
# NOTE: this does a bit greater than a collate perform ought to...Coaching
Let’s lastly outline the coaching arguments, together with batch measurement, studying charge, complete steps, and use blended precision (fp16) for pace. We additionally keep away from saving checkpoints to maintain issues gentle. Then we wrap the whole lot right into a Seq2SeqTrainerpassing within the mannequin, dataset, and our customized collator for image-text inputs.
args = Seq2SeqTrainingArguments(
output_dir="/content material/training_output",
per_device_train_batch_size=2,
gradient_accumulation_steps=4,
learning_rate=2e-4,
max_steps=350,
lr_scheduler_type="cosine_with_min_lr",
lr_scheduler_kwargs={"min_lr": 2e-5},
warmup_ratio=0.05,
logging_strategy="steps",
logging_steps=5,
fp16=True,
remove_unused_columns=False, # Vital!
optim="adamw_torch",
report_to="none",
save_strategy="no", # let's not save the checkpoint to disk, in any other case it will take 5 minutes
)
coach = Seq2SeqTrainer(
mannequin=mannequin,
args=args,
data_collator=get_data_collator(
processor, ignore_index=mannequin.config.ignore_index,
),
train_dataset=train_dataset,
)coach.prepare()Inference
To be famous that to ensure inference works as anticipated it’s best to use heavier fashions, and prepare for longer time.
We’ll use this picture for inference:
dialog = [
{
"content": [
{
"type": "image"
},
{
"text": "nWhat is represented in the image?",
"type": "text"
}
],
"function": "consumer"
}
]On this cell block for instance, we load a picture from a URL and format a dialog utilizing the chat template. The processor turns each into tensors. Then we transfer the enter to the mannequin’s gadget and generate a response, letting the mannequin describe the picture primarily based on the consumer’s immediate.
image_url = "https://llava-vl.github.io/static/pictures/monalisa.jpg"
inputs_for_generation = processor(
pictures=Picture.open(requests.get(image_url, stream=True).uncooked),
textual content=processor.apply_chat_template(dialog, add_generation_prompt=True),
return_tensors="pt",
)
inputs_for_generation = inputs_for_generation.to(gadget=mannequin.gadget)
output = coach.mannequin.generate(
**inputs_for_generation, max_new_tokens=200, do_sample=False
)print(processor.decode(output[0], skip_special_tokens=True))Extensions and enhancements
- Use a bigger picture encoder (e.g. CLIP-ViT Giant) and LLM (e.g. Llama 3.1 8B)
- Prepare for longer. It takes a while for the mannequin to determine the best way to comply with directions within the presence of picture options
- Observe the multi-stage coaching process adopted by the unique LLaVA
- Stage 1: Pre-training for Characteristic Alignment –> prepare the mannequin on single-turn instruction information, the place it’s requested to briefly describe the image. Picture encoder and LLM are frozen
- Stage 2: Wonderful-tuning Finish-to-Finish –> prepare the mannequin on multi-turn instruction information. Solely the picture encoder is frozen
Working demo: huggingface.co/spaces/badayvedat/LLaVA
Conclusion
I believe this small mission is attention-grabbing to raised perceive how multimodal fashions like LLaVA work. Even when we used smaller fashions, the primary concept is identical: mix imaginative and prescient and language into one system that may perceive pictures and speak about them.
After all, the outcomes obtained on this toy instance will not be actually good; there may be lots of area for enchancment. However making LLaVA work in an atmosphere with restricted assets is sort of difficult
Observe me on TDS for those who like this text! 😁
💼 Linkedin ️| 🐦 X (Twitter) | 💻 Web site
