google / artemis

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
 [code] 
### Windows PowerShell
 [code] 
> 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: `uv run artemis run "Open Settings, find Battery and tell me current level" --profile flash`.
 MCP Setup for Codex / Antigravity / Claude Code / Windsurf (Click to expand) 
ARTEMIS includes a native **Model Context Protocol (MCP)** server. Connect your real phone directly into AI IDEs:
###