google /artemis

ARTEMIS turns natural-language instructions into reliable Android automation. It automates end-to-end workflows, captures logs, and integrates seamlessly with AI coding assistants such as Antigravity, Codex, and Claude Code. It also achieves 99%+ success rate on AndroidWorld Benchmark.

★ 17,477⑂ 1,946👁 230⑃ 158● 80▤ 0
PythonApache-2.0Created 2026-08-13
+32
Daily
+419
Weekly
17,477
stars
1,946
forks
230
watchers
158
prs
80
issues
0
releases

README

Let AI assistants and test suites use real phones like a human.



  English •
  中文文档 •
  Workflow Showcase •
  Quick Start •
  MCP for IDEs •
  Benchmarks •
  Discord Community



  
  
  
  
  




  
  
  Live Demo: Setup driving routes and calculate total durations in Google Maps, then open YouTube to play a Coldplay song.


 Key Highlights

 Cross-App Automation: Executes testing workflows and everyday tasks on Android from natural language instructions.
 Multimodal Targeting: Uses element indices when available, with coordinate and visual locating fallbacks for custom interfaces.
 IDE Diagnostics: Model Context Protocol (MCP) integration lets Antigravity, Claude Code, and Windsurf drive test devices and collect Logcat output and screenshots.
 Flash Execution: A reactive observe-and-act loop with asynchronous history summaries, typically 3–5s per step.
 Pro Exploration: Checks targets before individual actions and returns blocked actions to the Operator for recovery. Supports long-running exploratory and stability tests.
 AndroidWorld Results: 99%+ task completion on Google Research's AndroidWorld benchmark (100+ multi-step tasks).


 Antigravity × ARTEMIS: Autonomous Testing Workflow

Antigravity uses ARTEMIS through MCP to turn a test request into a plan, device execution, and a diagnostic report:


  
    
      1. Prompt Input (Task Dispatch)
      Describe your test scenario and target metrics in Antigravity
      
    
    
      2. Test Plan Generation
      Formulates a step-by-step test plan & architecture for review
      
    
  
  
    
      3. Autonomous Test Execution
      Drives real device, navigates UI, and profiles performance
      
    
    
      4. Final Report
      Delivers structured audit findings, metric tables, and raw datasets
      
    
  



 Quick Start

Ensure an Android device (with USB Debugging enabled) or emulator is connected. The one-click startup script will automatically:
- Install System Toolchains: Detect and auto-install ADB, scrcpy, FFmpeg, and Python (uv) dependencies.
- Mount Global MCP Server & AI Agent Rules: Prompt to automatically install global MCP configurations and the Artemis Mobile Testing Mindset (rules.md) into your AI IDEs (Antigravity, Cursor, Claude Code, Codex, Windsurf, VS Code, Cline/Roo, OpenClaw).

 macOS and Linux

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

 2. One-click launch
./start.sh


 Windows PowerShell

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

 2. One-click launch
.\start.bat


 PowerShell does not search the current directory for executable scripts by default, so use .\start.bat without a trailing \. In Command Prompt (CMD), use start.bat instead.

 Tip: Opens http://localhost:8000 in your default browser with a device connection wizard, live screen mirroring, prompt sandbox, and execution replays. You can also run directly from CLI:

Top issues

Discussions

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON