QW

Qwen2.5-Vl-3B-Instruct

QwenGGUF by unslothUpdated 2025-05-12
Download on Hugging Face
Parameters3.09B
Context125K
Layers36
Architectureqwen2vl
Smallest quant0.8 GB
Quick answer

Qwen2.5-Vl-3B-Instruct needs about 2.7 GB of memory at Q4_K_M (a 1.9 GB file) with an 8K context window, so it fits on a 4 GB GPU. This repository has 26 quants, from 0.8 GB (IQ1_S) to 6.2 GB (BF16). Longer context needs more: at 32K tokens the KV cache alone adds about 1.2 GB.

Qwen2.5-VL-3B-Instruct: 3 B vision‑language model with instruction tuning

Qwen2.5‑VL‑3B‑Instruct is a 3 B parameter multimodal model that understands images, charts, and text within images. It can generate structured outputs and localize objects with bounding boxes or points. The model supports instruction‑driven visual reasoning.

Good at

  • Visual object detection and localization
  • Structured data extraction from images
  • Instruction‑driven visual reasoning

Limits

  • Requires at least 2 GB VRAM for Q4_0 quant
  • No native vision support in older llama.cpp builds
  • License not specified in the GGUF package

Best for

  • Image captioning and annotation tasks
  • Extracting tables and forms from scanned documents
  • Building visual agents that interact with tools

Who it’s for. Developers building multimodal applications that need image understanding and structured output generation. The model is suitable for research and production environments that can run llama.cpp with sufficient VRAM.

Quants & memory

QuantFileEst. memoryvs VRAMResultDownload
IQ1_S0.8 GB 1.6 GB
Fits Get file →
IQ1_M0.9 GB 1.7 GB
Fits Get file →
IQ2_XXS1.0 GB 1.8 GB
Fits Get file →
IQ2_M1.2 GB 2.0 GB
Fits Get file →
Q2_K1.3 GB 2.1 GB
Fits Get file →
Q2_K_L1.3 GB 2.1 GB
Fits Get file →
IQ3_XXS1.3 GB 2.1 GB
Fits Get file →
Q2_K_XL1.3 GB 2.1 GB
Fits Get file →
Q3_K_S1.5 GB 2.3 GB
Fits Get file →
Q3_K_M1.6 GB 2.4 GB
Fits Get file →
Q3_K_XL1.6 GB 2.4 GB
Fits Get file →
IQ4_XS1.7 GB 2.5 GB
Fits Get file →
IQ4_NL1.8 GB 2.6 GB
Fits Get file →
Q4_01.8 GB 2.6 GB
Fits Get file →
Q4_K_S1.8 GB 2.6 GB
Fits Get file →
Q4_K_M1.9 GB 2.7 GB
Fits Get file →
Q4_K_XL2.0 GB 2.8 GB
Fits Get file →
Q4_12.0 GB 2.8 GB
Fits Get file →
Q5_K_S2.2 GB 3.0 GB
Fits Get file →
Q5_K_M2.2 GB 3.0 GB
Fits Get file →
Q5_K_XL2.2 GB 3.0 GB
Fits Get file →
Q6_K2.5 GB 3.3 GB
Fits Get file →
Q6_K_XL2.8 GB 3.6 GB
Fits Get file →
Q8_03.3 GB 4.1 GB
Fits Get file →
Q8_K_XL3.9 GB 4.7 GB
Fits Get file →
BF166.2 GB 7.0 GB
Fits Get file →

For 8 GB VRAM, use Q4_0 (file size 1.83 GB, ~2.6 GB memory at 8k context). If 12 GB VRAM is available, Q4_K_M (1.93 GB, ~2.7 GB memory) offers a balance of quality and size. For 16 GB VRAM, Q5_K_S (2.17 GB, ~3 GB memory) provides higher precision.

What GPU do you need for Qwen2.5-Vl-3B-Instruct?

These figures add the file size, an fp16 KV cache at an 8K context window (worked out from this model’s own header) and about 0.5 GB for the runtime. They are estimates, so leave a little headroom, and expect to use less context or a smaller quant if you are right at the limit.

  • 4 GB VRAM: the best quant that fits is Q6_K_XL (2.8 GB file, about 3.6 GB in use).
  • 6 GB VRAM: the best quant that fits is Q8_K_XL (3.9 GB file, about 4.7 GB in use).
  • 8 GB VRAM: the best quant that fits is BF16 (6.2 GB file, about 7.0 GB in use).

Which Qwen2.5-Vl-3B-Instruct quant should you choose?

Q4_K_M is the usual starting point for Qwen2.5-Vl-3B-Instruct: it balances file size and quality well. Here it is a 1.9 GB file.

The Q8_0 file is 3.3 GB, about 1.7 times the size of Q4_K_M. It keeps the weights closer to the original, which only matters if you have the memory to spare.

If memory is tight, the smallest file is IQ1_S at 0.8 GB, with the quality trade-offs that come with fewer bits. Use it only when memory is very tight. Expect a clear drop in quality, which is usually worse on small models and easier to live with on large ones.

New to quant names? Read GGUF quantization explained.

Specifications

Architecture from the GGUF header

Architectureqwen2vl
Parameters3.09B
Layers36
Trained context128,000 tokens
KV cache (fp16)36 KB per token

Source

Quantized byunsloth
FamilyQwen
Downloads (HF)27,398
Last updated2025-05-12

Frequently asked questions about Qwen2.5-Vl-3B-Instruct

How much VRAM does Qwen2.5-Vl-3B-Instruct need?

About 2.7 GB at Q4_K_M with an 8K context window. That is the 1.9 GB file, plus the KV cache and roughly 0.5 GB of runtime overhead. Smaller quants need less and longer context needs more.

Can I run Qwen2.5-Vl-3B-Instruct on an 8 GB GPU?

Yes, with BF16: the 6.2 GB file needs about 7.0 GB at 8K context. Larger quants in this repository do not fit in 8 GB.

What is the file size of Qwen2.5-Vl-3B-Instruct GGUF?

It depends on the quant: IQ1_S is 0.8 GB, IQ1_M is 0.9 GB, IQ2_XXS is 1.0 GB, IQ2_M is 1.2 GB, Q2_K is 1.3 GB, Q2_K_L is 1.3 GB and 20 more.

What context length does Qwen2.5-Vl-3B-Instruct support?

The GGUF header lists a trained context length of 128,000 tokens (125K). The KV cache grows with the context you use: about 0.3 GB at 8K and 1.2 GB at 32K.

Where can I download Qwen2.5-Vl-3B-Instruct GGUF?

The files are on Hugging Face in the unsloth/Qwen2.5-VL-3B-Instruct-GGUF repository. The download buttons on this page open the file on Hugging Face. ggufmodels.com does not host any model files.

Can I run Qwen2.5-VL-3B-Instruct on 8 GB VRAM?

Yes, using the Q4_0 quantization which requires about 2.6 GB of VRAM at 8k context.

Does this model support video input?

The base model is image‑to‑text; video support is not included in the GGUF files.

What license applies to the GGUF files?

The license is not specified in the GGUF package; refer to the original model card for details.

Other GGUFs of Qwen2.5-VL-3B-Instruct

Similar models

Browse all →

More from unsloth

All by unsloth →

More Qwen models

All Qwen →

Other tiny models

All tiny models →