OmniParser README

The project's README from github.com/microsoft/OmniParser. As one markdown file: README.md.

OmniParser: Screen Parsing tool for Pure Vision Based GUI Agent

Logo

arXiv License

📢 [Project Page] [V2 Blog Post] [Models V2] [Models V1.5] [HuggingFace Space Demo]

OmniParser is a comprehensive method for parsing user interface screenshots into structured and easy-to-understand elements, which significantly enhances the ability of GPT-4V to generate actions that can be accurately grounded in the corresponding regions of the interface.

News

Install

First clone the repo, and then install environment:

cd OmniParser
conda create -n "omni" python==3.12
conda activate omni
pip install -r requirements.txt

Until Hugging Face PR #37 is merged, download the latest YOLOv9-E detector from the PR:

huggingface-cli download microsoft/OmniParser-v2.0 icon_detect_v3/model.pt \
  --revision refs/pr/37 --local-dir weights

OmniParser prefers this local weight. After the PR is merged, it will download the same weight automatically on first use. Download the caption weights into the weights folder:

   for f in icon_caption/{config.json,generation_config.json,model.safetensors}; do huggingface-cli download microsoft/OmniParser-v2.0 "$f" --local-dir weights; done
   mv weights/icon_caption weights/icon_caption_florence

Examples:

We put together a few simple examples in the demo.ipynb.

Gradio Demo

To run gradio demo, simply run:

python gradio_demo.py

Model Weights License

icon_detect_v3 is based on the MIT-licensed YOLOv9 implementation. Earlier Ultralytics-based icon detectors retain their original AGPL license. The caption models are under the MIT license.

📚 Citation

Our technical report can be found here. If you find our work useful, please consider citing our work:

@misc{lu2024omniparserpurevisionbased,
      title={OmniParser for Pure Vision Based GUI Agent}, 
      author={Yadong Lu and Jianwei Yang and Yelong Shen and Ahmed Awadallah},
      year={2024},
      eprint={2408.00203},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2408.00203}, 
}

OmniParser (microsoft/OmniParser)

Searching Database…

Что это такое?OmniParser разбирает скриншоты графического интерфейса на структурированные размеченные элементы (иконки, текст, интерактивные области), чтобы модель компьютерного зрения, например GPT-4V, могла точно определить, на что нажать или что ввести на экране.
Это готовое приложение-агент или набор инструментов, который я могу встроить в своего агента?Это набор инструментов для восприятия (детектор областей на основе YOLOv9 и модель описания иконок), который вызывается из блокнота, демо на Gradio или 'OmniTool'. OmniTool подключает его к модели компьютерного зрения для управления виртуальной машиной.
Как это запустить?Склонируйте репозиторий, установите окружение, затем загрузите веса детектора и модели описания в папку weights; в качестве примеров включены демо на Gradio и demo.ipynb.
С какими моделями компьютерного зрения можно использовать OmniTool?OmniTool из коробки работает с OpenAI (4o/o1/o3-mini), DeepSeek (R1), Qwen (2.5VL) или Anthropic Computer Use.
Есть ли подводные камни в лицензиях весов моделей?Да: новые детектор icondetectv3 и модели описания распространяются по лицензии MIT, но более ранние детекторы иконок на основе Ultralytics сохраняют исходную лицензию AGPL, поэтому проверьте, какую версию весов вы загружаете.
Что нового в OmniParser V2?V2 лучше находит мелкие иконки и предсказывает, можно ли взаимодействовать с каждым элементом интерфейса. Также она установила новый рекорд: 39,5% на бенчмарке Screen Spot Pro для поиска элементов интерфейса.
Что такое OmniTool?OmniTool — это сопутствующее приложение, которое позволяет управлять виртуальной машиной Windows 11 с помощью разбора экрана OmniParser в сочетании с выбранной вами моделью компьютерного зрения, например GPT-4o или Claude Computer Use.
Какие результаты бенчмарков это подтверждают?OmniParser занял первое место в таблице лидеров Windows Agent Arena и набрал 39,5% на бенчмарке Screen Spot Pro с версией V2.
Creator
microsoft
Size
50.8 MB
Stars
25.5K
Age
2y
Commits · 90 Days