Instructions to use litert-community/LFM2.5-VL-450M with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- LiteRT-LM
How to use litert-community/LFM2.5-VL-450M 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 -U 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/LFM2.5-VL-450M \ --prompt="Write me a poem"
- LiteRT
How to use litert-community/LFM2.5-VL-450M 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
LFM2.5-VL-450M β LiteRT-LM
LiquidAI/LFM2.5-VL-450M converted to the LiteRT-LM (.litertlm) format for on-device inference with Google's LiteRT-LM runtime β the small sibling of litert-community/LFM2.5-VL-3B, at a size that fits almost anywhere (int4 bundle: 0.41 GB).
Text + image work end-to-end on the released litert-lm 0.16.0 pip runtime: the bundle carries the vision encoder, the vision adapter and the LFM2 image-placeholder metadata, so litert-lm run β¦ --attachment photo.png just works.
LFM2.5-VL-450M pairs the hybrid LFM2 text backbone (16 layers: gated short-convolutions + grouped-query attention, 64k vocab) with a compact SigLIP2 vision tower (12 layers, hidden 768). An image is processed at 512Γ512 into 256 soft tokens (single image per prompt; the runtime resizes for you).
| File | Recipe | Size |
|---|---|---|
LFM2.5-VL-450M_int8.litertlm |
int8 dynamic (text linears + convs + embedding, vision tower) | 0.56 GB |
LFM2.5-VL-450M_int4.litertlm |
text int4 blockwise-32 OCTAV linears, int8 embedding + lm_head; vision tower int8 | 0.41 GB |
| Context (KV cache) | 4096 max |
| Image input | 1 per prompt, resized to 512Γ512 β 256 tokens; PNG/JPEG via --attachment |
| Backend | CPU, and GPU with litert-lm β₯ 0.16.0 (macOS/Android OpenCL per the LFM2.5 family; iOS Metal fails at engine creation for this family, tracked upstream in LiteRT-LM#3129 β use CPU on iOS) |
| Template | bundled β ChatML-style; image placeholders are inserted by the runtime's LFM2 data processor (non-thinking model) |
| Base model | LiquidAI/LFM2.5-VL-450M (LFM Open License v1.0) |
Quality
Sanity gates on the 0.16.0 pip CLI (greedy, fresh engine per question, --cache no). Vision: five deterministic synthetic fixtures (dominant color, large-text OCR, shape, counting three squares, largest word). Text: the 8-question gate used across our LiteRT conversions.
| Configuration | text 8Q | image 5Q |
|---|---|---|
| PyTorch bf16 (reference) | β | 5/5 |
| LiteRT int4-b32, CPU (recommended) | 8/8 | 4/5 |
| LiteRT int8, CPU | 6/8 | 3/5 |
int4 is the better variant of this model on our gates β it answers the color, OCR, counting and largest-word fixtures correctly and misses only the shape question. At 450M scale some fine-grained visual answers sit close to decision boundaries on-device: we verified the conversion itself is exact (the exported vision tower matches the PyTorch tower at cosine 1.0000 on identical inputs, and an unquantized bundle reproduces the same misses), so treat this model as a fast, small VLM for coarse visual tasks and OCR of large text, and reach for the 3B when you need finer visual reasoning.
Usage
pip install litert-lm
litert-lm run ./LFM2.5-VL-450M_int4.litertlm --prompt "What does the text in this image say?" --attachment photo.png
Text-only prompts work the same way without --attachment. --vision-backend cpu|gpu selects the vision encoder backend independently of the text backend.
Speed
litert-lm benchmark β¦ --cache no, litert-lm 0.16.0 pip, Apple M4 Max (128 GB), text path (prefill/decode; image encoding is a separate one-shot vision-encoder call at prompt time):
CPU backend:
| Variant | Prefill (256) | Prefill (1024) | Decode | TTFT |
|---|---|---|---|---|
| int8 | 1088 tok/s | 2240 tok/s | 129.2 tok/s | 0.24 s |
| int4 | 1026 tok/s | 1196 tok/s | 127.0 tok/s | 0.26 s |
GPU backend (--backend gpu; both variants verified to generate on GPU before quoting β int4 also passes the image gate on GPU, 4/5):
| Variant | Prefill (256) | Decode | TTFT |
|---|---|---|---|
| int8 | 8443 tok/s | 360.0 tok/s | 0.03 s |
| int4 | 8296 tok/s | 354.2 tok/s | 0.03 s |
On Android the same bundles run GPU-accelerated. Pixel 8a (Tensor G3), litert_lm_main built from the v0.16.0 release tag, 296-token prompt, decode run to EOS (0.9kβ3.8k tokens sustained), --disable_cache:
| Variant | Backend | Prefill (296 tok) | Decode | TTFT |
|---|---|---|---|---|
| int4 | GPU (OpenCL) | 528 tok/s | 33.1 tok/s | 0.59 s |
| int4 | CPU | 92 tok/s | 22.6 tok/s | 3.3 s |
| int8 | GPU (OpenCL) | 578 tok/s | 31.1 tok/s | 0.54 s |
| int8 | CPU | 177 tok/s | 15.8 tok/s | 1.7 s |
The text graph delegates fully on Android OpenCL (543/543 nodes, zero rejected ops). int4 prefills slower than int8 on CPU (blockwise-int4 repacking) but decodes ~40% faster β pick by whether your prompts or your outputs dominate.
Conversion
Converted with the open pipeline in hf-to-litertlm (lfm_work/convert_lfm25_vl.py, litert-torch 0.9.3 --task image_text_to_text): the exact recipe, the int4 post-processing (OCTAV int4-b32 + int8 embedder + zero-scale repair + executor metadata, all vision sections preserved) and the text/image gate harnesses are in the repo's REPRODUCE.md.
- Downloads last month
- -
Model tree for litert-community/LFM2.5-VL-450M
Base model
LiquidAI/LFM2.5-350M-Base