Instructions to use litert-community/SmolVLM2-2.2B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- LiteRT-LM
How to use litert-community/SmolVLM2-2.2B with LiteRT-LM:
# LiteRT-LM runs on various platforms (Android, iOS, Windows, Linux, macOS, IoT, Web/WASM) # and supports many APIs (C++, Python, Kotlin, Swift, JavaScript, Flutter). # For platform-specific integration guides, please refer to the official developer website: # https://ai.google.dev/edge/litert-lm # To try LiteRT-LM, the easiest way is to use our CLI tool. # 1. Install the LiteRT-LM CLI tool: pip install litert-lm # 2. Download and run this model locally: # See: https://ai.google.dev/edge/litert-lm/cli litert-lm run \ --from-huggingface-repo=litert-community/SmolVLM2-2.2B \ model.litertlm \ --prompt="Write me a poem"
- LiteRT
How to use litert-community/SmolVLM2-2.2B with LiteRT:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- Notebooks
- Google Colab
- Kaggle
SmolVLM2-2.2B β LiteRT-LM (on-device Vision-Language Model)
HuggingFaceTB/SmolVLM2-2.2B-Instruct
(image path) converted to the LiteRT-LM (.litertlm) format for on-device image+text
inference with Google's LiteRT-LM runtime.
SmolVLM2-2.2B is the largest / most capable of Hugging Face's SmolVLM2 family: a SigLIP vision encoder + pixel-shuffle connector feeding a SmolLM2-1.7B (Llama-architecture) language decoder. Give it an image and a question, get a grounded answer, fully offline.
| File | SmolVLM2-2.2B.litertlm |
| Vision | SigLIP encoder (384Γ384, patch 14 β 729 patches, no CLS) + pixel-shuffle Γ3 + Linear connector, int8 β 81 image tokens |
| Decoder | SmolLM2-1.7B (Llama, 2048-dim, 24 layers), int4 weights (blockwise-32 + OCTAV); tied embedding INT8 (externalized) |
| Compute | integer |
| Context (KV cache) | 2048 |
| Image input | resized to 384Γ384 ((xβ0.5)/0.5 normalization baked into the vision encoder) |
| Base model | HuggingFaceTB/SmolVLM2-2.2B-Instruct |
Quality
Single-image VQA produces coherent, image-grounded answers (the SigLIP vision tower converts bit-faithfully to the reference, float CPU-parity corr β 1.0). This is the largest SmolVLM2, so it is notably more capable than SmolVLM2-500M.
β οΈ Best for single-image VQA β one image per conversation
Ask about one image per chat (start a new conversation for a different image).
Run on Android β Google AI Edge Gallery
Update (July 2026): Google AI Edge Gallery v1.0.16+ can import litert-lm models directly from Hugging Face inside the app (tap +) β no computer or
adbneeded. The manual steps below are only required on older builds or for sideloading a local file.
Run this model with image input in the official Google AI Edge Gallery app β no custom app needed:
- Push the bundle onto the phone (or download it there directly from this repo):
adb push SmolVLM2-2.2B.litertlm /sdcard/Download/ - Open the Gallery app, tap the + icon (bottom-right) and pick
SmolVLM2-2.2B.litertlm. - In the Import Model dialog, check "Support image" (required for image input), then tap Import.
- Open the Ask Image task, choose the imported model, attach a photo, and ask.
Run on desktop (LiteRT-LM CLI)
The same .litertlm bundle runs on macOS / Linux / Windows with the official
LiteRT-LM CLI β including as a
local OpenAI-compatible API server:
pip install litert-lm
litert-lm import --from-huggingface-repo litert-community/SmolVLM2-2.2B SmolVLM2-2.2B.litertlm smolvlm2-2.2b
litert-lm run smolvlm2-2.2b # interactive chat in the terminal
litert-lm serve # local OpenAI-compatible API server
Run on iPhone / macOS
Use the LiteRT-LM Swift runtime (swift-litert-lm /
the LiteRTDemo sample). Load SmolVLM2-2.2B.litertlm with the vision tower enabled
(modalities Modality.textImage / [.vision]), attach a photo, and ask.
Conversion notes
- LiteRT-LM
fast_vlmbundle: VISION_ENCODER ([1,384,384,3]βSigLIP) + VISION_ADAPTER (pixel-shuffle Γ3 + Linear β[1,81,2048]) + single-token EMBEDDER + PREFILL_DECODE. - The vision encoder uses the static position-embedding path (the model's dynamic bucketize position logic is bypassed β numerically identical for a full 384Γ384 frame) and bakes the (xβ0.5)/0.5 normalization + NCHW transpose into the graph.
- Single-image, no high-res splitting β a fixed 81 soft tokens; SmolLM2 (Llama) decoder exported with externalized (tied) embedder.
License
Apache-2.0 (SmolVLM2 + SmolLM2). See the base model card.
- Downloads last month
- 27
Model tree for litert-community/SmolVLM2-2.2B
Base model
HuggingFaceTB/SmolLM2-1.7B