Instructions to use qvac/VisionPsy-Nano-460M-Flash-GGUFs with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use qvac/VisionPsy-Nano-460M-Flash-GGUFs with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="qvac/VisionPsy-Nano-460M-Flash-GGUFs", filename="mmproj-visionpsy-nano-460m-flash-q8.gguf", )
llm.create_chat_completion( messages = [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] ) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use qvac/VisionPsy-Nano-460M-Flash-GGUFs with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M # Run inference directly in the terminal: llama cli -hf qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M # Run inference directly in the terminal: llama cli -hf qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M
Use Docker
docker model run hf.co/qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use qvac/VisionPsy-Nano-460M-Flash-GGUFs with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "qvac/VisionPsy-Nano-460M-Flash-GGUFs" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "qvac/VisionPsy-Nano-460M-Flash-GGUFs", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M
- Ollama
How to use qvac/VisionPsy-Nano-460M-Flash-GGUFs with Ollama:
ollama run hf.co/qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M
- Unsloth Studio
How to use qvac/VisionPsy-Nano-460M-Flash-GGUFs with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for qvac/VisionPsy-Nano-460M-Flash-GGUFs to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for qvac/VisionPsy-Nano-460M-Flash-GGUFs to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for qvac/VisionPsy-Nano-460M-Flash-GGUFs to start chatting
- Atomic Chat new
- Docker Model Runner
How to use qvac/VisionPsy-Nano-460M-Flash-GGUFs with Docker Model Runner:
docker model run hf.co/qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M
- Lemonade
How to use qvac/VisionPsy-Nano-460M-Flash-GGUFs with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull qvac/VisionPsy-Nano-460M-Flash-GGUFs:Q4_K_M
Run and chat with the model
lemonade run user.VisionPsy-Nano-460M-Flash-GGUFs-Q4_K_M
List all available models
lemonade list
VisionPsy-Nano-460M-Flash-GGUFs
VisionPsy-Nano-460M-Flash-GGUFs provides GGUF weights of VisionPsy-Nano-460M-Flash for fast, fully on-device multimodal inference with our patched llama.cpp fork (not stock upstream). Flash is the efficiency-optimized sibling of VisionPsy-Nano-460M: same ~460M nanoVLM architecture, but it processes each image with far fewer visual tokens (as few as 64 at 512x512), so it responds an order of magnitude faster on real phones while giving up only a small amount of accuracy.
Unquantized FP32 and BF16 GGUFs are included alongside a family of quantization formats, from near-lossless 8-bit through a high-quality 5-bit option down to ultra-compact 3-bit. All sub-8-bit variants (except the legacy Q4_0) use importance-matrix (imatrix) calibration. If VisionPsy-Nano-460M-GGUF is our best-quality ~0.5B GGUF, Flash-GGUF is the one you ship when time-to-first-token, battery, and RAM are the binding constraints.
Each GGUF is a vision-language model: alongside the text weights (
*.gguf) you also need the multimodal projector (mmproj-*.gguf, the SigLIP2 vision encoder) to run image inputs. See Usage.
| Developed by | Tether AI Research* |
| Model type | Vision-language model (image-text-to-text), GGUF quantized |
| Base model | VisionPsy-Nano-460M-Flash |
| Architecture | nanoVLM — SigLIP2 vision encoder + SmolLM2-360M backbone, aggressive visual-token compression (64 tokens @ 512x512) |
| Language | English |
| License | Apache 2.0 |
| Quantization tool | llama.cpp |
| Calibration | importance-matrix (imatrix) for all -imat variants |
| All variants | VisionPsy-Nano-460M · VisionPsy-Nano-460M-Flash · VisionPsy-Nano-460M-GGUFs · VisionPsy-Nano-460M-Flash-GGUFs |
* References to Tether AI Research are references to Tether Data, S.A. de C.V.
The headline: finishes faster on real phones
Flash is an order of magnitude faster on real phones. By leveraging less visual tokens, Flash reaches the first token 10-25x faster than nanoVLM-460M and SmolVLM2-500M and consistently faster than LFM2.5-VL-450M and Qwen3.5-0.8B on Pixel 9, Galaxy S23, Galaxy S25, and iPhone 15, while keeping ~98% of the full model's quality (61.1 vs 62.3 normalized).
Available Files
All published files are produced with llama.cpp. The FP32 and BF16 GGUF files are unquantized (no quantization applied) and serve as the in-harness reference. Q8_0 does not use imatrix calibration (imatrix provides no measurable benefit at 8-bit), and Q4_0 is the legacy 4-bit format without imatrix, kept mainly for cross-model on-device latency benchmarking. All other sub-8-bit variants use imatrix calibration.
Δ AVG below is measured against the FP32 GGUF baseline using our Normalized (0-100) score — the mean of 17 public VLM benchmarks (see Quality). Δ AVG (pts) is the absolute change; Δ AVG (rel %) normalizes by the baseline.
| File | Format | Imatrix | Size (MB) | Δ AVG (pts) | Δ AVG (rel %) | Recommended For |
|---|---|---|---|---|---|---|
visionpsy-nano-460m-flash-fp32.gguf |
FP32 | n/a | 1562 | ≈0.00 | ≈0.00% | Unquantized GGUF reference |
visionpsy-nano-460m-flash-bf16.gguf |
BF16 | n/a | 782 | -0.02 | -0.03% | Unquantized GGUF |
visionpsy-nano-460m-flash-q8_0.gguf |
Q8_0 | no (not needed) | 416 | −0.06 | −0.10% | Best quality, near-lossless |
visionpsy-nano-460m-flash-q5_k_m-imat.gguf |
Q5_K_M | yes | 310 | −0.07 | −0.12% | Recommended high-quality 5-bit |
visionpsy-nano-460m-flash-q5_k_m.gguf |
Q5_K_M | no | 310 | −0.52 | −0.90% | 5-bit without imatrix (prefer the -imat build) |
visionpsy-nano-460m-flash-q4_k_m-imat.gguf |
Q4_K_M | yes | 289 | −0.53 | −0.92% | Recommended for mobile/laptop (best size/quality) |
visionpsy-nano-460m-flash-iq4_xs-imat.gguf |
IQ4_XS | yes | 242 | −0.91 | −1.58% | Smaller 4-bit alternative |
visionpsy-nano-460m-flash-iq4_nl-imat.gguf |
IQ4_NL | yes | 244 | −0.97 | −1.68% | Alternative 4-bit |
visionpsy-nano-460m-flash-q4_0.gguf |
Q4_0 | no | 244 | −2.52 | −4.38% | ⚠Legacy 4-bit (no imatrix) — used for latency benchmarks; prefer Q4_K_M |
visionpsy-nano-460m-flash-iq3_m-imat.gguf |
IQ3_M | yes | 240 | −1.57 | −2.73% | Strong compact 3-bit for tight memory |
visionpsy-nano-460m-flash-iq3_xxs-imat.gguf |
IQ3_XXS | yes | 230 | −1.71 | −2.97% | Ultra-compact 3-bit (accept some quality loss) |
mmproj-visionpsy-nano-460m-flash-q8.gguf |
Q8_0 (vision) | n/a | 104 | n/a | n/a | Required multimodal projector for all files above |
Quick Recommendation
| Your constraint | Choose |
|---|---|
| You want a llama.cpp-native unquantized FP32 file | FP32 — no quantization applied on LLM |
| You want a llama.cpp-native unquantized BF16 file | BF16 — no quantization applied on LLM |
| You want the best quality at half the size | Q8_0 — near-lossless (−0.06 pts / −0.10%) |
| You want the best size/quality trade-off (most users) | Q5_K_M (imatrix) — only −0.07 pts (−0.12%), essentially lossless at 5-bit |
| You need the smallest recommended file | IQ3_M (imatrix) — −1.57 pts (−2.73%) |
| You are cross-benchmarking on-device latency | Q4_0 — the legacy format used in our device tests (lower quality; prefer Q4_K_M for deployment) |
Benchmarks
Flash keeps most of the full model's quality. All scores are computed in-house with a single VLMEvalKit harness so every configuration is scored identically, using each benchmark's official metric (POPE = F1, MMVet = partial credit, MM-IFEval = instruction-following accuracy, MME = Perception + Reasoning points, OCRBench = /1000; accuracy otherwise). LLM-as-judge scoring uses Qwen3-27B-FP8. Each column is a different GGUF quantization / calibration configuration.
Legend: -i = importance-matrix (imatrix) calibration. MME = P+R points, OCRBench = /1000, all others accuracy/F1. Normalized = mean across the 17 benchmarks scaled to 0-100 (MME /28, OCRBench /1000). Weights = on-disk LM GGUF only (excludes shared mmproj Q8_0, ~104 MB).
| Benchmark | FP32 | BF16 | Q8_0 | Q5_K_M | Q5_K_M-i | Q4_0 | IQ4_XS-i | IQ4_NL-i | Q4_K_M-i | IQ3_XXS-i | IQ3_M-i |
|---|---|---|---|---|---|---|---|---|---|---|---|
| MMStar | 43.7 | 43.5 | 43.1 | 44.1 | 42.8 | 40.7 | 43.7 | 43.9 | 43.1 | 41.7 | 41.9 |
| MMBench | 57.3 | 57.2 | 57.0 | 56.4 | 55.5 | 54.2 | 57.2 | 56.8 | 56.9 | 57.4 | 57.0 |
| RealWorldQA | 56.7 | 56.9 | 56.7 | 56.5 | 56.5 | 55.3 | 55.4 | 55.8 | 54.9 | 55.8 | 56.3 |
| MME | 1610.3 | 1611.5 | 1595.1 | 1590.4 | 1549.7 | 1561.9 | 1582.9 | 1602.1 | 1583.8 | 1574.9 | 1560.0 |
| SEEDBench | 65.6 | 65.5 | 65.4 | 65.1 | 65.6 | 63.5 | 65.9 | 65.9 | 65.4 | 65.2 | 65.1 |
| POPE | 85.9 | 85.8 | 85.8 | 85.2 | 86.2 | 84.7 | 85.8 | 85.8 | 85.7 | 84.9 | 85.1 |
| MMMU | 30.7 | 30.7 | 30.4 | 30.7 | 32.2 | 31.2 | 30.2 | 29.4 | 29.8 | 29.3 | 30.4 |
| MathVista * | 43.1 | 42.4 | 43.1 | 41.6 | 45.2 | 40.7 | 41.9 | 41.7 | 41.8 | 41.0 | 40.9 |
| AI2D | 66.1 | 66.1 | 66.0 | 66.0 | 65.3 | 63.4 | 64.8 | 64.9 | 66.1 | 63.5 | 64.0 |
| ScienceQA | 79.7 | 79.8 | 79.8 | 79.0 | 79.7 | 77.0 | 77.2 | 77.2 | 79.4 | 76.3 | 77.9 |
| OCRBench * | 541 | 539 | 549 | 538 | 547 | 508 | 530 | 529 | 537 | 518 | 521 |
| ChartQA * | 68.6 | 68.8 | 68.7 | 68.0 | 67.6 | 65.6 | 66.3 | 66.5 | 67.6 | 66.8 | 66.6 |
| TextVQA * | 71.2 | 71.0 | 70.9 | 70.4 | 70.9 | 68.2 | 69.5 | 69.4 | 69.7 | 68.4 | 68.3 |
| DocVQA * | 83.1 | 83.0 | 82.9 | 82.9 | 82.6 | 80.2 | 82.3 | 82.4 | 82.3 | 80.7 | 81.5 |
| InfoVQA * | 43.8 | 44.1 | 43.3 | 43.6 | 44.0 | 41.1 | 43.1 | 42.8 | 43.6 | 41.8 | 42.5 |
| MM-IFEval | 43.4 | 43.3 | 42.8 | 42.2 | 42.9 | 34.4 | 41.4 | 41.7 | 42.2 | 37.4 | 40.1 |
| MMVet * | 28.5 | 29.0 | 30.1 | 28.0 | 30.7 | 29.2 | 29.0 | 27.8 | 31.0 | 31.5 | 26.7 |
| Normalized (0-100) | 57.58 | 57.56 | 57.52 | 57.06 | 57.51 | 55.06 | 56.67 | 56.61 | 57.05 | 55.87 | 56.01 |
* ChartQA, TextVQA, DocVQA, InfoVQA, OCRBench, MathVista and MMVet use an LLM-as-judge Qwen3-27B-FP8, which evaluates free-form answers more reliably than strict string matching (e.g. "12%" vs "12 percent", paraphrases, units, formatting).
The trade-off vs the full VisionPsy-Nano-460M is concentrated in OCR/document-heavy and fine-grained perception tasks (OCRBench, ChartQA), where fewer visual tokens cost the most detail. For the full-quality model see the VisionPsy-Nano-460M-GGUF card.
Key Findings
- Q8_0 is effectively lossless: −0.06 pts (−0.10% relative) on Normalized score, at roughly half the size of BF16, no imatrix needed.
- Q4_K_M with imatrix is exceptional at 4-bit: only −0.53 pts (−0.92%), actually matching the 5-bit builds on Normalized score, making it the clear best size–quality trade-off for mobile and laptop deployment.
- imatrix beats legacy Q4_0 decisively: the imatrix 3-bit IQ3_M (−1.57 pts) and IQ3_XXS (−1.71 pts) both outperform the legacy 4-bit Q4_0 (−2.52 pts). Prefer an imatrix build unless you are specifically latency-benchmarking Q4_0.
- Compact quantization stays usable: even IQ3_M holds a Normalized score of 56.01, close to the FP32 Flash baseline (57.58), keeping Flash's speed advantage intact at a fraction of the footprint.
Usage
These are multimodal GGUF files: you need both the text model (*.gguf) and the vision projector (mmproj-*.gguf).
llama.cpp
# Download the recommended text weights (Q4_K_M with imatrix) + the vision projector
huggingface-cli download qvac/VisionPsy-Nano-460M-Flash-GGUFs \
visionpsy-nano-460m-flash-q4_k_m-imat.gguf \
mmproj-visionpsy-nano-460m-flash-q8.gguf \
--local-dir .
First build the patched llama.cpp — see the build instructions in
llama-cpp-inference, then run multimodal inference:
./llama-mtmd-cli \
-m visionpsy-nano-460m-flash-q4_k_m-imat.gguf \
--mmproj mmproj-visionpsy-nano-460m-flash-q8.gguf \
--image your_image.jpg \
-p "What is in this image?" \
-n 128
# Or start an OpenAI-compatible server with a web UI
./llama-server \
-m visionpsy-nano-460m-flash-q4_k_m-imat.gguf \
--mmproj mmproj-visionpsy-nano-460m-flash-q8.gguf
Intended use
VisionPsy-Nano-460M-Flash-GGUFs is designed for latency- and memory-constrained, on-device multimodal applications where responsiveness matters most: live camera Q&A, quick scene/document understanding, and lightweight visual instruction following on phones and other edge hardware. If you can afford more compute and want maximum quality, use VisionPsy-Nano-460M-GGUFs instead. Because of its small size, we recommend fine-tuning on your specific domain to maximize quality.
Limitations
- Flash trades a little accuracy for speed: it scores a few points below the full VisionPsy-Nano-460M, with the largest gaps on OCR/document-heavy and fine-grained perception tasks.
- Single-image by design: the model is trained and optimized for one image per query; multi-image prompts are outside its intended use.
- As a compact model, it may occasionally hallucinate or miscount and is best suited to focused tasks rather than very dense documents or long multi-step math, where larger models have an edge.
- Quantization artifacts: lower bit counts can subtly degrade outputs in ways aggregate
benchmarks do not fully capture. We recommend Q4_K_M or higher for production and prefer the
imatrix builds over the legacy
Q4_0. - Primarily English; other languages are not officially supported yet.
- Not intended for safety-critical or high-stakes automated decisions.
- Efficiency numbers are measured with 4-bit GGUF builds on specific phones; absolute latency, memory, and throughput will vary with hardware, runtime, and quantization. Benchmark scores use a fixed in-house harness with an LLM judge (Qwen3-27B-FP8) and may differ from other reported setups.
Acknowledgements
Built on the excellent open-source work of nanoVLM, SmolLM2, SigLIP2, and llama.cpp.
Citation
@misc{visionpsynano2026,
title = {VisionPsy-Nano-460M: A Compact Vision-Language Model for On-Device Inference},
author = {Tether AI Research},
year = {2026},
note = {Hugging Face model card}
}
Copyright
We will take appropriate actions in response to notices of copyright infringement. If you believe your work has been used or copied in a manner that infringes upon your intellectual property rights, please email data-apps@tether.io identifying and describing both the copyrighted work and alleged infringing content.
Licensing
This model, which was finetuned as described in the blog post, is licensed by Tether Data, S.A. de C.V. under the Apache 2.0 license. As described in the blog post, this model is a version of the NanoVLM-460M-8k pre-trained model (https://huggingface.co/lusxvr/nanoVLM-460M-8k), which is made available under the MIT license.
The FineVision dataset (https://huggingface.co/datasets/HuggingFaceM4/FineVision) is made available under the CC-BY-4.0 (Creative Commons - Attribution 4.0) license. FineVision is an aggregation of a number of public sources unified into a single corpus. Individual subsets within the collection may inherit specific underlying terms from their original creators. As described in the blog post, a subset of the FineVision dataset was used as a part of finetuning the model.
The NVIDIA Nemotron-Image-Training-v3 dataset (https://huggingface.co/datasets/nvidia/Nemotron-Image-Training-v3) is made available under the CC-BY-4.0 (Creative Commons - Attribution 4.0). The mPLUG TinyChartData dataset (https://huggingface.co/datasets/mPLUG/TinyChartData) is made available under the Apache 2.0 license. The TabMWP dataset (https://promptpg.github.io/) is made available under the CC BY-NC-SA 4.0 (Creative-Commons-Attribution-NonCommercial-ShareAlike 4.0). The PopVQA dataset (https://huggingface.co/datasets/idoco/PopVQA) is made available under the MIT license. The InfoSeek dataset (https://github.com/open-vision-language/infoseek) is made available under the Apache 2.0 license. The MMKU-Bench dataset (https://huggingface.co/datasets/baochenfu/MMKU-Bench) is made available under the Apache 2.0 license. The VisionFoundry-10K dataset (https://huggingface.co/datasets/zlab-princeton/VisionFoundry-10K) is made available under the Apache 2.0 license. The PKU-SafeRLHF-V dataset (https://huggingface.co/datasets/PKU-Alignment/PKU-SafeRLHF-V) is made available under the CC-BY-NC 4.0 (Attribution-NonCommercial 4.0 International). As described in the blog post, the NVIDIA Nemotron-Image-Training-v3, mPLUG TinyChartData, TabMWP, PopVQA, InfoSeek, MMKU-Bench, VisionFoundry-10K and PKU-SafeRLHF-V datasets were used as a part of finetuning the model.
- Downloads last month
- -
Model tree for qvac/VisionPsy-Nano-460M-Flash-GGUFs
Base model
lusxvr/nanoVLM-460M-8k