Qwen3-VL grounding

Qwen3-VL grounding locates the target of an instruction as an image point.

Tasks: point detection
Sizes: 2b, 4b, 8b at 1024 px
Install: pip install "libreyolo[vlm]"
Support tier: Sibling tier, since v1.6.0. A separate product surface with its own factory and contract.
Upstream: Qwen3-VL by Qwen, Apache-2.0. Paper, source
Licenses: Code MIT, weights Apache-2.0. Commercial use

Install

bash

pip install "libreyolo[ground]"

Predict

Python

from libreyolo import LibreGround, SAMPLE_IMAGE model = LibreGround("qwen3-vl-2b", device="cpu")result = model(SAMPLE_IMAGE, prompt="the person")print(result.points.xy)

Use prompt= or query= for one call, or set_query() for a persistent instruction. A list of instructions on one image returns at most one click per query. Multi-query calls on image lists or folders raise an error. Coordinates refer to the original image. Training, validation and export are not supported. See the grounding API.

Licensing

Check the license on the Hugging Face repository of the specific weights you download. Every checkpoint in the LibreYOLO org carries one, and they are not always the same across a family. That repository is the authoritative source; the summary below describes what applied when this page was last verified.

This is a description of the licenses involved, not legal advice. If the answer matters commercially, read the licenses yourself and take your own counsel.

Original work: Qwen3-VL, Qwen
Upstream license: Apache-2.0
Upstream source: huggingface.co/Qwen
LibreYOLO code: MIT
Weights: Apache-2.0, republished at huggingface.co/LibreYOLO
Interpretation: The model publisher declares Apache-2.0.

Citation

@article{Qwen3-VL,
      title={Qwen3-VL Technical Report}, 
      author={Shuai Bai and Yuxuan Cai and Ruizhe Chen and Keqin Chen and Xionghui Chen and Zesen Cheng and Lianghao Deng and Wei Ding and Chang Gao and Chunjiang Ge and Wenbin Ge and Zhifang Guo and Qidong Huang and Jie Huang and Fei Huang and Binyuan Hui and Shutong Jiang and Zhaohai Li and Mingsheng Li and Mei Li and Kaixin Li and Zicheng Lin and Junyang Lin and Xuejing Liu and Jiawei Liu and Chenglong Liu and Yang Liu and Dayiheng Liu and Shixuan Liu and Dunjie Lu and Ruilin Luo and Chenxu Lv and Rui Men and Lingchen Meng and Xuancheng Ren and Xingzhang Ren and Sibo Song and Yuchong Sun and Jun Tang and Jianhong Tu and Jianqiang Wan and Peng Wang and Pengfei Wang and Qiuyue Wang and Yuxuan Wang and Tianbao Xie and Yiheng Xu and Haiyang Xu and Jin Xu and Zhibo Yang and Mingkun Yang and Jianxin Yang and An Yang and Bowen Yu and Fei Zhang and Hang Zhang and Xi Zhang and Bo Zheng and Humen Zhong and Jingren Zhou and Fan Zhou and Jing Zhou and Yuanzhi Zhu and Ke Zhu},
	  journal={arXiv preprint arXiv:2511.21631},
      year={2025}
}

Copied from the authors' citation block at github.com/QwenLM/Qwen3-VL#citation.

Install

Predict

Licensing

Citation

Qwen3-VL grounding architecture