기존 소프트웨어용 에이전트 친화적인 CLI를 생성하고, 바로 설치할 수 있는 CLI를 등록하는 CLI-Hub 툴킷입니다.
droidrun/mobilerun
LLM 에이전트가 자연어, CLI 또는 Python API로 Android와 iOS 기기를 제어할 수 있도록 하는 오픈소스 Python 프레임워크입니다.
- 스타
- 9,708
- 포크
- 1,034
- 열린 이슈
- 28
- 마지막 커밋
- 4일 전
어떤 프로젝트인가요?
Mobilerun은 대규모 언어 모델 에이전트가 모바일 기기를 조작할 수 있도록 하는 프레임워크입니다. 설정을 열어 다크 모드를 켜는 것과 같은 자연어 지시를 받으면 에이전트가 기기의 UI 상태를 읽고, 필요한 경우 스크린샷을 확인한 뒤 작업이 끝날 때까지 탭, 스와이프, 텍스트 입력을 단계별로 수행합니다.
이 프레임워크는 OpenAI, Anthropic, Gemini, xAI, Ollama, DeepSeek, OpenRouter 등 다양한 LLM 제공업체와 OpenAI 호환 엔드포인트를 지원합니다. 단발성 작업과 기기 점검을 위한 CLI, 반복 가능한 환경을 위한 Docker, 사용자 지정 도구와 구조화된 출력을 활용해 워크플로를 구성할 수 있는 Python API를 제공합니다. Android는 ADB를 통해 연동되는 companion Portal 앱으로 제어하며, iOS는 별도의 설정 절차를 통해 지원합니다.
선택 모드를 사용하면 접근성 데이터가 없는 앱을 스크린샷만으로 제어할 수 있고, 긴 작업에서는 계획과 실행을 분리하는 추론 모드를 사용할 수 있습니다. 또한 Arize Phoenix 또는 Langfuse를 통한 트레이싱도 지원합니다.
핵심 기능
- 01자연어 명령으로 Android 및 iOS 기기를 제어합니다
- 02OpenAI, Anthropic, Gemini, Ollama, DeepSeek 및 기타 OpenAI 호환 모델과 연동합니다
- 03접근성 트리와 스크린샷을 함께 사용하거나 스크린샷 전용 모드로 작동합니다
- 04사용자 지정 도구를 지원하는 CLI, Docker 이미지, Python API를 제공합니다
- 05다단계 계획을 위한 추론 모드와 Phoenix 또는 Langfuse를 통한 실행 트레이싱을 지원합니다
활용 사례
- 일반 문장으로 작성한 테스트 단계에 따라 모바일 앱 QA 및 회귀 테스트를 수행합니다
- 한 대 이상의 휴대폰에서 반복 작업을 자동화합니다
- API가 없는 네이티브 모바일 앱에서 데이터를 추출합니다
- Python API를 사용해 스크립트나 예약 작업으로 모바일 워크플로를 실행합니다
빠른 시작
- 1
uv로 CLI를 설치하세요
uv tool install mobilerun - 2
Portal 앱을 설치하고 Android 기기에서 접근성 서비스를 활성화하세요(ADB 및 USB 디버깅 필요)
mobilerun setup - 3
LLM 제공업체를 설정하세요
mobilerun configure - 4
첫 자연어 작업을 실행하세요
mobilerun run "Open settings and turn on dark mode"
사용 전 알아둘 점
- LLM 제공업체의 유료 API 키 또는 로컬 모델 설정이 필요합니다.
- Python 3.14는 지원되지 않습니다. Python 3.11~3.13을 사용하세요.
- Android를 제어하려면 ADB와 USB 디버깅이 활성화된 기기가 필요합니다.
토픽
자주 묻는 질문
- mobilerun은(는) 무엇인가요?
- LLM 에이전트가 자연어, CLI 또는 Python API로 Android와 iOS 기기를 제어할 수 있도록 하는 오픈소스 Python 프레임워크입니다. Mobilerun은 대규모 언어 모델 에이전트가 모바일 기기를 조작할 수 있도록 하는 프레임워크입니다. 설정을 열어 다크 모드를 켜는 것과 같은 자연어 지시를 받으면 에이전트가 기기의 UI 상태를 읽고, 필요한 경우 스크린샷을 확인한 뒤 작업이 끝날 때까지 탭, 스와이프, 텍스트 입력을 단계별로 수행합니다.
- mobilerun은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- mobilerun은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- mobilerun은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. mobilerun의 마지막 커밋은 2026년 10월 16일입니다.
- mobilerun은(는) 어디에 사용할 수 있나요?
- 일반 문장으로 작성한 테스트 단계에 따라 모바일 앱 QA 및 회귀 테스트를 수행합니다 한 대 이상의 휴대폰에서 반복 작업을 자동화합니다 API가 없는 네이티브 모바일 앱에서 데이터를 추출합니다 Python API를 사용해 스크립트나 예약 작업으로 모바일 워크플로를 실행합니다
- mobilerun는 어떻게 설치하나요?
- uv로 CLI를 설치하세요: 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를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
AI 코딩 어시스턴트와 테스트 스위트를 위한 자연어 기반 Android 자동화. 실제 기기와 에뮬레이터에서 실행
AI 에이전트와 워크플로를 시각적으로 구축하고 테스트·배포하며, API와 MCP 서버로 바로 노출할 수 있는 플랫폼입니다.
역할 기반 자율 AI 에이전트(Crews)와 이벤트 기반 워크플로(Flows)를 오케스트레이션하는 오픈 소스 Python 프레임워크입니다.
AI 에이전트에 1,000개 이상의 사전 인증 앱 툴킷, 사용자별 세션, 작업 실행용 샌드박스를 제공하는 TypeScript 및 Python SDK입니다.
스토리 아이디어, 각본, 소설을 대본·스토리보드·캐릭터·영상 생성 에이전트의 협업으로 여러 장면의 영상으로 만드는 에이전트형 영상 생성 프레임워크입니다.