Репозиторий лучше всего рассматривать как два связанных продукта, разделяющих одну экосистему: Agent TARS переносит рабочие процессы мультимодальных агентов в терминал, браузер, компьютер и интерфейсы продуктов; UI-TARS Desktop фокусируется на нативном GUI-агенте, управляемом моделями UI-TARS и Seed VLM для локального, удаленного и браузерного управления.
Get the latest on AI, LLMs & developer tools
New MCP servers, model updates, and guides like this one — delivered weekly.
Посмотреть видео о UI-TARS
Предпочитаете читать? В письменном руководстве ниже рассматриваются стек, пути настройки, предостережения по безопасности и компромиссы.
Редакционная заметка
Эта статья основана на репозитории GitHub, README, документации по быстрому запуску, списке релизов, трекере проблем, трекере PR, ссылках на домашнюю страницу/документацию и дереве исходного кода, исследованных 3 июня 2026 г. Точные показатели популярности опущены, так как они быстро меняются.
1. UI-TARS-desktop в одном предложении
UI-TARS Desktop — это TypeScript монорепозиторий под лицензией Apache 2.0 для мультимодальных GUI-агентов, включающий CLI/Web UI Agent TARS плюс десктопное приложение для управления компьютером с визуальным позиционированием, операторами браузера, интеграцией MCP и режимами локальной/удаленной работы.
| Область | Детали | Почему это важно |
|---|---|---|
| Репозиторий | bytedance/UI-TARS-desktop | https://github.com/bytedance/UI-TARS-desktop |
| Основной язык | TypeScript | Основной язык GitHub на момент исследования. |
| Лицензия | Apache 2.0 | При необходимости отдельно проверьте лицензии встроенных или бинарных компонентов. |
| Создано | 19 января 2025 г. | Последний релиз GitHub проверен: v0.3.0 от 4 ноября 2025 г.; v0.2.4 содержала бинарные файлы для десктопа, в то время как активы релиза v0.3.0 были неоднозначными во время исследования. |
2. Почему это важно
Агенты для управления компьютером переходят от демо-версий только для браузера к реальным рабочим процессам на рабочем столе и в продуктах. UI-TARS Desktop важен, потому что он объединяет VLM-агента, нативное десктопное приложение, модель оператора браузера/компьютера и экосистему инструментов на базе MCP в одном открытом репозитории.
Разделение между Agent TARS и UI-TARS Desktop важно. Agent TARS — это более широкий стек: CLI, Web UI, поток событий, MCP, агент браузера и мультимодальный рабочий процесс. UI-TARS Desktop — это приложение GUI-агента, которое взаимодействует с локальными или удаленными компьютерами и браузерами.
Проект также является полезным тематическим исследованием безопасности агентов. Система, которая может кликать, печатать, выполнять команды оболочки, управлять браузерами и подключать серверы MCP, нуждается в шлюзах подтверждения, усилении безопасности, точности координат и четкой упаковке. Недавние PR и проблемы показывают, что эти темы актуальны.
3. Архитектура и ментальная модель
Репозиторий представляет собой TypeScript монорепозиторий с `apps`, `packages`, `docs`, `examples`, `infra`, `multimodal` и RFC. Agent TARS предоставляет интерфейсы CLI и Web UI, в то время как UI-TARS Desktop упаковывает операторы локального/удаленного компьютера и браузера, управляемые мультимодальными моделями.
| Область | Детали | Почему это важно |
|---|---|---|
| Среда выполнения агента | Agent TARS | Стек агентов CLI и Web UI для мультимодальных рабочих процессов и инструментов MCP. |
| Десктопный продукт | UI-TARS Desktop | Нативный GUI-агент для управления локальным компьютером, удаленным компьютером и браузером. |
| Уровень моделей | UI-TARS, базовые визуально-языковые модели, VLM от различных провайдеров | Визуальное распознавание и прогнозирование действий обеспечивают управление GUI. |
| Уровень инструментов | MCP плюс операторы браузера/компьютера | Подключает агента к реальным инструментам и интерфейсам UI. |
| Поток событий | Поток событий на основе протокола | Используется для проектирования контекста, отладки и состояния UI агента. |
| Документация и примеры | `docs`, `examples`, `agent-tars.com` | Быстрый старт, настройка провайдера, CLI/Web UI, браузер, MCP и демонстрационные материалы. |
| Упаковка релизов | Релизы GitHub и пакет npm | Agent TARS CLI имеет историю релизов; доступность десктопного бинарного файла, по-видимому, является вопросом пользователей. |
4. Минимальная end-to-end настройка
Команды ниже взяты из документации репозитория и сверены с текущим исследовательским снимком. Используйте их как отправную точку, а затем прочитайте связанную README перед установкой в production.
# Agent TARS CLI; package metadata observed Node >= 22.15.0
npx @agent-tars/cli@latest
# Global install
npm install @agent-tars/cli@latest -g
# Run with a provider/model
agent-tars --provider volcengine --model doubao-1-5-thinking-vision-pro-250428 --apiKey your-api-key
agent-tars --provider anthropic --model claude-3-7-sonnet-latest --apiKey your-api-key
# UI-TARS Desktop local development; root repo uses pnpm
pnpm i
pnpm dev:ui-tarsНебольшая первая задача должна подтвердить интеграцию, прежде чем подключать ее к критичным данным или большим рабочим пространствам.
# Desktop user path
brew install --cask ui-tars
# Read the repo quick-start first:
# https://github.com/bytedance/UI-TARS-desktop/blob/main/docs/quick-start.md
# Mental model:
# 1. choose local, remote computer, or browser operator
# 2. configure a supported vision-language model
# 3. verify single-monitor/browser/operator constraints
# 4. grant only the permissions needed for the target task
# 5. test on a harmless UI before using real accounts or paid actions5. Технический разбор
5.1 Agent TARS и UI-TARS Desktop решают смежные задачи
В README TARS представлен как мультимодальный стек агентов с двумя готовыми проектами. Agent TARS нацелен на рабочие процессы в терминале, компьютере, браузере и продуктах через CLI и Web UI. UI-TARS Desktop — это нативное приложение GUI-агента для работы с локальным или удаленным компьютером/браузером.
Это различие предотвращает путаницу при настройке. Если вам нужен агент с CLI/Web UI и инструментами MCP, начните с Agent TARS. Если вам нужен десктопный GUI-оператор на базе моделей UI-TARS, ознакомьтесь с кратким руководством по десктопной версии и примечаниями по развертыванию моделей.
5.2 Визуальное позиционирование — ключевая возможность
GUI-агент должен видеть экран, определять целевой элемент и сопоставлять его с действиями мыши и клавиатуры. В README подчеркивается поддержка скриншотов и визуального распознавания, точное управление мышью/клавиатурой, а также приводятся примеры, такие как изменение настроек VS Code или работа в браузере.
Риск заключается в дрейфе координат. Недавние проблемы включают смещение предсказания клика в новых средах macOS и сбои взаимодействий, когда приложение переходит на передний план. Это не косметические баги; они напрямую влияют на то, может ли агент безопасно работать с UI.
5.3 Работа с браузером — это не только автоматизация DOM
Agent TARS позиционируется как гибридный браузерный агент: GUI агент, DOM или гибридное управление. Это важно, потому что реальные веб-сайты сочетают визуальное состояние, динамические DOM, разрешения, iframe, canvas и защиту от автоматизации.
Гибридная стратегия позволяет агенту использовать структуру DOM, когда она надежна, и визуальное обоснование, когда страницу лучше воспринимать как пиксели. Это также усложняет задачу, так как агент должен решать, какой канал наблюдения/действия является приоритетным.
Browser task:
visual screenshot
+ DOM structure where available
+ MCP/tool context
-> action plan
-> click/type/navigation
-> event stream for review/debugging5.4 MCP превращает агента в хост инструментов
В README сказано, что ядро Agent TARS построено на MCP и поддерживает подключение MCP серверов. Это важно, потому что агент для работы с компьютером не должен использовать пиксели для всего. Данные о погоде, графики, файлы, документы, API и внутренние инструменты часто безопаснее использовать через типизированные инструменты.
Слой MCP также увеличивает нагрузку на безопасность. Инъекции описаний инструментов и санитайзинг вывода появляются в трекере проблем, в то время как PR добавляют шлюзы безопасности команд и усиливают проверки безопасности. Это именно те места, где стек мультимодального агента требует внимания.
5.5 Релизы — это не вся история актуальности
Последний проверенный релиз на GitHub — v0.3.0 от ноября 2025 года, но проблемы и PR продолжали поступать до мая 2026 года. Это означает, что страница релизов не полностью отражает активность живого репозитория.
Существует также нюанс с упаковкой: список активов релиза v0.3.0 был неоднозначным во время исследования, в то время как v0.2.4 имел десктопные активы, такие как файлы DMG/EXE/ZIP/обновления. Для пользователей это создает практический вопрос по настройке: использовать ли Agent TARS CLI, Homebrew cask, предыдущий бинарный релиз для десктопа, исходный код или документацию с сайта.
6. Реальные паттерны: неверно vs верно
| Неверно | Верно | Причина |
|---|---|---|
| Относитесь к управлению компьютером как к обычной автоматизации чата. | Относитесь к нему как к оператору UI с правами доступа и реальными побочными эффектами. | Действия клика/ввода могут совершать покупки, удалять, отправлять или раскрывать данные. |
| Начинайте с реальной учетной записи с деньгами или конфиденциальными данными. | Сначала проведите дымовое тестирование на безопасных локальных приложениях и одноразовых сессиях браузера. | Возможны ошибки координат, фокуса и модельного обоснования. |
| Не предполагайте, что десктопное приложение и Agent TARS CLI устанавливаются одинаково. | Выберите путь, соответствующий вашему сценарию использования: CLI/Web UI или нативный десктопный оператор. | Репозиторий поставляет два связанных, но различных продукта. |
| Подключайте произвольные MCP серверы без проверки. | Проверяйте описания инструментов, обработку вывода, разрешения команд и сетевой охват. | MCP расширяет как возможности, так и поверхность атаки. |
7. Частые ошибки и текущие проблемы
Issue tracker важен, потому что эти репозитории молоды и быстро меняются. В статье issues используются как сигналы риска, а не как доказательство непригодности проекта.
| Область | Детали | Почему это важно |
|---|---|---|
| Обнаружение исполняемых файлов | В Issue #1878 спрашивается, где скачать десктопный exe из v0.3.0. | Ожидания по упаковке могут не совпадать с релизными артефактами. |
| Ограничение одного монитора | В документации по быстрому старту указаны ограничения поддержки одного монитора. | Настройки рабочего стола с несколькими мониторами могут приводить к сбоям в некоторых задачах. |
| Жизненный цикл удаленного оператора | В документации упоминается прекращение работы сервиса удаленного оператора и альтернативы для самостоятельного развертывания. | Проверяйте текущий статус сервиса, прежде чем полагаться на размещенные удаленные операторы. |
| Смещение координат | В Issue #1876 сообщается о смещении маркера клика на macOS Tahoe 26. | GUI-агентам требуется проверка координат, специфичная для платформы. |
| Фокус окна | В Issue #1864 сообщается, что десктопное приложение выводит себя на передний план перед выполнением операций. | Поведение фокуса может нарушить автоматизацию целевого приложения. |
| Отчеты по безопасности | В Issue #1854 обсуждается внедрение описания инструментов и санитайзинг вывода. | Рассматривайте усиление безопасности как активную область работы. |
| Путаница при настройке | В Issue #1851 задается вопрос, достаточно ли развертывания/конфигурации модели. | Настройку модели, приложения и оператора следует проверять в комплексе. |
| Шлюзы одобрения | PR #1909 добавляет шлюз одобрения безопасности команд. | Средства контроля безопасности проходят через PR. |
8. Заметки о производительности, масштабировании и стоимости
Производительность для UI-агентов — это не только скорость токенов. Это цикл от скриншота к рассуждению модели, предсказанию действия и обратной связи UI. Важны задержка, разрешение экрана, отзывчивость целевого приложения и визуальная точность модели.
Удаленные операторы добавляют еще одно измерение: сетевую задержку и состояние удаленной среды. Удаленный браузер или компьютер может быть проще изолировать в песочнице, но сложнее сделать отзывчивым.
MCP может повысить производительность, заменяя попиксельные операции типизированными вызовами инструментов. Например, создание диаграммы через MCP сервер должно быть надежнее, чем ручное выполнение действий в интерфейсе электронной таблицы.
9. Для кого это
| Используйте, если | Пропустите, если |
|---|---|
| Вы экспериментируете с мультимодальными GUI агентами и операторами браузера/компьютера. | Вам нужен консервативный корпоративный RPA продукт с фиксированными релизами и SLA поддержкой. |
| Вы хотите использовать открытый стек на базе UI-TARS, Agent TARS, MCP, CLI и Web UI. | Вам нужно только headless-скриптинг браузера через Playwright. |
| Вы можете протестировать действия в изолированных приложениях (sandboxed apps), прежде чем предоставлять полный доступ к рабочему столу. | Вы не готовы мириться с периодическими проблемами с координатами, фокусом или настройкой провайдеров. |
| Вы хотите изучить, как работают потоки событий и проектирование мультимодального контекста. | Вам нужно упакованное десктопное приложение, запускаемое одной командой, без необходимости настройки модели. |
10. Сигнал сообщества
В репозитории большой объем issue и PR, включая запросы сообщества на поддержку провайдеров, ясность в упаковке десктопной версии, поведение удаленного/браузерного оператора, направления развития для мобильных устройств/iOS, усиление безопасности и выполнение задач с подтверждением.
Самый важный технический сигнал заключается в том, что контрибьюторы не просто просят новые функции; они продвигают идеи защитных барьеров, проверок безопасности, поддержки провайдеров, планировщика задач и выполнения с приоритетом симуляции.
Главное предостережение: GUI агенты могут давать сбои там, где текстовые агенты работают стабильно: масштабирование экрана, фокус, профили браузера, разрешения и сообщения о «черном экране» — все это влияет на удобство использования.
11. Вердикт: стоит ли использовать?
Наш вывод
Используйте UI-TARS Desktop и Agent TARS, если хотите изучить серьезные мультимодальные агенты для работы с компьютером с открытым исходным кодом и можете изолировать рабочий процесс. Не используйте их для критически важной автоматизации рабочего стола без присмотра, пока не проверите настройку модели, точность кликов, барьеры разрешений и безопасность MCP в вашей конкретной среде.
12. Общая картина
UI-TARS Desktop находится в той же категории, что и browser-use, агенты для работы с компьютером и мультимодальные операторские фреймворки, но он необычайно широк, так как объединяет модели, десктопное приложение, CLI, Web UI, MCP, потоки событий и удаленное управление.
Более масштабный сдвиг заключается в том, что агенты становятся операционными средами, а не просто помощниками в написании кода. Как только модель может видеть рабочий стол и взаимодействовать с ним, инженерная проблема сводится к управлению разрешениями, наблюдаемости, откатам и проверке человеком.
13. Частые вопросы
В: В чем разница между Agent TARS и UI-TARS Desktop?
Agent TARS — это более широкий мультимодальный агентский стек с CLI/Web UI. UI-TARS Desktop — это нативное GUI агентское приложение для локального, удаленного управления компьютером и работы в браузере.
В: Нужно ли мне развертывать собственную модель?
Это зависит от выбранного вами пути. Agent TARS может работать с настроенными провайдерами моделей; UI-TARS Desktop ожидает настройки OpenAI-compatible VLM эндпоинта, такие как провайдер, base URL, API key и имя модели.
В: Использует ли он MCP?
Да. В README указано, что ядро Agent TARS построено на MCP и поддерживает подключение MCP серверов для интеграции реальных инструментов.
В: Безопасно ли позволять ему управлять моим компьютером?
Только при использовании песочницы (sandboxing), тщательной настройке разрешений и проверке человеком. Недавние PR, касающиеся подтверждения команд и проверок безопасности, показывают, что это актуальная проблема.
В: Почему GUI агенты сложно сделать надежными?
Они зависят от скриншотов, масштабирования, фокуса, сопоставления координат, состояния приложения, профилей браузера и визуального мышления модели, каждое из которых может варьироваться в зависимости от платформы.
В: Какой релиз мне проверить?
Используйте актуальную документацию и страницу релизов вместе. Последним проверенным релизом был v0.3.0 от ноября 2025 года, в то время как v0.2.4 содержал бинарные файлы для десктопа, а работа над issue/PR продолжалась в 2026 году.
14. Глоссарий
| Область | Детали | Почему это важно |
|---|---|---|
| GUI агент | Агент, который управляет графическим интерфейсом посредством наблюдения за экраном и выполнения действий. | Основная категория UI-TARS Desktop. |
| Визуальное заземление (Visual grounding) | Сопоставление пикселей экрана с целевыми элементами UI. | Критически важно для точности кликов/ввода. |
| MCP | Model Context Protocol. | Протокол инструментального сервера, подключенный через Agent TARS. |
| Оператор | Режим управления для локального компьютера, удаленного компьютера или браузера. | Уровень действий. |
| Поток событий | Структурированный поток событий агента/инструмента/среды выполнения. | Полезно для отладки и UI агента. |
| VLM | VLM. | Класс моделей, который считывает скриншоты и текст. |
15. Все источники и ссылки
Основные источники
Issues и PR
Внутренние ссылки
16. Таблица атрибуции источников
| Область | Детали | Почему это важно |
|---|---|---|
| README | Концепция двух проектов, функции Agent TARS, функции UI-TARS Desktop, команды установки. | Первичный источник. |
| Документация | Быстрый старт, настройка провайдера/модели, руководство по CLI/Web UI. | Первичный источник. |
| Список релизов | Время выпуска v0.3.0. | Источник актуальности. |
| Issues | Упаковка, настройка, координаты, фокус и предостережения по безопасности. | Сигнал сообщества. |
| PR | Шлюзы одобрения, усиление безопасности, провайдеры, запланированные задачи. | Сигнал активной разработки. |
Get the Ultimate Antigravity Cheat Sheet
Join 5,000+ developers and get our exclusive PDF guide to mastering Gemini 3 shortcuts and agent workflows.
Related Guides
Humanizer Skill Guide
blader/humanizer: 29 AI-writing patterns, voice calibration, and a two-pass audit, all in one Claude Code skill.
Guides & FeaturesMastering Agent Skills
The open standard for portable AI agent expertise.
Guides & FeaturesAntigravity Workflows Guide
Create automation recipes with Turbo Mode and AgentKit 2.0.
Guides & FeaturesHow to Change Antigravity Themes
Customize themes, dark mode, icons, and color schemes.
Guides & FeaturesHow to Change Language
Switch Antigravity to Spanish, German, Japanese, and more.
Guides & FeaturesAntigravity Security Guide
Known vulnerabilities, safe settings, and hardening steps.
