Repolode
droidrun

droidrun/mobilerun

Фреймворк с открытым исходным кодом на Python, в котором LLM-агенты управляют устройствами Android и iOS с помощью естественного языка, CLI или Python API.

Звёзды
9,708
Форки
1,034
Открытые issues
28
Последний коммит
4 дня назад

Что это?

Mobilerun — это фреймворк, позволяющий LLM-агентам управлять мобильными устройствами. Получив инструкцию на естественном языке, например открыть настройки и включить тёмную тему, агент считывает состояние интерфейса устройства, при необходимости анализирует скриншоты и последовательно выполняет нажатия, свайпы и ввод текста, пока задача не будет завершена.

Фреймворк работает с разными провайдерами LLM, включая OpenAI, Anthropic, Gemini, xAI, Ollama, DeepSeek и OpenRouter, а также с совместимыми с OpenAI конечными точками. В нём есть CLI для разовых задач и проверки устройств, Docker для воспроизводимых окружений и Python API для создания пользовательских сценариев с собственными инструментами и структурированным выводом. Управление Android выполняется через сопутствующее приложение Portal по ADB, а для iOS предусмотрен отдельный процесс настройки.

Дополнительные режимы позволяют управлять приложениями только по скриншотам, если у них нет данных о доступности, разделять планирование и выполнение для более сложных задач, а также вести трассировку с помощью Arize Phoenix или Langfuse.

Ключевые возможности

  • 01Управляет устройствами Android и iOS с помощью команд на естественном языке
  • 02Работает с OpenAI, Anthropic, Gemini, Ollama, DeepSeek и другими моделями, совместимыми с OpenAI
  • 03Использует деревья доступности вместе со скриншотами или работает только по скриншотам
  • 04Предоставляет CLI, Docker-образ и Python API с поддержкой собственных инструментов
  • 05Поддерживает режим рассуждений для многоэтапного планирования и трассировку выполнения через Phoenix или Langfuse

Сценарии использования

  • QA мобильных приложений и регрессионное тестирование по инструкциям на естественном языке
  • Автоматизация повторяющихся задач на одном или нескольких телефонах
  • Извлечение данных из нативных мобильных приложений без API
  • Запуск мобильных сценариев по скриптам или расписанию через Python API

Быстрый старт

  1. 1

    Установите CLI с помощью uv

    uv tool install mobilerun
  2. 2

    Установите приложение Portal и включите службу специальных возможностей на устройстве Android (требуются ADB и отладка по USB)

    mobilerun setup
  3. 3

    Настройте провайдера LLM

    mobilerun configure
  4. 4

    Выполните свою первую задачу на естественном языке

    mobilerun run "Open settings and turn on dark mode"

Что важно знать

  • Требуется платный API-ключ провайдера LLM или настроенная локальная модель.
  • Python 3.14 не поддерживается; используйте Python 3.11–3.13.
  • Для управления Android нужны ADB и устройство с включённой отладкой по USB.

Темы

Частые вопросы

Что такое mobilerun?
Фреймворк с открытым исходным кодом на Python, в котором LLM-агенты управляют устройствами Android и iOS с помощью естественного языка, CLI или Python API. Mobilerun — это фреймворк, позволяющий LLM-агентам управлять мобильными устройствами. Получив инструкцию на естественном языке, например открыть настройки и включить тёмную тему, агент считывает состояние интерфейса устройства, при необходимости анализирует скриншоты и последовательно выполняет нажатия, свайпы и ввод текста, пока задача не будет завершена.
mobilerun можно использовать бесплатно? Какая у него лицензия?
mobilerun распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
mobilerun всё ещё поддерживается?
Активно поддерживается. Последний коммит в mobilerun — 16 окт. 2026 г..
Для чего можно использовать mobilerun?
QA мобильных приложений и регрессионное тестирование по инструкциям на естественном языке Автоматизация повторяющихся задач на одном или нескольких телефонах Извлечение данных из нативных мобильных приложений без API Запуск мобильных сценариев по скриптам или расписанию через Python API
Как установить mobilerun?
Установите CLI с помощью uv: uv tool install mobilerun Установите приложение Portal и включите службу специальных возможностей на устройстве Android (требуются ADB и отладка по USB): mobilerun setup Настройте провайдера LLM: mobilerun configure Выполните свою первую задачу на естественном языке: mobilerun run "Open settings and turn on dark mode"
Где скачать mobilerun?
Исходный код и инструкции по установке — на GitHub: https://github.com/droidrun/mobilerun

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Агентный фреймворк для создания видео: превращает идею, сценарий или роман в видео из нескольких сцен, координируя работу агентов по созданию сценария, раскадровки, персонажей и видео.

12,7 тыс.1,9 тыс.PythonMITОбновлён 20 дней назад