google/artemis

What it is

ARTEMIS turns natural-language instructions into Android automation, running workflows across apps on real phones or emulators. It offers a web console, a developer CLI, a Python SDK, and a native MCP server so AI IDEs such as Antigravity, Claude Code, Codex, and Windsurf can drive devices and collect Logcat output and screenshots. It has two execution profiles, Flash (fast reactive) and Pro (planning and verification).

Who it's for

• Developers who want AI coding assistants to test apps on real Android devices through MCP
• QA and test engineers automating end-to-end, exploratory, or long-running stability tests
• Teams integrating device automation into pytest or CI/CD pipelines via the Python SDK

Requirements

Setup

1. Clone and launch on macOS/Linux

   Connect a device or emulator, then clone the repo and run the one-click startup script. It installs toolchains and offers to install the global MCP server and agent rules into detected AI IDEs.

   bashCopy

   git clone https://github.com/google/artemis.git && cd artemis
   ./start.sh

2. Clone and launch on Windows PowerShell

   Use .\start.bat in PowerShell. In Command Prompt, use start.bat instead.

   powershellCopy

   git clone https://github.com/google/artemis.git
   cd artemis
   .\start.bat

3. Install the MCP server for an IDE

   Install the MCP server and global rules for Antigravity, or for all supported AI IDEs.

   bashCopy

   uv run artemis mcp --install antigravity
   
   uv run artemis mcp --install all

4. Install the Python SDK client

   Install the zero-runtime-dependency client on the development machine. ADB, agents, models, and image processing stay on the device host.

   powershellCopy

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

Examples

uv run artemis run "Open Settings, find Battery and tell me current level" --profile flash

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())

Build the latest changes into an APK, install it on the connected device, open the login screen with a test account, verify if there are any unexpected popups after login, and return screenshots of the final page.

Pros & cons

Images