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:- URL
- Local File
- Base64
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: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