AlibabaQwen 3Qwen3VLForConditionalGeneration

Qwen3 VL 2B Instruct — Hardware Requirements & GPU Compatibility

VisionFunctions

Qwen3 VL 2B Instruct is Alibaba's smallest model in the Qwen3-VL lineup, a 2.1-billion-parameter vision-language model built to handle images and text together. It performs image captioning, visual question answering, and document reading, and its visual-agent tuning lets it interpret GUI screenshots for simple automation. Its small size suits on-device and edge deployment, running comfortably on modest consumer GPUs or even some laptops once quantized. The model supports a 262,144 token context window, enough for lengthy documents or multi-turn conversations. It is released under the Apache 2.0 license, allowing unrestricted commercial and research use. Published in October 2025 alongside the 8B and 32B models, it targets edge and mobile use cases, trading some visual reasoning depth for a much smaller footprint.

2.1B params · dense262K contextApache 2.0Oct 20251.2M downloads514 likes357.3K quant downloads

Your hardware

Verdicts below are for the reference RTX 4090. Set yours to personalise the page.

Detection reads your browser's GPU name with no data sent anywhere.

Runs great on a 24 GB GPU

Runs from 8 GB (Q4_K_M · 32K)Best on 24 GB (Q4_K_M · ~362 tok/s · 128K)Macs from 8 GB (Q4_K_M · ~40 tok/s)

Apache 2.0

Reference GPU · RTX 4090 24 GB

Estimates, ±20% · how we estimate

Run Qwen3 VL 2B Instruct

One recommended way. Every other method, OS and quant is in the step-by-step guide.Each way opens a step-by-step guide for your OS and quant.

Ways to runOther ways

each opens step-by-step

Run in cloud

Your own private copy · Q4_K_M · 24 GB GPU

The easiest way to try this model
Running in a few minutes, easy setup
Chat right here or connect any app

$5+ bonus for new users

Run Qwen3 VL 2B Instruct

3.5 GB VRAM at 16K context · fits the RTX 4090 (20.5 GB free)

Works on macOS, Windows and Linux.

Install Ollama (Linux)
$curl -fsSL https://ollama.com/install.sh | sh
Install Ollama (macOS / Windows)
Download and run the app; it installs the ollama command.
Download Ollama ↗
Run Q4_K_M
$ollama run qwen3-vl:2b-instruct
Official Ollama library build. For the exact Q4_K_M file from Qwen/Qwen3-VL-2B-Instruct-GGUF: ollama run hf.co/Qwen/Qwen3-VL-2B-Instruct-GGUF:Q4_K_M
Raise the context window
Type it inside the chat. For the API server instead, start it with OLLAMA_CONTEXT_LENGTH=16384 ollama serve.
$/set parameter num_ctx 16384
A larger context needs more memory than the weights alone.
Use the API
Ollama serves its API on http://localhost:11434.

Works on macOS, Windows and Linux.

Install LM Studio
Desktop app for macOS (Apple silicon), Windows and Linux.
lmstudio.ai ↗
Download the model
In the app press Ctrl/Cmd + Shift + M and search qwen/qwen3-vl-2b, then pick Q4_K_M. Or use the CLI (run LM Studio once first):
$lms get qwen/qwen3-vl-2b@q4_k_m
Open on Hugging Face ↗
Load and chat
Open the model loader, select the model and set Context Length to 16384. Leave GPU offload at maximum if it fits.
Start the local server (optional)
$lms server start

Works on macOS, Windows and Linux.

Install llama.cpp (macOS)
MacPorts, Nix and conda-forge also work.
$brew install llama.cpp
Install options ↗
Install llama.cpp (Windows)
$winget install llama.cpp
Install llama.cpp (Linux)
Download the prebuilt llama-*-bin-ubuntu-* archive for your GPU backend (CPU, Vulkan) from the releases page, unpack it and run the binaries from that folder. Homebrew (brew install llama.cpp) and conda-forge also work on Linux.
llama.cpp releases ↗
Start the server
Downloads the model on first run. The chat UI and an OpenAI-compatible API are at http://localhost:8080.
$llama-server -hf Qwen/Qwen3-VL-2B-Instruct-GGUF:Q4_K_M -c 16384 -ngl 99 --port 8080

Works on macOS, Windows and Linux.

Option A: Docker Model Runner
Docker Desktop: Settings > AI > Enable Docker Model Runner. Docker Engine on Linux: install the docker-model-plugin package.
$docker model run hf.co/Qwen/Qwen3-VL-2B-Instruct-GGUF:Q4_K_M
Model Runner docs ↗
The quant tag after the repo is how Hugging Face cards write it; if your Docker version rejects it, drop the tag and pick the quant by repo.
Option B: llama.cpp server image (NVIDIA)
Needs the NVIDIA Container Toolkit. Models are cached in the llama-cache volume. Open http://localhost:8080.
$docker run --gpus all -p 8080:8080 -v llama-cache:/root/.cache ghcr.io/ggml-org/llama.cpp:server-cuda -hf Qwen/Qwen3-VL-2B-Instruct-GGUF:Q4_K_M -c 16384 -ngl 99 --host 0.0.0.0 --port 8080
Image tags (cuda13, vulkan, rocm) ↗
Cache path inside the image is not in the docs; remove the -v flag if the volume complains.

Linux only.

Install vLLM
Linux only; on Windows run it inside WSL2. NVIDIA GPU shown; AMD ROCm, Intel and CPU builds have their own install pages.
$uv venv --python 3.12 --seed
$source .venv/bin/activate
$uv pip install vllm --torch-backend=auto
vLLM installation ↗
Serve the model
OpenAI-compatible API at http://localhost:8000/v1.
$vllm serve Qwen/Qwen3-VL-2B-Instruct --max-model-len 16384
Runs the original weights, not the Q4_K_M GGUF; needs ~5 GB of GPU memory.

macOS only.

MLX supports only macOS, so follow these steps for that setup.

Install mlx-lm
$pip install mlx-lm
Chat in the terminal
$mlx_lm.chat --model lmstudio-community/Qwen3-VL-2B-Instruct-MLX-8bit
Downloads the model on first run. The MLX repo has its own quantisation; it may not match the quant selected above.
Or start a local server
Listens on http://localhost:8080.
$mlx_lm.server --model lmstudio-community/Qwen3-VL-2B-Instruct-MLX-8bit

Works on macOS, Windows and Linux.

Install Jan
jan.ai ↗
Find the model
Open the Hub tab, paste this model ID in Search, and choose Q4_K_M if offered.
$Qwen/Qwen3-VL-2B-Instruct-GGUF
Use the local API (optional)
Settings > Local API Server > Start Server. It listens on http://127.0.0.1:1337.

Rent GPUs hourly to run Q4_K_M right there. Pricing comes from partner marketplaces and varies.

Available GPU rentals for Q4_K_M, prioritized by value
GPU	Speed	$/1M tokens	Rent
RTX 3060 12GBCheapestCheapest8 GB free	~129 tok/s	$0.13	Deploy on Vast.aifrom $0.060/hr (opens in new tab)	8 GB free · ~129 tok/s · $0.13 / 1M tokens
RTX 3060 Ti (8 GB)4 GB free	~161 tok/s	$0.12	Deploy on Vast.aifrom $0.069/hr (opens in new tab)	8 GB · 4 GB free · ~161 tok/s · $0.12 / 1M tokens
RTX 4060 (8 GB)4 GB free	~98 tok/s	$0.24	Deploy on Vast.aifrom $0.086/hr (opens in new tab)	8 GB · 4 GB free · ~98 tok/s · $0.24 / 1M tokens
RTX A4000 (16 GB)12 GB free	~161 tok/s	$0.15	Deploy on Vast.aifrom $0.088/hr (opens in new tab)	16 GB · 12 GB free · ~161 tok/s · $0.15 / 1M tokens
RTX PRO 4500 (32 GB)28 GB free	~322 tok/s	$0.29	Deploy on RunPodfrom $0.34/hr (opens in new tab)	32 GB · 28 GB free · ~322 tok/s · $0.29 / 1M tokens
RTX 4090 (24 GB)20 GB free	~362 tok/s	$0.26	Deploy on RunPodfrom $0.34/hr (opens in new tab)	24 GB · 20 GB free · ~362 tok/s · $0.26 / 1M tokens
A40 (48 GB)44 GB free	~250 tok/s	$0.39	Deploy on RunPodfrom $0.35/hr (opens in new tab)	48 GB · 44 GB free · ~250 tok/s · $0.39 / 1M tokens
L4 (24 GB)20 GB free	~108 tok/s	$1.13	Deploy on RunPodfrom $0.44/hr (opens in new tab)	24 GB · 20 GB free · ~108 tok/s · $1.13 / 1M tokens

Compare GPUs →

Your own private copy of Qwen3 VL 2B Instruct · Q4_K_M · OpenAI-compatible API

Open the llama.cpp listing on RunPod
Open on RunPodServerless (opens in new tab)
New to RunPod? Sign up and add credit first.
2
Fill in the form
Press Deploy and fill in:
Model
Qwen/Qwen3-VL-2B-Instruct-GGUF
Quantization
Q4_K_M
Context Size
16384
After pasting the model press Esc — don’t pick a suggestion. Press Next.
Create the endpoint
Keep the default 24 GB and 48 GB, then Create Endpoint. Right away: Manage → Edit endpoint → Max workers 1 → Save (changing settings later restarts the worker).
The first start downloads the model, usually 5–15 min. After that, replies after a pause come in seconds.
Create an API key
RunPod → Settings → API Keys → Create. Pick “Restricted” with access to this endpoint only.

Use it

Copy the endpoint URL from its page on RunPod (any of its links works) and paste it with the key. Both stay in this browser.

Endpoint URL

API key

Chats and keys stay only in this browser.

https://api.runpod.ai/v2/<ENDPOINT_ID>/openai/v1

Put your endpoint ID in place of <ENDPOINT_ID>. The API key is the one from step 2.

from openai import OpenAI
client = OpenAI(base_url="https://api.runpod.ai/v2/<ENDPOINT_ID>/openai/v1", api_key="rpa_...")
r = client.chat.completions.create(
    model="any",
    messages=[{"role": "user", "content": "Hello!"}])
print(r.choices[0].message.content)

Works with any OpenAI client.

https://api.runpod.ai/v2/<ENDPOINT_ID>/openai/v1

Put your endpoint ID in place of <ENDPOINT_ID>. The API key is the one from step 2.

Free on Windows, macOS, Linux, iOS, Android and the web.

Open the web app ↗ (opens in a new tab)Download ↗ (opens in a new tab)

1. Settings → Model Provider → Add → Add Custom Provider
2. API Mode OpenAI API Compatible; paste the API key and the base URL as API Host
3. Model → Fetch, pick the model
4. New chat → pick the provider → start chatting

Free and open source for Windows, macOS and Linux.

Download Jan ↗ (opens in a new tab)

1.Settings → next to Model Providers press +
2.API format OpenAI-compatible; Base URL is the base URL above (with /v1); API key is your key; Create
3.If no model appears, click + in Models and type any
4.New chat → pick the model → start chatting

How Much VRAM Does Qwen3 VL 2B Instruct Need?

Select a quantization level; the listed hardware adheres to it.

VRAM	+32K	+128K	File	Quality	On RTX 4090 (reference)
1.1 GB	4.6 GB	15.9 GB	0.6 GB	2-bit · i-quant extreme compression — Importance-weighted 2-bit, extreme compression — significant quality loss	Fits: 128K context · ~585 tok/s
1.2 GB	4.7 GB	16 GB	0.6 GB	2-bit · i-quant extra small — Importance-weighted 2-bit, extra small	Fits: 128K context · ~560 tok/s
1.2 GB	4.7 GB	16 GB	0.7 GB	2-bit · i-quant small — Importance-weighted 2-bit, small	Fits: 128K context · ~546 tok/s
1.3 GB	4.8 GB	16.1 GB	0.7 GB	2-bit · i-quant medium — Importance-weighted 2-bit, medium	Fits: 128K context · ~524 tok/s
1.4 GB	4.9 GB	16.2 GB	0.8 GB	3-bit · i-quant — Importance-weighted 3-bit	Fits: 128K context · ~482 tok/s
1.4 GB	4.9 GB	16.2 GB	0.7 GB	2-bit · small K-quant — 2-bit small K-quant	Fits: 128K context · ~471 tok/s
1.4 GB	4.9 GB	16.2 GB	0.8 GB	3-bit · i-quant extra small — Importance-weighted 3-bit, extra small	Fits: 128K context · ~465 tok/s
1.4 GB	5 GB	16.2 GB	0.8 GB	2-bit · K-quant — 2-bit quantization with K-quant improvements	Fits: 128K context · ~455 tok/s
1.4 GB	5 GB	16.2 GB	0.9 GB	3-bit · i-quant small — Importance-weighted 3-bit, small	Fits: 128K context · ~455 tok/s
1.5 GB	5 GB	16.3 GB	0.9 GB	3-bit small — 3-bit small quantization	Fits: 128K context · ~446 tok/s
1.5 GB	5 GB	16.3 GB	0.9 GB	3-bit · i-quant medium — Importance-weighted 3-bit, medium	Fits: 128K context · ~440 tok/s
1.6 GB	5.1 GB	16.4 GB	0.9 GB	3-bit medium — 3-bit medium quantization	Fits: 128K context · ~417 tok/s
1.6 GB	5.1 GB	16.4 GB	1.1 GB	4-bit · legacy — 4-bit legacy quantization	Fits: 128K context · ~410 tok/s
1.6 GB	5.2 GB	16.4 GB	1 GB	3-bit large — 3-bit large quantization	Fits: 128K context · ~402 tok/s
1.7 GB	5.2 GB	16.5 GB	1 GB	4-bit · i-quant compact — Importance-weighted 4-bit, compact	Fits: 128K context · ~390 tok/s
1.7 GB	5.3 GB	16.5 GB	1.1 GB	4-bit small — 4-bit small quantization	Fits: 128K context · ~379 tok/s
1.7 GB	5.3 GB	16.5 GB	1.1 GB	4-bit · legacy+ — 4-bit legacy quantization with offset	Fits: 128K context · ~379 tok/s
1.7 GB	5.3 GB	16.5 GB	1.1 GB	4-bit · i-quant non-linear — Importance-weighted 4-bit, non-linear	Fits: 128K context · ~379 tok/s
1.8 GB	5.3 GB	16.6 GB	1.1 GB	4-bit medium — 4-bit medium quantization — most popular sweet spot	Fits: 128K context · ~362 tok/s
1.8 GB	5.4 GB	16.6 GB	1.2 GB	4-bit large — 4-bit large quantization	Fits: 128K context · ~356 tok/s
1.9 GB	5.4 GB	16.7 GB	1.2 GB	5-bit · legacy — 5-bit legacy quantization	Fits: 128K context · ~352 tok/s
2 GB	5.5 GB	16.8 GB	1.2 GB	5-bit small — 5-bit small quantization	Fits: 128K context · ~328 tok/s
2 GB	5.5 GB	16.8 GB	1.3 GB	5-bit · legacy+ — 5-bit legacy quantization with offset	Fits: 128K context · ~328 tok/s
2.0 GB	5.6 GB	16.9 GB	1.3 GB	5-bit medium — 5-bit medium quantization — good quality/size tradeoff	Fits: 128K context · ~320 tok/s
2.1 GB	5.6 GB	16.9 GB	1.3 GB	5-bit large — 5-bit large quantization	Fits: 128K context · ~315 tok/s
2.3 GB	5.8 GB	17.1 GB	1.4 GB	6-bit, very good — 6-bit quantization, very good quality	Fits: 128K context · ~286 tok/s
2.7 GB	6.2 GB	17.5 GB	1.8 GB	8-bit, near-lossless — 8-bit quantization, near-lossless	Fits: 128K context · ~246 tok/s
4.8 GB	8.3 GB	19.6 GB	3.4 GB	16-bit · bfloat — Brain floating point 16 — preferred for training	Fits: 128K context · ~137 tok/s

Selected Q4_K_M

4-bit medium quantization

3.5GBat 16K context

Weights: 1.3 GB
KV cache: 1.9 GB
Overhead: 0.3 GB

Fits RTX 4090 (reference) · 20.6 GB free · ~362 tok/s

≥50 tok/s needs ≥139 GB/s · RTX 5090 ~644, RTX 3090 Ti ~362

Which Hardware Can Run Qwen3 VL 2B Instruct?

Q4_K_M · 1.8 GB

Qwen3 VL 2B Instruct (Q4_K_M) requires 1.8 GB of VRAM to load the model weights. For comfortable inference with headroom for KV cache and system overhead, 3+ GB is recommended. Using the full 262K context window can add up to 29.8 GB, bringing total usage to 31.6 GB. 52 GPUs can run it, including NVIDIA GeForce RTX 5090, NVIDIA GeForce RTX 3090 Ti. 163 devices with unified memory can run Qwen3 VL 2B Instruct, including Mac Studio (M3 Ultra, 256GB), Mac Studio (M3 Ultra, 512GB).

By VRAM tier · typical GPUs and Macs at Q4_K_M

Typical hardwareQuantVRAMtok/sContext that fits

8 GB · RTX 4060Q4_K_M · 3.5 GB · ~98 tok/s · 32K3.5~9832K8 GB tier →

12 GB · RTX 3060 12GBQ4_K_M · 3.5 GB · ~129 tok/s · 64K3.5~12964K12 GB tier →

16 GB · RTX 5060 Ti 16GBQ4_K_M · 3.5 GB · ~161 tok/s · 64K3.5~16164K16 GB tier →

24 GB · RTX 4090referenceQ4_K_M · 3.5 GB · ~362 tok/s · 128K3.5~362128K24 GB tier →

Mac 32 GB · Mac Mini M4Q4_K_M · 3.5 GB · ~46 tok/s · 128K3.5~46128KMacs →

Mac 64 GB · Mac Studio M4 MaxQ4_K_M · 3.5 GB · ~211 tok/s · 256K3.5~211256KMacs →

Alternatives to Qwen3 VL 2B Instruct

Qwen 3 family · 79 models →

Similar models

6tok/s on RTX 4090

Model	Score	VRAM	tok/s	Why it is similar
LFM3 Omni 2BLiquid AI	—	2.4 GB	~385	same size
SmolVLM2 2.2B InstructHugging Face	—	2.3 GB	~443	same size
SmolVLM InstructHugging Face	—	4.9 GB	~320	same size
InternVL2 2BOpenGVLab	—	3.3 GB	~449	same size
Kimi K3 DSparkRadixArk	—	2.2 GB	~381	same size
OneRec 1.7BOpenOneRec	—	3.5 GB	~362	same size

Fine-tunes & variants(2)community builds of Qwen3 VL 2B Instruct

Specifications

Publisher: Alibaba
Family: Qwen 3
Parameters: 2.1B
Architecture: Qwen3VLForConditionalGeneration
Context Length: 262,144 tokens
Vocabulary Size: 151,936
Release Date: 2025-10-19
License: Apache 2.0

Resources

Frequently Asked Questions

How much VRAM does Qwen3 VL 2B Instruct need?

Qwen3 VL 2B Instruct requires 1.8 GB of VRAM at Q4_K_M, or 4.8 GB at BF16. Full 262K context adds up to 29.8 GB (31.6 GB total).

VRAM = Weights + KV Cache + Overhead

Weights = 2.1B × 4.8 bits ÷ 8 = 1.3 GB

KV Cache + Overhead ≈ 0.5 GB (at 2K context + ~0.3 GB framework)

Fit ratings and hardware model lists check this model with room for a 16K-token context, which needs a little more memory.

KV Cache + Overhead ≈ 30.3 GB (at full 262K context)

VRAM usage by quantization

Q4_K_M

1.8 GB

Q4_K_M + full context

31.6 GB

Learn more about VRAM estimation →

What's the best quantization for Qwen3 VL 2B Instruct?

For Qwen3 VL 2B Instruct, Q4_K_M (1.8 GB) offers the best balance of quality and VRAM usage. Q4_K_L (1.8 GB) provides better quality if you have the VRAM. The smallest option is IQ2_XXS at 1.1 GB.

VRAM requirement by quantization

IQ2_XXS

1.1 GB~53%

Q2_K

1.4 GB~75%

IQ4_XS

1.7 GB~87%

Q4_K_M ★

1.8 GB~89%

Q5_0

1.9 GB~90%

BF16

4.8 GB~100%

★ Recommended — best balance of quality and VRAM usage.

Learn more about quantization →

Can I run Qwen3 VL 2B Instruct on a Mac?

Yes — MacBook Air 13" M3 (8 GB) and 145 other Macs can run Qwen3 VL 2B Instruct. Apple Silicon uses unified memory, so the model shares RAM with the system. At Q4_K_M you need at least 1.8 GB of usable unified memory (RAM minus macOS overhead).

Can I run Qwen3 VL 2B Instruct locally?

Yes — Qwen3 VL 2B Instruct can run locally on consumer hardware. Popular tools include Ollama, LM Studio, and llama.cpp.

How fast is Qwen3 VL 2B Instruct?

At Q4_K_M, Qwen3 VL 2B Instruct can reach ~2652 tok/s on AMD Instinct MI350X. On NVIDIA GeForce RTX 4090: ~362 tok/s. Speed depends mainly on GPU memory bandwidth. Real-world results typically within ±20%.

tok/s = (bandwidth GB/s ÷ model GB) × efficiency

Example: NVIDIA B200 → 8000 ÷ 1.81 × 0.65 = ~2873 tok/s

Estimated speed at Q4_K_M (1.8 GB)

NVIDIA B200

~2873 tok/s

NVIDIA GeForce RTX 4090

~362 tok/s

NVIDIA B300

~2873 tok/s

AMD Instinct MI350X

~2652 tok/s

Real-world results typically within ±20%. Speed depends on batch size, quantization kernel, and software stack.

Learn more about tok/s estimation →

What's the download size of Qwen3 VL 2B Instruct?

At Q4_K_M, the download is about 1.28 GB. The full-precision BF16 version is 4.26 GB. The smallest option (IQ2_XXS) is 0.59 GB.

Which GPUs can run Qwen3 VL 2B Instruct?

52 consumer GPUs can run Qwen3 VL 2B Instruct at Q4_K_M. Top options include AMD Radeon RX 6700 XT, AMD Radeon RX 6800, AMD Radeon RX 6800 XT. 52 GPUs have plenty of headroom for comfortable inference.

Which devices can run Qwen3 VL 2B Instruct?

163 devices with unified memory can run Qwen3 VL 2B Instruct at Q4_K_M (1.8 GB), including AMD Ryzen AI 9 HX 370 (Strix Point) Laptop, ASUS Ascent GX10, Beelink GTR9 Pro (Ryzen AI Max+ 395, 128 GB), Framework Desktop (Ryzen AI Max+ 395, 128 GB). Apple Silicon Macs use unified memory shared between CPU and GPU, making them well-suited for local LLM inference.