Repolode
droidrun

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. 1

    uv로 CLI를 설치하세요

    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"

사용 전 알아둘 점

  • 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 통계는 매일 갱신됩니다.

관련 프로젝트