Skip to main content
Get up and running with Qwen3-VL in just a few steps. This guide will walk you through your first image inference.

Installation

1

Install Transformers

Qwen3-VL requires transformers 4.57.0 or higher:
2

Install Optional Dependencies

For optimal performance, install these recommended packages:

Your First Inference

Here’s a complete example to perform image understanding with Qwen3-VL:
We recommend starting with the 8B model for development. For production, see the Model Variants guide.

Image Input Formats

Qwen3-VL supports multiple image input formats:

Model Selection

Choose a model size based on your use case:

2B / 4B Models

Edge deployment - Run on consumer GPUs or mobile devices

8B Model

Balanced - Best for most applications (24GB VRAM)

32B Model

High performance - Production use cases (80GB VRAM)

235B MoE Model

Maximum capability - Research and specialized tasks (8x80GB)

Performance Optimization

For better performance, enable Flash Attention 2:
Then load the model with:
Flash Attention 2 is especially beneficial for multi-image and video scenarios, reducing memory usage and improving speed.

Next Steps

Image Processing

Learn about multi-image inference and resolution control

Video Processing

Process videos with frame sampling

Capabilities

Explore OCR, grounding, document parsing, and more

Deployment

Deploy with vLLM or SGLang for production