ARTEMIS 배너

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

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

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

주요 하이라이트

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

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

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

1. 프롬프트 입력 (작업 디스패치) _{Antigravity에서 테스트 시나리오와 목표 지표를 설명하세요}	2. 테스트 계획 생성 _{검토를 위한 단계별 테스트 계획 및 아키텍처를 수립합니다}
3. 자율 테스트 실행 _{실제 기기를 제어하고 UI를 탐색하며 성능을 프로파일링합니다}	4. 최종 보고서 _{구조화된 감사 결과, 지표 표, 원시 데이터셋을 제공합니다}

빠른 시작

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.

Codex / Antigravity / Claude Code / Windsurf용 MCP 설정 (클릭하여 펼치기)

ARTEMIS에는 네이티브 Model Context Protocol (MCP) 서버가 포함되어 있습니다. 실제 휴대폰을 AI IDE에 직접 연결하세요:

1. 원클릭 자동 설치 (권장)

./start.sh(macOS/Linux) 또는 .\start.bat(Windows PowerShell)을 실행하면 감지된 IDE에 대한 전역 MCP 및 테스트 규칙을 구성하라는 메시지가 표시됩니다(또는 아래 명령을 사용하여 나중에 언제든지 수동으로 설치/업데이트할 수 있습니다):

# 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 run artemis init를 통해 최초 설정 시 MCP를 대화형으로 구성할 수도 있습니다. 프로 팁: 모든 디렉터리에서 uv run 없이 artemis 명령을 전역으로 사용하려면, 프로젝트 루트에서 uv tool install -e .를 한 번 실행하세요.

2. 수동 구성 (선택 사항)

수동으로 구성하는 것을 선호하는 경우, uv run artemis mcp --generate-config <client>(예: codex 또는 antigravity)를 실행하여 적절한 TOML 또는 JSON 스니펫을 출력하세요. /path/to/artemis를 실제 저장소 경로로 바꾸고 command가 .venv Python 실행 파일을 가리키도록 설정하세요:

Codex (~/.codex/config.toml):

[mcp_servers.artemis]
command = "/path/to/artemis/.venv/bin/python"
args = ["-m", "mcp_server"]
cwd = "/path/to/artemis"

[mcp_servers.artemis.env]
PYTHONUNBUFFERED = "1"
PYTHONPATH = "/path/to/artemis"

Antigravity (~/.gemini/jetski/mcp_config.json):

{
  "mcpServers": {
    "artemis": {
      "command": "/path/to/artemis/.venv/bin/python",
      "args": ["-m", "mcp_server"],
      "cwd": "/path/to/artemis",
      "env": {
        "PYTHONUNBUFFERED": "1"
      },
      "tools": {
        "mobile_run_task": { "eager": true },
        "mobile_manage_task": { "eager": true },
        "mobile_get_device_state": { "eager": true },
        "mobile_inspect_trace": { "eager": true },
        "mobile_diagnose": { "eager": true }
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "artemis": {
      "command": "/path/to/artemis/.venv/bin/python",
      "args": ["-m", "mcp_server"],
      "cwd": "/path/to/artemis"
    }
  }
}

3. AI 에이전트를 위한 행동 규칙 마운트 (강력 권장)

AI 코딩 어시스턴트가 시니어 모바일 테스트 엔지니어의 엄격함으로 행동하고 UI 상호작용을 절대 환각하지 않도록, 전용 테스트 사고방식 규칙 파일을 mcp_server/rules.md에 제공합니다(코딩 전 능동적 탐색, Flash vs. Pro 라우팅 전략, 지연 및 타이밍 보정, 그리고 "동적 우선, 좌표 폴백" 로케이터 패턴을 다룹니다).

artemis

인기