android-agent은(는) 무엇을 하나요?
ADB를 통해 Android 기기를 제어하는 Python 자동화 프레임워크로, 작업 실행과 전화기 팜 확장을 지원합니다.
개요
android-agent는 Python 기반의 자동화 프레임워크로, Android Debug Bridge(ADB)를 사용하여 여러 Android 기기를 제어합니다. 이를 통해 AI 에이전트가 단일 또는 다중 기기에서 작업을 실행하고, 전화기 팜을 효율적으로 관리할 수 있습니다.
주요 기능
- ADB 래퍼: 복잡한 ADB 명령어를 간단한 Python 함수 호출로 추상화합니다.
- 작업 실행: 사전 정의된 작업을 기기에서 자동으로 실행합니다.
- 팜 확장: 여러 기기를 동시에 제어하여 대규모 테스트 및 자동화를 지원합니다.
- 에이전트 통합: AI 코딩 도구(Claude Code, Cursor, Codex 등)와 원활하게 통합됩니다.
설치 방법
-
저장소를 클론합니다:
git clone https://github.com/Dynaevangelical2652/android-agent.git cd android-agent -
Python 종속성을 설치합니다:
pip install -r requirements.txt -
ADB가 설치되어 있고, 환경 변수
ANDROID_HOME이 올바르게 설정되었는지 확인합니다.
사용법
기본 사용
from android_agent import AndroidAgent
# 에이전트 초기화
agent = AndroidAgent()
# 기기 연결
device = agent.connect_device()
# 작업 실행
device.tap(100, 200)
device.swipe(300, 400, 500, 600)
다중 기기 제어
devices = agent.connect_all_devices()
for device in devices:
device.install_app("my_app.apk")
설정
환경 변수를 통해 동작을 구성할 수 있습니다:
ADB_PATH: ADB 실행 파일의 경로 (기본값:adb)DEVICE_TIMEOUT: 기기 연결 제한 시간 (초)TASK_RETRY: 작업 재시도 횟수
지원 플랫폼
- Android 5.0 (Lollipop) 이상
- macOS, Linux, Windows (ADB 지원 필요)
라이선스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다.