> This is the documentation for LibreYOLO 1.6.0. Current version: https://www.libreyolo.com/docs/models/showui

# ShowUI
ShowUI locates the target of an instruction as an image point.
Tasks: Point detection. Install: pip install "libreyolo[vlm]".
Verified against LibreYOLO v1.6.0.

## Install

```bash
pip install "libreyolo[ground]"
```

## Predict

**Python**

```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](/docs/v1.6.0/reference/ground-api).

## Licensing

Check the license on the Hugging Face repository of the specific weights you download. That repository is authoritative and licenses are not always uniform across a family. This is a description of the licenses involved, not legal advice.

- Original work: ShowUI, ShowUI authors
- Upstream license: MIT
- Upstream source: https://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

```bibtex
@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 https://raw.githubusercontent.com/showlab/ShowUI/main/README.md


## ShowUI architecture

- ShowUI 2B: [SVG](/diagrams/models/showui/2b-point.svg), [interactive diagram](/diagrams/models/showui/2b-point.html)