Skip to content
Local AI Wizard
Your machine
Theme

SmolVLM-500M-Instruct

Hugging Face · HuggingFaceTB/SmolVLM-500M-Instruct

Weights license: Apache 2.0 · code and components may use other terms

Hub downloads · 30 days138.4KPopularity, not quality · read 2026-10-25
Memory needed~1 GBQ4 weights + working room, before the machine's reserve
Parameters0.5 BHub safetensors total
Repository updated2025-04-08A commit is not a release date

Quality

No comparable score

We track no public, comparable benchmark that covers this model yet. No score is inferred.

Reported by the publisher

The publisher's card states no benchmark result for this checkpoint (read 2026-10-25). not published on the card · read 2026-10-25

Runs on

Fast memory holds it 119

The planning estimate fits the memory the model can use quickly: graphics card VRAM, or unified memory within the macOS GPU share.

Show all 119

Hardware profiles grouped by the Q4 planning estimate on each machine (dedicated GPUs reserve 2 GB; unified and system memory 25%, 2 to 8 GB): the fast memory holds it, it is within memory but outside the fast part (layers offloaded to PC RAM, or above the macOS GPU share), or the machine is one memory tier short. Not a measured fit or speed.

Consider it for

Hugging Face released SmolVLM-500M-Instruct on 2025-01-23: a vision-language model that answers about images, with 500M parameters on the Hugging Face count and the Apache 2.0 license. Languages the publisher declares: en.

Check first

License: commercial use allowed. At Q4 the weights load about 0.4 GB before each machine's reserve; image resolution, video frames and context add memory, and the vision encoder needs support in the runtime you pick.

Measured speed

No published measurement for this checkpoint

Tokens per second are shown only when a source publishes them with hardware, build and setup. They are never estimated.

How to run

Runtime compatibility and tokens per second have not been measured for this entry. Published metadata and a memory estimate do not prove a successful local run.

Library in source: transformers

Documented ways to run it

Copied as printed in the linked source (read 2026-10-18); not run by this site.

Transformers · model card · How to get started
import torch
from PIL import Image
from transformers import AutoProcessor, AutoModelForVision2Seq
from transformers.image_utils import load_image

DEVICE = "cuda" if torch.cuda.is_available() else "cpu"

# Load images
image = load_image("https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg")

# Initialize processor and model
processor = AutoProcessor.from_pretrained("HuggingFaceTB/SmolVLM-500M-Instruct")
model = AutoModelForVision2Seq.from_pretrained(
    "HuggingFaceTB/SmolVLM-500M-Instruct",
    torch_dtype=torch.bfloat16,
    _attn_implementation="flash_attention_2" if DEVICE == "cuda" else "eager",
).to(DEVICE)

# Create input messages
messages = [
    {
        "role": "user",
        "content": [
            {"type": "image"},
            {"type": "text", "text": "Can you describe this image?"}
        ]
    },
]

# Prepare inputs
prompt = processor.apply_chat_template(messages, add_generation_prompt=True)
inputs = processor(text=prompt, images=[image], return_tensors="pt")
inputs = inputs.to(DEVICE)

# Generate outputs
generated_ids = model.generate(**inputs, max_new_tokens=500)
generated_texts = processor.batch_decode(
    generated_ids,
    skip_special_tokens=True,
)

print(generated_texts[0])
"""
Assistant: The image depicts a cityscape featuring a prominent landmark, the Statue of Liberty, prominently positioned on Liberty Island. The statue is a green, humanoid figure with a crown atop its head and is situated on a small island surrounded by water. The statue is characterized by its large, detailed structure, with a statue of a woman holding a torch above her head and a tablet in her left hand. The statue is surrounded by a small, rocky island, which is partially visible in the foreground.
In the background, the cityscape is dominated by numerous high-rise buildings, which are densely packed and vary in height. The buildings are primarily made of glass and steel, reflecting the sunlight and creating a bright, urban skyline. The skyline is filled with various architectural styles, including modern skyscrapers and older, more traditional buildings.
The water surrounding the island is calm, with a few small boats visible, indicating that the area is likely a popular tourist destination. The water is a deep blue, suggesting that it is a large body of water, possibly a river or a large lake.
In the foreground, there is a small strip of land with trees and grass, which adds a touch of natural beauty to the urban landscape. The trees are green, indicating that it is likely spring or summer.
The image captures a moment of tranquility and reflection, as the statue and the cityscape come together to create a harmonious and picturesque scene. The statue's presence in the foreground draws attention to the city's grandeur, while the calm water and natural elements in the background provide a sense of peace and serenity.
In summary, the image showcases the Statue of Liberty, a symbol of freedom and democracy, set against a backdrop of a bustling cityscape. The statue is a prominent and iconic representation of human achievement, while the cityscape is a testament to human ingenuity and progress. The image captures the beauty and complexity of urban life, with the statue serving as a symbol of hope and freedom, while the cityscape provides a glimpse into the modern world.
"""

Choose my computer

Technical details

What the source and the catalog store for this checkpoint. Missing fields are left out, never zero.

Task
image-text-to-text
Architecture
Idefics3ForConditionalGeneration
Library in source
transformers
Weight license
Apache 2.0HuggingFaceTB/SmolVLM-500M-Instruct model card (Hugging Face) · read 2026-10-18source
Commercial use
Allowed Apache License 2.0 text (SPDX) · read 2026-10-18license text
Languages
enModel card metadata · read 2026-10-25source
Released
SmolVLM Grows Smaller – Introducing the 256M & 500M Models! (Hugging Face blog) · read 2026-10-18source
Every stored field12 fields
Revision checked
a7da5b986cb59b408707209984f360a5f4ad7e47
Architecture
Idefics3ForConditionalGeneration
Library
transformers
Hub task tag
image-text-to-text
Declared base models
HuggingFaceTB/SmolLM2-360M-Instruct · google/siglip-base-patch16-512
Formats
transformers, onnx, safetensors
Access
Open download
Publisher kind
Official
Repository created
2025-01-20creation is not the model's release
Repository updated
2025-04-08a commit is not a release date
Hub downloads (30 days) · likes
138,382 · 198this repository only · read 2026-10-25
Catalog state
Hub config or weights found; no inventory benchmark link

Sources

Identity and published specifications come from the checkpoint page. Benchmark scores belong to the named release and do not measure speed on your computer.

Curated facts checked: 2026-10-18. The license and release date cite the publisher's sources; parameters, files and task come from the Hugging Face record, and memory is a labelled estimate from its parameter count. A value no source states stays empty; a repository commit is not a model release date.