artemis

Permita que assistentes de IA e suítes de teste usem celulares reais como um humano.

English • 中文文档 • Vitrine de Fluxos de Trabalho • Início Rápido • MCP para IDEs • Benchmarks • Comunidade no Discord

Demonstração ao Vivo: Configurar rotas de deslocamento e calcular durações totais no Google Maps, depois abrir o YouTube para tocar uma música do Coldplay.

Destaques Principais

• Automação entre Aplicativos: Executa fluxos de teste e tarefas cotidianas no Android a partir de instruções em linguagem natural.
• Segmentação Multimodal: Usa índices de elementos quando disponíveis, com alternativas de localização por coordenadas e visual para interfaces personalizadas.
• Diagnóstico em IDEs: A integração com o Model Context Protocol (MCP) permite que Antigravity, Claude Code e Windsurf controlem dispositivos de teste e coletem saída do Logcat e capturas de tela.
• Execução Flash: Um loop reativo de observar e agir com resumos assíncronos do histórico, tipicamente 3–5s por passo.
• Exploração Pro: Verifica os alvos antes de cada ação individual e devolve ações bloqueadas ao Operador para recuperação. Suporta testes exploratórios e de estabilidade de longa duração.
• Resultados no AndroidWorld: 99%+ de conclusão de tarefas no benchmark AndroidWorld do Google Research (mais de 100 tarefas de múltiplos passos).

Antigravity × ARTEMIS: Fluxo de Teste Autônomo

O Antigravity usa o ARTEMIS por meio do MCP para transformar uma solicitação de teste em um plano, execução no dispositivo e um relatório de diagnóstico:

1. Entrada do Prompt (Despacho de Tarefa) Descreva seu cenário de teste e métricas-alvo no Antigravity	2. Geração do Plano de Teste Formula um plano de teste passo a passo e uma arquitetura para revisão
3. Execução Autônoma do Teste Controla o dispositivo real, navega pela interface e analisa o desempenho	4. Relatório Final Entrega descobertas de auditoria estruturadas, tabelas de métricas e conjuntos de dados brutos

Início Rápido

Certifique-se de que um dispositivo Android (com Depuração USB ativada) ou emulador esteja conectado. O script de inicialização com um clique irá automaticamente:

• Instalar Toolchains do Sistema: Detectar e instalar automaticamente as dependências ADB, scrcpy, FFmpeg e Python (uv).
• Montar Servidor MCP Global e Regras do Agente de IA: Solicitar a instalação automática das configurações globais do MCP e do Artemis Mobile Testing Mindset (rules.md) em suas IDEs de IA (Antigravity, Cursor, Claude Code, Codex, Windsurf, VS Code, Cline/Roo, OpenClaw).

macOS e 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

O PowerShell não procura scripts executáveis no diretório atual por padrão, portanto use .\start.bat sem uma barra invertida no final. No Prompt de Comando (CMD), use start.bat em vez disso.

Dica: Abre http://localhost:8000 no seu navegador padrão com um assistente de conexão de dispositivo, espelhamento de tela ao vivo, sandbox de prompt e replays de execução. Você também pode executar diretamente pela 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