smolvlm

Analyze images locally and answer visual questions with SmolVLM-2B.

41|3|Updated Jan 2, 2026
One-click install
npx skills add https://github.com/tdimino/claude-code-minoan --skill smolvlm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smolvlm
Source: https://github.com/tdimino/claude-code-minoan/tree/main/skills/design-media/smolvlm
Command: npx skills add https://github.com/tdimino/claude-code-minoan --skill smolvlm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mlx-vlm, and includes scripts (resource) components.

What problem does it solve?

This Skill enables local, on-device image analysis without relying on cloud services, ensuring privacy and faster processing for visual tasks.

Core Features & Use Cases

  • Local Image Analysis: Utilizes SmolVLM-2B for image understanding directly on your machine.
  • Versatile Prompts: Supports general descriptions, specific text extraction (OCR), UI analysis, and visual question answering.
  • Use Case: Quickly get a description of a screenshot, extract text from a receipt image, or ask questions about the content of a photograph without uploading it.

Quick Start

Use the smolvlm skill to describe the image located at /path/to/image.png.

Frequently Asked Questions about smolvlm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract text from an image locally on macOS?

Local image analysis extracts text from images directly on your device using the SmolVLM-2B model. It operates offline without uploading files to cloud services, ensuring privacy and faster processing for visual tasks.

Can I perform visual question answering without an internet connection?

Visual question answering can be performed entirely offline using local models. This Skill processes image interpretation and answers specific queries about visual content on-device without relying on an internet connection.

Does local image analysis with SmolVLM work on Windows or Linux?

Local image analysis with SmolVLM is exclusive to macOS with Apple Silicon. It requires the mlx-vlm Python package to run the 2B model, meaning Windows and Linux environments are currently unsupported.

How do I analyze a screenshot and get a detailed description on my machine?

To analyze a screenshot locally, provide the image file path to the Skill. It uses the SmolVLM-2B model to generate detailed image descriptions and UI analysis directly on your machine without cloud processing.

What is the best way to run a local vision model for OCR and image understanding?

The best way to run a local vision model for OCR and image understanding is using the mlx-vlm framework. It enables the SmolVLM-2B model to perform versatile prompts including text extraction and UI analysis on macOS Apple Silicon.

Do I need Python to use SmolVLM for on-device image interpretation?

You need Python to use SmolVLM for on-device image interpretation because the Skill depends on the mlx-vlm Python package. This package provides the necessary environment to run the SmolVLM-2B model locally.