ShowUI

ShowUI locates the target of an instruction as an image point.

Tasks: point detection
Sizes: 2b at 1344 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: ShowUI by ShowUI authors, MIT. Paper, source
Licenses: Code MIT, weights MIT. Commercial use

Install

bash

pip install "libreyolo[ground]"

Predict

Python

from libreyolo import LibreGround, SAMPLE_IMAGE model = LibreGround("showui-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: ShowUI, ShowUI authors
Upstream license: MIT
Upstream source: github.com/showlab/ShowUI
LibreYOLO code: MIT
Weights: MIT, distributed by their authors. LibreYOLO does not host or mirror them.
Interpretation: The model publisher declares MIT.

Citation

@misc{lin2024showui,
      title={ShowUI: One Vision-Language-Action Model for GUI Visual Agent}, 
      author={Kevin Qinghong Lin and Linjie Li and Difei Gao and Zhengyuan Yang and Shiwei Wu and Zechen Bai and Weixian Lei and Lijuan Wang and Mike Zheng Shou},
      year={2024},
      eprint={2411.17465},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2411.17465}, 
}

Copied from the authors' citation block at raw.githubusercontent.com/showlab/ShowUI/main/README.md.

Install

Predict

Licensing

Citation

ShowUI architecture