UI-TARS README

The project's README from github.com/bytedance/UI-TARS. As one markdown file: README.md.

Local Image

🌐 Website   | 🤗 Hugging Face Models   |    🔧 Deployment    |    📑 Paper    |   🖥️ UI-TARS-desktop  
🏄 Midscene (Browser Automation)    |   🫨 Discord  

We also offer a UI-TARS-desktop version, which can operate on your local personal device. To use it, please visit https://github.com/bytedance/UI-TARS-desktop. To use UI-TARS in web automation, you may refer to the open-source project Midscene.js. ❗Notes: Since Qwen 2.5vl based models ultilizes absolute coordinates to ground objects, please kindly refer to our illustration about how to process coordinates in this guide.

Updates

Introduction

UI-TARS-1.5, an open-source multimodal agent built upon a powerful vision-language model. It is capable of effectively performing diverse tasks within virtual worlds.

Leveraging the foundational architecture introduced in our recent paper, UI-TARS-1.5 integrates advanced reasoning enabled by reinforcement learning. This allows the model to reason through its thoughts before taking action, significantly enhancing its performance and adaptability, particularly in inference-time scaling. Our new 1.5 version achieves state-of-the-art results across a variety of standard benchmarks, demonstrating strong reasoning capabilities and notable improvements over prior models.

🚀 Quick Start Guide: Deploying and Using Our Model

To help you get started quickly with our model, we recommend following the steps below in order. These steps will guide you through deployment, prediction post-processing to make the model take actions in your environment.

✅ Step 1: Deployment & Inference

👉 Deployment and Inference. This includes instructions for model deployment using huggingface endpoint, and running your first prediction.

✅ Step 2: Post Processing

Installation

pip install ui-tars
# or
uv pip install ui-tars

Usage

from ui_tars.action_parser import parse_action_to_structure_output, parsing_response_to_pyautogui_code

response = "Thought: Click the button\nAction: click(start_box='(100,200)')"
original_image_width, original_image_height = 1920, 1080
parsed_dict = parse_action_to_structure_output(
    response,
    factor=1000,
    origin_resized_height=original_image_height,
    origin_resized_width=original_image_width,
    model_type="qwen25vl"
)
print(parsed_dict)
parsed_pyautogui_code = parsing_response_to_pyautogui_code(
    responses=parsed_dict,
    image_height=original_image_height,
    image_width=original_image_width
)
print(parsed_pyautogui_code)
FYI: Coordinates visualization

To help you better understand the coordinate processing, we also provide a guide for coordinates processing visualization.

Prompt Usage Guide

To accommodate different device environments and task complexities, the following three prompt templates in codes/ui_tars/prompt.py. are designed to guide GUI agents in generating appropriate actions. Choose the template that best fits your use case:

🖥️ COMPUTER_USE

Recommended for: GUI tasks on desktop environments such as Windows, Linux, or macOS.

Features:

📱 MOBILE_USE

Recommended for: GUI tasks on mobile devices or Android emulators.

Features:

📌 GROUNDING

Recommended for: Lightweight tasks focused solely on action output, or for use in model training and evaluation.

Features:


When developing or evaluating multimodal interaction systems, choose the appropriate prompt template based on your target platform (desktop vs. mobile)

Performance

Online Benchmark Evaluation

Benchmark type Benchmark UI-TARS-1.5 OpenAI CUA Claude 3.7 Previous SOTA
Computer Use OSworld (100 steps) 42.5 36.4 28 38.1 (200 step)
Windows Agent Arena (50 steps) 42.1 - - 29.8
Browser Use WebVoyager 84.8 87 84.1 87
Online-Mind2web 75.8 71 62.9 71
Phone Use Android World 64.2 - - 59.5

Grounding Capability Evaluation

Benchmark UI-TARS-1.5 OpenAI CUA Claude 3.7 Previous SOTA
ScreenSpot-V2 94.2 87.9 87.6 91.6
ScreenSpotPro 61.6 23.4 27.7 43.6

Poki Game

Model 2048 cubinko energy free-the-key Gem-11 hex-frvr Infinity-Loop Maze:Path-of-Light shapes snake-solver wood-blocks-3d yarn-untangle laser-maze-puzzle tiles-master
OpenAI CUA 31.04 0.00 32.80 0.00 46.27 92.25 23.08 35.00 52.18 42.86 2.02 44.56 80.00 78.27
Claude 3.7 43.05 0.00 41.60 0.00 0.00 30.76 2.31 82.00 6.26 42.86 0.00 13.77 28.00 52.18
UI-TARS-1.5 100.00 0.00 100.00 100.00 100.00 100.00 100.00 100.00 100.00 100.00 100.00 100.00 100.00 100.00

Minecraft

Task Type Task Name VPT DreamerV3 Previous SOTA UI-TARS-1.5 w/o Thought UI-TARS-1.5 w/ Thought
Mine Blocks (oak_log) 0.8 1.0 1.0 1.0 1.0
(obsidian) 0.0 0.0 0.0 0.2 0.3
(white_bed) 0.0 0.0 0.1 0.4 0.6
200 Tasks Avg. 0.06 0.03 0.32 0.35 0.42
Kill Mobs (mooshroom) 0.0 0.0 0.1 0.3 0.4
(zombie) 0.4 0.1 0.6 0.7 0.9
(chicken) 0.1 0.0 0.4 0.5 0.6
100 Tasks Avg. 0.04 0.03 0.18 0.25 0.31

Model Scale Comparison

Here we compare performance across different model scales of UI-TARS on the OSworld benchmark.

Benchmark Type Benchmark UI-TARS-72B-DPO UI-TARS-1.5-7B UI-TARS-1.5
Computer Use OSWorld 24.6 27.5 42.5
GUI Grounding ScreenSpotPro 38.1 49.6 61.6

Limitations

While UI-TARS-1.5 represents a significant advancement in multimodal agent capabilities, we acknowledge several important limitations:

What's next

We are providing early research access to our top-performing UI-TARS-1.5 model to facilitate collaborative research. Interested researchers can contact us at [email protected].

Looking ahead, we envision UI-TARS evolving into increasingly sophisticated agentic experiences capable of performing real-world actions, thereby empowering platforms such as doubao to accomplish more complex tasks for you :)

Star History

Star History Chart

Citation

If you find our paper and model useful in your research, feel free to give us a cite.

@article{qin2025ui,
  title={UI-TARS: Pioneering Automated GUI Interaction with Native Agents},
  author={Qin, Yujia and Ye, Yining and Fang, Junjie and Wang, Haoming and Liang, Shihao and Tian, Shizuo and Zhang, Junda and Li, Jiahao and Li, Yunxin and Huang, Shijue and others},
  journal={arXiv preprint arXiv:2501.12326},
  year={2025}
}

UI-TARS (bytedance/UI-TARS)

Searching Database…

11.6K ·GitHub
这是什么?UI-TARS 是一个开源的多模态智能体模型,基于视觉语言模型构建,可以直接操作图形界面(GUI),包括点击、输入、滚动、拖拽,适用于桌面应用、手机屏幕、浏览器,甚至 Minecraft 等电子游戏。它在执行操作前会先进行推理。
这是可以直接使用的应用,还是需要我自己部署的模型?它是一个视觉语言模型,加上部署和后处理代码,需要你自行托管(例如通过 HuggingFace 推理端点)。另外还有一个独立的配套项目“UI-TARS-desktop”,可以把它作为应用运行在你自己的设备上。
我该怎么让它跑起来?按照两步快速入门指南操作:第一步,部署模型,并通过 HuggingFace 推理端点运行第一次预测;第二步,安装并运行后处理代码(codes/uitars/prompt.py),把模型的预测结果转换为实际的图形界面操作。
我需要 Anthropic 或 OpenAI 的 API 密钥吗?模型是自包含的吗?不需要外部 API 密钥。UI-TARS 本身就是一个开源模型(UI-TARS-1.5-7B),由你自己部署。README 中的基准测试只是把它与 OpenAI CUA 和 Claude 3.7 做了对比。
已知的局限性有哪些?作者明确指出:它可能被滥用来绕过 CAPTCHA 等防护机制;处理大型或长时间任务需要大量算力;可能会产生幻觉,或错误识别图形界面元素;开源的 7B 模型并非专门针对游戏场景优化。
它只能在桌面上用,还是也支持手机?两者都支持:COMPUTERUSE 提示模板处理 Windows、Linux 或 macOS 上的桌面操作;MOBILEUSE 则增加了类似 Android 的操作,如 longpress、openapp 和 pressback,适用于手机和模拟器。
运行它需要很强的硬件吗?需要。README 中说明,它仍然需要大量计算资源,尤其是大规模任务或较长时间的游戏过程。
UI-TARS-desktop 是什么?这是一个独立的配套项目,让你无需自己部署模型和后处理代码,就能直接在本地电脑上把 UI-TARS 作为现成的智能体运行。
它真的能玩电子游戏吗?可以。它在 14 款 Poki 浏览器游戏以及 Minecraft 的任务(如挖方块、击杀怪物)上进行了基准测试,在大多数 Poki 游戏中达到 100%,而 OpenAI CUA 和 Claude 3.7 的得分则低得多。
它与 OpenAI 和 Claude 的计算机使用智能体相比表现如何?在 OSWorld 基准测试中,UI-TARS-1.5 得分 42.5,OpenAI CUA 为 36.4,Claude 3.7 为 28;在 ScreenSpotPro 定位基准测试中,它得分 61.6,而 OpenAI CUA 和 Claude 3.7 分别为 23.4 和 27.7。
doubao 是什么,为什么会提到它?doubao 是 ByteDance 的 AI 平台。团队设想未来让 UI-TARS 为 doubao 提供能力,帮助用户完成更复杂的现实任务。
Creator
bytedance
Size
43.3 MB
Stars
11.6K
Updated
CommitSep 05
Age
1y
Commits · 90 Days