| --- |
| library_name: pytorch |
| license: other |
| tags: |
| - llm |
| - vlm |
| - generative_ai |
| - android |
| pipeline_tag: text-generation |
|
|
| --- |
| |
|  |
|
|
| # Qwen3-VL-4B-Instruct: Optimized for Qualcomm Devices |
|
|
| Qwen3-VL is a vision-language model from Alibaba Cloud capable of understanding both text and images for multimodal reasoning tasks such as visual question answering and image captioning. |
|
|
| This is based on the implementation of Qwen3-VL-4B-Instruct found [here](https://huggingface.co/Qwen/Qwen3-VL-4B-Instruct). |
| This repository contains pre-exported model files optimized for Qualcomm® devices. You can use the [Qualcomm® AI Hub Models](https://github.com/qualcomm/ai-hub-models/blob/v0.58.0/src/qai_hub_models/models/qwen3_vl_4b_instruct) library to export with custom configurations. More details on model performance across various devices, can be found [here](#performance-summary). |
|
|
| Qualcomm AI Hub Models uses [Qualcomm AI Hub Workbench](https://workbench.aihub.qualcomm.com) to compile, profile, and evaluate this model. [Sign up](https://myaccount.qualcomm.com/signup) to run these models on a hosted Qualcomm® device. |
|
|
| ## Deploying Qwen3-VL-4B-Instruct on-device |
|
|
| Follow the [GenieX quickstart](https://geniex.aihub.qualcomm.com/en/get-started/quickstart) to install GenieX and deploy the model on a target device. |
|
|
| See the [LLM-on-Genie](https://github.com/qualcomm/ai-hub-apps/tree/main/tutorials/llm_on_genie) tutorial to run with the Genie runtime. Note: Genie support will be deprecated soon. |
|
|
| ## Getting Started |
| There are two ways to deploy this model on your device: |
|
|
| ### Option 1: Download Pre-Exported Models |
|
|
| Below are pre-exported model assets ready for deployment. |
|
|
| | Runtime | Precision | Chipset | SDK Versions | Download | |
| |---|---|---|---|---| |
| | GENIE | w4a16 | Snapdragon® 8 Elite Gen 5 Mobile | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-genie-w4a16-qualcomm_snapdragon_8_elite_gen5.zip) |
| | GENIE | w4a16 | Snapdragon® 8 Elite Mobile | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-genie-w4a16-qualcomm_snapdragon_8_elite.zip) |
| | GENIE | w4a16 | Snapdragon® X2 Elite | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-genie-w4a16-qualcomm_snapdragon_x2_elite.zip) |
| | GENIE | w4a16 | Snapdragon® X Elite | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-genie-w4a16-qualcomm_snapdragon_x_elite.zip) |
| | GENIE | w4a16 | Qualcomm® QCS8275 | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-genie-w4a16-qualcomm_qcs8275.zip) |
| | GENIE | w4a16 | Qualcomm® SA8775P | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-genie-w4a16-qualcomm_sa8775p.zip) |
| | GENIE | w4a16 | Qualcomm® Dragonwing™ IQ-9075 | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-genie-w4a16-qualcomm_qcs9075.zip) |
| | GENIEX_LLAMACPP | q4_0 | Universal | | [Download](https://huggingface.co/unsloth/Qwen3-VL-4B-Instruct-GGUF/resolve/main/Qwen3-VL-4B-Instruct-Q4_0.gguf) |
| | GENIEX_QAIRT | w4a16 | Snapdragon® 8 Elite Gen 5 Mobile | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-geniex_qairt-w4a16-qualcomm_snapdragon_8_elite_gen5.zip) |
| | GENIEX_QAIRT | w4a16 | Snapdragon® 8 Elite Mobile | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-geniex_qairt-w4a16-qualcomm_snapdragon_8_elite.zip) |
| | GENIEX_QAIRT | w4a16 | Snapdragon® X2 Elite | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-geniex_qairt-w4a16-qualcomm_snapdragon_x2_elite.zip) |
| | GENIEX_QAIRT | w4a16 | Snapdragon® X Elite | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-geniex_qairt-w4a16-qualcomm_snapdragon_x_elite.zip) |
| | GENIEX_QAIRT | w4a16 | Qualcomm® QCS8275 | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-geniex_qairt-w4a16-qualcomm_qcs8275.zip) |
| | GENIEX_QAIRT | w4a16 | Qualcomm® Dragonwing™ IQ-9075 | QAIRT 2.45 | [Download](https://qaihub-public-assets.s3.us-west-2.amazonaws.com/qai-hub-models/models/qwen3_vl_4b_instruct/releases/v0.58.0/qwen3_vl_4b_instruct-geniex_qairt-w4a16-qualcomm_qcs9075.zip) |
|
|
| For more device-specific assets and performance metrics, visit **[Qwen3-VL-4B-Instruct on Qualcomm® AI Hub](https://aihub.qualcomm.com/models/qwen3_vl_4b_instruct)**. |
|
|
|
|
| ### Option 2: Export with Custom Configurations |
|
|
| Use the [Qualcomm® AI Hub Models](https://github.com/qualcomm/ai-hub-models/blob/v0.58.0/src/qai_hub_models/models/qwen3_vl_4b_instruct) Python library to compile and export the model with your own: |
| - Custom weights (e.g., fine-tuned checkpoints) |
| - Custom input shapes |
| - Target device and runtime configurations |
|
|
| This option is ideal if you need to customize the model beyond the default configuration provided here. |
|
|
| See our repository for [Qwen3-VL-4B-Instruct on GitHub](https://github.com/qualcomm/ai-hub-models/blob/v0.58.0/src/qai_hub_models/models/qwen3_vl_4b_instruct) for usage instructions. |
|
|
| ## Model Details |
|
|
| **Model Type:** Model_use_case.text_generation |
| |
| **Model Stats:** |
| - Model architecture: Transformer with ViT Vision Encoder, Grouped Query Attention (GQA), and SwiGLU activation. |
| - Supported languages: 100+ languages and dialects |
| - TTFT: Time To First Token is the time it takes to generate the first response token. This is expressed as a range because it varies based on the length of the prompt. |
| - Response Rate: Rate of response generation after the first response token. |
| |
| ## Performance Summary |
| | Model | Runtime | Precision | Chipset | Context Length | Response Rate (tokens per second) | Time To First Token (range, seconds) |
| |---|---|---|---|---|---|--- |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® 8 Elite Gen 5 Mobile | 512 | 21.937586 | 1.04066225 - 4.162649 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® 8 Elite Gen 5 Mobile | 512 | 21.063662 | 1.1498887500000001 - 4.5995550000000005 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® 8 Elite Gen 5 Mobile | 512 | 12.51382 | 0.17715475 - 0.708619 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® 8 Elite Gen 5 Mobile | 4096 | 7.594744 | 3.0647713125 - 98.072682 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® 8 Elite Gen 5 Mobile | 4096 | 7.347485 | 3.0688408437500003 - 98.20290700000001 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® 8 Elite Gen 5 Mobile | 4096 | 12.036943 | 0.33230665625 - 10.633813 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® 8 Elite Mobile | 512 | 21.038925 | 1.15949925 - 4.637997 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® 8 Elite Mobile | 512 | 20.872003 | 1.22482375 - 4.899295 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® 8 Elite Mobile | 512 | 18.041792 | 0.24882474999999998 - 0.9952989999999999 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® 8 Elite Mobile | 4096 | 5.266429 | 3.2057110625 - 102.582754 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® 8 Elite Mobile | 4096 | 5.404354 | 3.23921925 - 103.655016 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® 8 Elite Mobile | 4096 | 11.884297 | 0.49755121874999997 - 15.921638999999999 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® X Elite | 512 | 21.892482 | 0.4739375 - 1.89575 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® X Elite | 512 | 22.078185 | 0.51991475 - 2.079659 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® X Elite | 512 | 11.538787 | 0.37511574999999997 - 1.5004629999999999 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® X Elite | 4096 | 7.683006 | 1.2810328125000001 - 40.993050000000004 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® X Elite | 4096 | 8.547017 | 1.3233025 - 42.34568 |
| | Qwen3-VL-4B-Instruct | GENIEX_LLAMACPP | q4_0 | Snapdragon® X Elite | 4096 | 7.576911 | 0.5775706562499999 - 18.482260999999998 |
| | Qwen3-VL-4B-Instruct | GENIEX_QAIRT | w4a16 | Snapdragon® 8 Elite Gen 5 Mobile | 4096 | 29.162899 | 0.0494 - 0.7904 |
| | Qwen3-VL-4B-Instruct | GENIEX_QAIRT | w4a16 | Snapdragon® 8 Elite Mobile | 4096 | 27.22378 | 0.0596 - 1.9072 |
| | Qwen3-VL-4B-Instruct | GENIEX_QAIRT | w4a16 | Snapdragon® X2 Elite | 4096 | 39.217323 | 0.046799999999999994 - 1.4975999999999998 |
| | Qwen3-VL-4B-Instruct | GENIEX_QAIRT | w4a16 | Snapdragon® X Elite | 4096 | 20.886665 | 0.1 - 3.2 |
| | Qwen3-VL-4B-Instruct | GENIEX_QAIRT | w4a16 | Qualcomm® Dragonwing™ IQ-9075 | 4096 | 18.401298 | 0.0916 - 2.9312 |
|
|
| ## License |
| * The license for the original implementation of Qwen3-VL-4B-Instruct can be found |
| [here](https://www.apache.org/licenses/LICENSE-2.0). |
|
|
| ## References |
| * [Qwen3 Technical Report](https://arxiv.org/abs/2505.09388) |
| * [Source Model Implementation](https://huggingface.co/Qwen/Qwen3-VL-4B-Instruct) |
|
|
| ## Community |
| * Join [our AI Hub Slack community](https://aihub.qualcomm.com/community/slack) to collaborate, post questions and learn more about on-device AI. |
| * For questions or feedback please [reach out to us](mailto:ai-hub-support@qti.qualcomm.com). |
|
|
| ## Usage and Limitations |
|
|
| This model may not be used for or in connection with any of the following applications: |
|
|
| - Accessing essential private and public services and benefits; |
| - Administration of justice and democratic processes; |
| - Assessing or recognizing the emotional state of a person; |
| - Biometric and biometrics-based systems, including categorization of persons based on sensitive characteristics; |
| - Education and vocational training; |
| - Employment and workers management; |
| - Exploitation of the vulnerabilities of persons resulting in harmful behavior; |
| - General purpose social scoring; |
| - Law enforcement; |
| - Management and operation of critical infrastructure; |
| - Migration, asylum and border control management; |
| - Predictive policing; |
| - Real-time remote biometric identification in public spaces; |
| - Recommender systems of social media platforms; |
| - Scraping of facial images (from the internet or otherwise); and/or |
| - Subliminal manipulation |
|
|