droidrun/mobilerun

Automate your mobile devices with natural language commands - an LLM agnostic mobile Agent 🤖

What it solves

Mobilerun 은 자연어 명령으로 Android 및 iOS 기기를 제어하는 방법을 제공합니다. 모바일 상호작용을 수동으로 스크립팅할 필요가 없어지고, LLM 에이전트가 앱을 탐색하고 다단계 워크플로를 수행하며 모바일 인터페이스에서 데이터를 추출할 수 있습니다.

How it works

이 프레임워크는 기기에 설치된 "Portal" 앱을 사용해 LLM과 모바일 OS 사이의 다리를 놓습니다. 접근성 트리(UI 상태)와 스크린샷을 결합해 시각적 이해를 제공하며, 에이전트가 탭, 스와이프, 입력을 할 수 있게 합니다. 사용자는 CLI, Python API, Docker 중 하나를 통해 시스템과 상호작용할 수 있으며, OpenAI, Anthropic, Gemini 등 다양한 LLM 제공자를 선택할 수 있습니다. 복잡한 작업을 위해 "추론 모드"를 제공하며, 매니저‑실행자 계획 아키텍처를 사용합니다.

Who it’s for

  • QA Engineers: 모바일 앱 테스트 및 회귀 검증에.
  • Developers: Python을 통해 맞춤형 모바일 자동화 워크플로를 구축하려는 경우.
  • Automation Enthusiasts: 반복적인 모바일 작업을 자동화하거나 네이티브 앱에서 데이터를 추출하려는 경우.
  • Non-technical Users: 간단한 프롬프트로 가이드된 모바일 워크플로를 실행하려는 경우.

Highlights

  • Cross-Platform: Android와 iOS 기기를 모두 지원합니다.
  • Multimodal Input: 접근성 트리와 비전 기반 스크린샷 분석을 결합합니다.
  • Flexible Execution: 빠른 작업을 위한 CLI와 깊은 통합을 위한 Python API를 제공합니다.
  • Reasoning Mode: 복잡하고 다단계 계획을 가능하게 하여 정교한 자동화를 구현합니다.
  • Broad Model Support: OpenAI, Anthropic, Gemini, Ollama, DeepSeek, OpenRouter와 호환됩니다.