AI Tools
MultimodalIntermediate

OmniParser v2

Developed by Microsoft Research and released with a major v2.0 update in February 2025, OmniParser v2 is a state-of-the-art vision-based UI parsing tool that precisely converts complex graphical user interface (GUI) screenshots of computer screens into structured pixel data that machines can understand. Just as a person visually identifies buttons, icons, and text boxes on a monitor screen and clicks them with a mouse, a large vision-language model (VLM) can identify the location and meaning of objects on the screen.

Developed by Microsoft Research and released in February 2025 with a major v2.0 update, OmniParser v2 is a state-of-the-art, vision-based UI parsing tool that precisely converts complex graphical user interface (GUI) screenshots of computer screens into machine-readable, structured pixel data. It acts as a visual translator, enabling large vision-language models (VLMs) to perfectly recognize the location and meaning of screen objects, much like a person visually identifies buttons, icons, and text boxes on a monitor screen and clicks them with a mouse. OmniParser v2 operates through the organic combination of two core deep learning architectures: an icon detection model that accurately detects bounding boxes of individual UI elements on the screen, and an icon captioning model that describes the functional meaning of each element's visual icon in text. Through this pipeline, a single input image screenshot is easily and automatically converted into structured JSON data containing the relative coordinates of each element, its clickability, text labels, and visual function captions.

Traditional methods of building computer manipulation agents (GUI Agents) have been limited by their excessive reliance on the Document Object Model (DOM) tree of web browsers or specific proprietary APIs. This has often resulted in agents failing to properly identify the location or click area of buttons in dedicated desktop software with undisclosed source code or in virtual desktop environments rendered with images, causing frequent interruptions in the agent's operation. Just as GPT uses embeddings to understand complex contexts in natural language processing, OmniParser v2 extracts all clickable geometric objects from the screen pixel array and converts them into visual tokens that VLMs can immediately manipulate. In particular, version 2.0 achieves a low-latency inference processing speed that is more than 60% faster than previous versions, enabling real-time analysis of high-resolution screens within a delay of less than one second. Furthermore, it incorporates a finely tuned vision attention dataset and an optimized bounding box regression algorithm, which accurately recognizes even small or complex icons, fundamentally solving the chronic problem of graphic icon misidentification and malfunction that has plagued traditional OCR-based approaches.

This pixel-based UI parsing technology provides an innovative solution for building automated pipelines for dedicated electronic lab notebooks (ELNs) and bio-research equipment control software, which have long been in the blind spot of automation in the fields of biotechnology and multidisciplinary research. For example, in the case of a three-dimensional confocal microscope control program or automated liquid handler software that operates on a closed, native Windows platform, the lack of internal APIs requires a person to manually enter numerical parameters and press the capture button each time. By combining OmniParser v2 with existing VLM agents and the OmniTool computer automation framework, it is possible to extract the coordinates of clickable buttons and the location of numerical input forms within high-resolution graphic interfaces of 1024x1024 or higher with a high accuracy of 95% or more, using only a single screen screenshot. The collected screen coordinates are immediately converted into mouse clicks and keyboard events, contributing to the complete automation of multi-sample data collection procedures without researcher intervention during nighttime or large-scale bio-screening experiments.

Furthermore, OmniParser v2 goes beyond simple screenshot parsing and enables cross-platform agent orchestration across heterogeneous platforms, including web, desktop, and mobile apps. Implemented in PyTorch, it enables fast pass-through inference even in a single consumer GPU environment, and through tensor-based pipeline optimization, it supports immediate connection with various open-source and commercial LLM/VLM prompt chains. Research and development organizations can easily integrate all GUI-based software as targets for intelligent agents by using OmniParser v2, without the need to modify existing offline legacy systems or develop new, costly APIs, thereby dramatically improving the productivity of digital transformation and the overall research data collection process.

💻 System Requirements

🧠RAM

NVIDIA GPU 8GB+ 권장 (RTX 3060/4060 이상 실시간 추론), CPU 실행 가능 (단독 1장당 처리 시간 증가)

💾Storage

모델 가중치 약 3~5GB (Icon Detection + Captioning checkpoints), 전체 파이프라인 약 8GB

Installation

4-1. Quick Start

git clone https://github.com/microsoft/OmniParser
cd OmniParser
conda create -n omni python=3.12 -y && conda activate omni
pip install -r requirements.txt
huggingface-cli download microsoft/OmniParser-v2.0 --local-dir weights

4-2. 상세 설치 및 기본 사용법

# 1. 저장소 복제 및 전용 환경 구축
git clone https://github.com/microsoft/OmniParser
cd OmniParser
conda create -n omni python=3.12 -y
conda activate omni

# 2. 의존성 패키지 설치
pip install -r requirements.txt

# 3. v2.0 공식 가중치 다운로드 (weights 폴더 지정)
huggingface-cli download microsoft/OmniParser-v2.0 --local-dir weights
from utils import check_ocr_box, get_yolo_model, get_caption_model_processor

# 모델 및 프로세서 로드
yolo_model = get_yolo_model(model_path='weights/icon_detect/model.pt')
caption_model_processor = get_caption_model_processor(model_name="florence2", model_name_or_path="weights/icon_caption")

# 이미지 파싱 및 요소 좌표/캡션 획득
# (추론 실행 시 화면 내 인터랙션 가능한 모든 픽셀 좌표와 캡션 리스트 반환)

🧬 Bio Use Cases

🔬

Automated Legacy Software for Controlling Laboratory Equipment

Automated analysis of screenshots from native Windows microscope/spectrometer software that does not support APIs → Automatically identify UI button coordinates (parsing at 1024x1024 resolution within 1 second) and numerical input fields, and link to mouse/keyboard automation for control.

🧬

Automated Data Input Agent for Electronic Lab Notebooks (ELN)

Automatically recognize the location of data input forms and save icons in web-based/desktop ELN interfaces → Parse the latest research results through VLM integration and automatically transmit and record the data.

💊

Large-Scale Unmanned Screening Workflow

Real-time collection and analysis of multi-device monitoring screens → Automatically identify the location of alert buttons when abnormal conditions occur and build an autonomous bio-pipeline that activates a warning module tree.

FAQ

What is OmniParser v2?

Developed by Microsoft Research and released in February 2025 with a major v2.0 update, OmniParser v2 is a state-of-the-art, vision-based UI parsing tool that precisely converts complex graphical user interface (GUI) screenshots of computer screens into machine-readable, structured pixel data. It acts as a visual translator, enabling large vision-language models (VLMs) to perfectly recognize the location and meaning of screen objects, much like a person visually identifies buttons, icons, and text boxes on a monitor screen and clicks them with a mouse. OmniParser v2 operates through the organic combination of two core deep learning architectures: an icon detection model that accurately detects bounding boxes of individual UI elements on the screen, and an icon captioning model that describes the functional meaning of each element's visual icon in text. Through this pipeline, a single input image screenshot is easily and automatically converted into structured JSON data containing the relative coordinates of each element, its clickability, text labels, and visual function captions. Traditional methods of building computer manipulation agents (GUI Agents) have been limited by their excessive reliance on the Document Object Model (DOM) tree of web browsers or specific proprietary APIs. This has often resulted in agents failing to properly identify the location or click area of buttons in dedicated desktop software with undisclosed source code or in virtual desktop environments rendered with images, causing frequent interruptions in the agent's operation. Just as GPT uses embeddings to understand complex contexts in natural language processing, OmniParser v2 extracts all clickable geometric objects from the screen pixel array and converts them into visual tokens that VLMs can immediately manipulate. In particular, version 2.0 achieves a low-latency inference processing speed that is more than 60% faster than previous versions, enabling real-time analysis of high-resolution screens within a delay of less than one second. Furthermore, it incorporates a finely tuned vision attention dataset and an optimized bounding box regression algorithm, which accurately recognizes even small or complex icons, fundamentally solving the chronic problem of graphic icon misidentification and malfunction that has plagued traditional OCR-based approaches. This pixel-based UI parsing technology provides an innovative solution for building automated pipelines for dedicated electronic lab notebooks (ELNs) and bio-research equipment control software, which have long been in the blind spot of automation in the fields of biotechnology and multidisciplinary research. For example, in the case of a three-dimensional confocal microscope control program or automated liquid handler software that operates on a closed, native Windows platform, the lack of internal APIs requires a person to manually enter numerical parameters and press the capture button each time. By combining OmniParser v2 with existing VLM agents and the OmniTool computer automation framework, it is possible to extract the coordinates of clickable buttons and the location of numerical input forms within high-resolution graphic interfaces of 1024x1024 or higher with a high accuracy of 95% or more, using only a single screen screenshot. The collected screen coordinates are immediately converted into mouse clicks and keyboard events, contributing to the complete automation of multi-sample data collection procedures without researcher intervention during nighttime or large-scale bio-screening experiments. Furthermore, OmniParser v2 goes beyond simple screenshot parsing and enables cross-platform agent orchestration across heterogeneous platforms, including web, desktop, and mobile apps. Implemented in PyTorch, it enables fast pass-through inference even in a single consumer GPU environment, and through tensor-based pipeline optimization, it supports immediate connection with various open-source and commercial LLM/VLM prompt chains. Research and development organizations can easily integrate all GUI-based software as targets for intelligent agents by using OmniParser v2, without the need to modify existing offline legacy systems or develop new, costly APIs, thereby dramatically improving the productivity of digital transformation and the overall research data collection process.

When should I use OmniParser v2?

Developed by Microsoft Research and released with a major v2.0 update in February 2025, OmniParser v2 is a state-of-the-art vision-based UI parsing tool that precisely converts complex graphical user interface (GUI) screenshots of computer screens into structured pixel data that machines can understand. Just as a person visually identifies buttons, icons, and text boxes on a monitor screen and clicks them with a mouse, a large vision-language model (VLM) can identify the location and meaning of objects on the screen.

What is a biomedical use case for OmniParser v2?

Automated Legacy Software for Controlling Laboratory Equipment: Automated analysis of screenshots from native Windows microscope/spectrometer software that does not support APIs → Automatically identify UI button coordinates (parsing at 1024x1024 resolution within 1 second) and numerical input fields, and link to mouse/keyboard automation for control.

📄 Official Docs🐙 GitHub

📝 Update Notes

  1. vv.2.0.17/20/2026

    OmniParser v2.0.1 버전에서는 보안 강화와 의존성 버전 수정, 그리고 문서 개선 작업이 진행되었습니다. 보안 업데이트를 통해 민감한 실험 데이터와 연구 자산을 더욱 안전하게 보호할 수 있게 되었습니다. 또한, 의존성 오류 수정으로 분석 파이프라인의 안정성과 실험 결과의 재현성을 높였으며, 개선된 문서를 통해 도구 활용도 한층 쉬워졌습니다.

🧪 Related Code of Life

No related Code of Life posts yet.