Skip to content

[transformers snippet] Support pipeline VLMs#1012

Open
mishig25 wants to merge 1 commit intomainfrom
transformers_vlm_snippet
Open

[transformers snippet] Support pipeline VLMs#1012
mishig25 wants to merge 1 commit intomainfrom
transformers_vlm_snippet

Conversation

@mishig25
Copy link
Collaborator

@mishig25 mishig25 commented Nov 4, 2024

Description

Rn, if you go to conversational VLM like Llama-3.2-11B-Vision-Instruct, you would not receive high-level pipeline snippet.
On the contrary, if you go to conversational LLM like Llama-3.1-8B-Instruct, you will receive high-level pipeline snippet.

huggingface/transformers#34170 was merged. Therefore, now we can add pipeline snippet for VLM.

Here is an example snippet, one would get

# Use a pipeline as a high-level helper
from transformers import pipeline

image_ny = "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
image_chicago = "https://cdn.britannica.com/59/94459-050-DBA42467/Skyline-Chicago.jpg"

pipe = pipeline("image-text-to-text", model="meta-llama/Llama-3.2-11B-Vision-Instruct")
pipe(
    images=[image_ny, image_chicago],
    text="<image> <image> Are these the same cities? If not what cities are these?",
)

@mishig25 mishig25 marked this pull request as ready for review November 4, 2024 09:56
@mishig25 mishig25 changed the title [transformers snippet] Support VLMs [transformers snippet] Support pipeline VLMs Nov 4, 2024
Copy link
Member

@pcuenca pcuenca left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Has huggingface/transformers#34170 been released? If it hasn't, should we wait until the next transformers release before merging or is it ok?

Comment on lines +856 to +857
`image_ny = "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"`,
`image_chicago = "https://cdn.britannica.com/59/94459-050-DBA42467/Skyline-Chicago.jpg"`,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The example is super nice, but not all image-text-to-text models support multiple images reliably. I'd go for a simpler single-image example for now.

@yonigozlan
Copy link
Member

yonigozlan commented Nov 4, 2024

The example is super nice, but not all image-text-to-text models support multiple images reliably. I'd go for a simpler single-image example for now.

Agreed with this! another problem is that although most models use the <image> token, some models use a different token. For example, Pixtral uses [IMG], and mllama uses <|image|>, so this snippet would not work with these models.

However since you have this check:

if (model.tags.includes("conversational") && model.config?.tokenizer_config?.chat_template) {

It would be even better and simpler to use chat template for vlms also, with something like this:

image_ny = "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
image_chicago = "https://cdn.britannica.com/59/94459-050-DBA42467/Skyline-Chicago.jpg"
messages = [
    {
        "role": "user",
        "content": [
            {"type": "text", "text": "What’s the difference between these two images?"},
            {"type": "image"},
            {"type": "image"},
        ],
    }
]
outputs = pipe([image_ny, image_chicago], text=messages)

@merveenoyan
Copy link
Contributor

I completely agree with @yonigozlan best to have chat template

@pcuenca
Copy link
Member

pcuenca commented Jul 11, 2025

I think this was finally handled by @Vaibhavs10 in #1434 (sorry, I did not remember about this PR when the other one was opened)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants