artemis

AI 어시스턴트와 테스트 스위트가 사람처럼 실제 휴대폰을 사용할 수 있게 합니다.

English • 中文文档 • 워크플로 쇼케이스 • 빠른 시작 • IDE용 MCP • 벤치마크 • Discord 커뮤니티

라이브 데모: Google Maps에서 경로를 설정하고 총 소요 시간을 계산한 뒤, YouTube를 열어 Coldplay 노래를 재생합니다.

주요 특징

• 크로스 앱 자동화: 자연어 지시로 Android에서 테스트 워크플로와 일상 작업을 실행합니다.
• 멀티모달 타겟팅: 사용 가능한 경우 요소 인덱스를 사용하며, 커스텀 인터페이스에는 좌표 및 시각적 위치 탐색을 대체 수단으로 활용합니다.
• IDE 진단: Model Context Protocol (MCP) 통합을 통해 Antigravity, Claude Code, Windsurf가 테스트 기기를 제어하고 Logcat 출력과 스크린샷을 수집할 수 있습니다.
• Flash 실행: 비동기 히스토리 요약을 사용하는 반응형 관찰-실행 루프로, 일반적으로 단계당 3–5초가 소요됩니다.
• Pro 탐색: 개별 작업 전에 대상을 확인하고, 차단된 작업을 Operator에 반환하여 복구합니다. 장시간 실행되는 탐색 및 안정성 테스트를 지원합니다.
• AndroidWorld 결과: Google Research의 AndroidWorld 벤치마크(100개 이상의 다단계 작업)에서 99%+ 작업 완료율을 달성했습니다.

Antigravity × ARTEMIS: 자율 테스트 워크플로

Antigravity는 MCP를 통해 ARTEMIS를 사용하여 테스트 요청을 계획, 기기 실행, 진단 보고서로 전환합니다:

빠른 시작

Android 기기(USB 디버깅 활성화) 또는 에뮬레이터가 연결되어 있는지 확인하세요. 원클릭 시작 스크립트가 자동으로 다음을 수행합니다:

• 시스템 툴체인 설치: ADB, scrcpy, FFmpeg, Python(uv) 의존성을 감지하고 자동 설치합니다.
• 글로벌 MCP 서버 및 AI 에이전트 규칙 마운트: 글로벌 MCP 구성과 **Artemis 모바일 테스트 마인드셋(rules.md)**을 AI IDE(Antigravity, Cursor, Claude Code, Codex, Windsurf, VS Code, Cline/Roo, OpenClaw)에 자동 설치하도록 안내합니다.

macOS 및 Linux

# 1. Clone repo & navigate to directory
git clone https://github.com/google/artemis.git && cd artemis

# 2. One-click launch
./start.sh

Windows PowerShell

# 1. Clone repo & navigate to directory
git clone https://github.com/google/artemis.git
cd artemis

# 2. One-click launch
.\start.bat

PowerShell은 기본적으로 현재 디렉터리에서 실행 가능한 스크립트를 검색하지 않으므로, 뒤에 \ 없이 .\start.bat을 사용하세요. 명령 프롬프트(CMD)에서는 대신 start.bat을 사용하세요.

팁: 기본 브라우저에서 http://localhost:8000을 열면 기기 연결 마법사, 실시간 화면 미러링, 프롬프트 샌드박스, 실행 리플레이를 사용할 수 있습니다. CLI에서 직접 실행할 수도 있습니다: uv run artemis run "Open Settings, find Battery and tell me current level" --profile flash.

# Auto-install MCP server & global rules for Antigravity / Jetski:
uv run artemis mcp --install antigravity

# Or install for all supported AI IDEs (including Codex):
uv run artemis mcp --install all

uv add "artemis-client @ git+https://github.com/google/artemis.git#subdirectory=packages/artemis-client"

import asyncio
from artemis_client import ArtemisClient


async def main():
    client = ArtemisClient(
        "http://artemis-host:8000",
        device_serial="emulator-5554",  # optional: target specific device serial
        default_profile="flash",  # "flash" (fast reactive) or "pro" (deep reasoning)
    )

    result = await client.run(
        "Open System Settings, go to 'Battery', verify battery percentage is displayed, and check for any crash dialogs.",
    )

    assert result.succeeded, f"Test failed: {result.error or result.status}"
    print(f"✅ Test Passed! Device: {result.device_serial} | Trace ID: {result.trace_id}")


if __name__ == "__main__":
    asyncio.run(main())

사용 모드

_{콘솔 개요: ① 뷰 전환기 (Home / Workspace) · ② 모델 및 리플레이 (Flash/Pro 상태 및 비디오 리플레이) · ③ 라이브 에이전트 스트림 (작업 인식, 대상 좌표 및 구조화된 결과) · ④ 프롬프트 독 (자연어 디스패치) · ⑤ 작업 큐 및 대시보드 (수명 주기 및 기록)}

• 웹 시각적 테스트 콘솔 (uv run artemis ui): 실시간 화면 투사 및 대화형 패널로, 자연어 테스트 디스패치, 라이브 추론 텔레메트리, 작업 궤적, 실행 리플레이를 지원합니다. 모든 터미널에서 uv run artemis restart, uv run artemis stop, uv run artemis status를 사용하여 언제든지 서버 수명 주기를 관리할 수 있습니다;
• MCP 서버: Antigravity, Claude Code, Windsurf 및 기타 MCP 클라이언트를 실제 기기에 연결하여 버그 재현 및 테스트 실행을 수행합니다;
• 개발자 CLI (uv run artemis run): 자동화된 테스트 케이스, 탐색적 안정성 검사 또는 AndroidWorld 벤치마크를 위한 직접 터미널 실행으로, 고충실도 구조화된 터미널 출력을 제공합니다;
• Python SDK: 강력한 타입의 Pydantic 구조화 출력과 어설션 지원을 통해 기존 자동화 테스트 프레임워크(예: pytest) 또는 CI/CD 파이프라인에 표준 Python 라이브러리로 통합됩니다.

ARTEMIS가 휴대폰에 설치하는 것

기기에서의 첫 번째 작업은 Artemis Accessibility Helper를 설치합니다. 이는 UiAutomation 연결을 차지하지 않고 화면 레이아웃을 읽는 작은 접근성 서비스입니다. UiAutomation을 사용하는 도구는 FLAG_DONT_SUPPRESS_ACCESSIBILITY_SERVICES를 활성화하지 않으면 이 헬퍼를 억제할 수 있습니다. 축소된 "Artemis test helper is running" 알림과 설정 > 접근성 아래의 새 항목이 표시됩니다. 둘 다 해당 헬퍼입니다. 이 헬퍼는 휴대폰 자체에서만 수신하며 다른 곳으로 아무것도 전송하지 않습니다.

• 미리 설치하기 (첫 번째 작업의 약 3초 지연 방지): uv run artemis helper install
• 검사하기: uv run artemis helper status / uv run artemis doctor
• 언제든지 제거하기: uv run artemis helper uninstall
• 대신 UIAutomator2 사용하기: .env에서 ARTEMIS_HIERARCHY_BACKEND=uiautomator
• 자동 설치 방지하기: .env에서 ARTEMIS_HELPER_AUTO_INSTALL=false

헬퍼가 작업 중간에 실패하면 ARTEMIS는 UIAutomator2로 대체하며, 작업 타임라인, mobile_manage_task 상태, 최종 보고서에 이를 명시합니다.

벤치마크: AndroidWorld (SOTA 99%+)

Artemis는 20개 이상의 앱과 100개 이상의 다단계 작업을 아우르는 Google Research의 벤치마크인 AndroidWorld에서 99%+ 완료율을 달성했습니다.

ARTEMIS의 아키텍처

• 실행 전 검사 및 작업 버스트: Pro는 개별 작업을 디스패치하기 전에 라이브 UI 트리와 픽셀에 대해 대상을 확인합니다. 작업 버스트는 또 다른 모델 턴을 기다리지 않고 일시적 컨트롤을 처리합니다.
• 요소 위치 탐색: 접근성 계층과 OCR을 시각 모델과 결합하여 커스텀 Canvas, Compose, Flutter 인터페이스를 처리합니다.
• 공유 히스토리 압축: Flash와 Pro는 오래된 스크린샷을 시각적 요약으로 대체하고 완료된 단계를 검색 가능한 히스토리 청크로 압축합니다. 컨텍스트 임계값이 원시 턴이 대체되는 시점을 제어합니다.

실행 프로필: Flash vs. Pro

ARTEMIS는 다양한 자동화 요구 사항에 맞춘 두 가지 실행 프로필을 지원합니다:

• Flash 프로필 (--profile flash): 빠르고 토큰 효율적인 반응형 루프(단계당 약 3–5초): 하나의 모델이 라이브 화면을 관찰하고, 사고하고, 행동하며, 그래프 오케스트레이션이 없습니다. 일상적이고 결정적인 UI 작업에 이상적입니다. 이 루프는 기본적으로 무제한입니다(agent.flash.max_turns, 0 = 무제한). 히스토리가 제한되는 대신 압축되기 때문입니다: Flash는 Pro 세션 트랜스크립트 원장(세션 기준 T+mm:ss 시계, 스크린샷이 시각적 요약으로 접히고, 오래된 단계가 시대별로 청크되어 search_history / replay_steps를 통해 필요 시 회상 가능)을 공유하며, video_analyzer를 통해 세션 녹화를 쿼리할 수 있습니다. 일시적 UI(자동으로 사라지는 컨트롤 바, 토스트)는 탭을 하나의 click_sequence로 연결하여 처리합니다. 제한 사항: 작업 계획이나 노트 없음, 실행 전 안전망 없음, 체크포인트 검증이나 최종 보고서 없음, ADB 셸 없음.
• Pro 프로필 (--profile pro): 계획 및 검증 워크플로(단계당 약 15–40초)로, 멀티 에이전트 그래프로 구축되었습니다. Planner는 마일스톤과 verify / assert 검사 항목이 포함된 살아있는 Markdown 작업 계획을 유지합니다. Operator는 전체 툴셋(Explorer 그라운딩 — flash / pro / 티어는 프로필별 사용자 설정으로, 의 / 또는 이며 에이전트가 선택하지 않음 — 노트, 히스토리 회상, 비디오 분석, ADB 진단)으로 이를 실행합니다. 모든 개별 작업은 실행 전 (XML 우선, 픽셀 대체)을 통과하며, 다중 작업 는 일시적 UI에서 턴 지연을 극복하기 위해 연속으로 발동됩니다. 차단되거나 실패한 작업은 를 열어 이후 작업이 성공할 때까지 Operator의 컨텍스트에 남으므로, 별도의 복구 에이전트 없이 Operator 자체가 복구를 처리합니다. 읽기 전용 는 계획 체크포인트를 검증하고 원래 목표에 대해 종료 최종 검토를 실행하며(: / (기본값) / / ), 계획 마일스톤 편집에는 권고 검토가 제공됩니다. 100단계 이상의 장기 워크플로, 모니터링, 선택적 서면 보고서를 처리합니다.

로드맵

• Android Studio 통합: Android Studio 내에서 직접 편집기 내 디버깅, 테스트 기록, 자동화된 기기 제어를 가능하게 하는 네이티브 IDE 플러그인 및 워크플로 통합.
• iOS 플랫폼 확장: 멀티모달 인식 및 모바일 자동화를 iOS 기기와 시뮬레이터로 확장.
• 온디바이스 경량 VLM: 저지연, 프라이버시 우선 자동화를 위한 경량 엣지 비전 모델을 통한 로컬 실행.
• 실시간 양방향 음성 상호작용: 실시간 대화형 제어 및 인터럽트 처리를 갖춘 음성 기반 작업 디스패치.

커뮤니티 및 기여

기여를 진심으로 환영합니다!

• 저장소에 Star를 눌러 업데이트와 릴리스를 팔로우하세요
• 기술 토론을 위해 Discord 커뮤니티에 참여하세요
• Issue를 열거나 Pull Request를 제출하세요

라이선스

이 프로젝트는 Apache License 2.0에 따라 라이선스가 부여됩니다.

이 프로젝트는 Minitap, Inc.가 개발한 소스 코드를 포함합니다.