Permite que agentes de IA, como Claude Code ou Codex, leiam a tela e toquem, digitem e deslizem em um iPhone real via USB ou Wi-Fi usando MCP.
onehumanbeing/esp32-iphone-agent
Permite que um modelo de visão com IA opere um iPhone real usando uma placa ESP32-S3 de US$ 7, que funciona como receptor de tela AirPlay e mouse USB HID, sem precisar de um computador durante a execução.
- Estrelas
- 3,240
- Forks
- 428
- Issues abertas
- 14
- Último commit
- há 15 horas
O que é?
O ESP32 iPhone Agent é um sistema que permite a um modelo de IA controlar um iPhone físico. A placa ESP32-S3 funciona como receptor AirPlay, espelhando a tela do celular por Wi-Fi, e também é reconhecida pelo iPhone como um mouse e teclado USB padrão. Um app para iPhone no mesmo dispositivo decodifica o fluxo espelhado, envia capturas de tela para um modelo de visão compatível com OpenAI e executa toques, deslizes, digitação e pressionamentos de teclas com base nas respostas do modelo.
O projeto é voltado a configurações em que não há um Mac, uma conta de desenvolvedor ou jailbreak disponível. É preciso usar um Mac com Xcode uma vez para gravar o firmware da placa e compilar o app, mas não para executar o agente. Cada execução fica salva no celular para ser reproduzida passo a passo, e os rastros podem ser exportados para análise por outro agente.
O projeto usa a licença MIT, com exceção de um componente de firmware adaptado do UxPlay, que usa GPL-3.0. Os requisitos incluem iOS 18 ou posterior e dados celulares, pois o Wi-Fi do celular fica ocupado pelo hotspot da placa enquanto o agente está em execução.
Recursos principais
- 01Recebe a tela do iPhone pelo Espelhamento de Tela do AirPlay, com o H.264 enviado ao app por BLE.
- 02Funciona como mouse e teclado USB HID, usando o AssistiveTouch para toques e deslizes com o ponteiro.
- 03Funciona com qualquer modelo de visão compatível com OpenAI, incluindo servidores auto-hospedados como vLLM e Ollama.
- 04Executa etapas de planejamento e ação em segundo plano e pausa ou retoma quando a placa ou a conexão de espelhamento cai.
- 05Salva cada execução para reprodução passo a passo e exportação de capturas de tela e ações.
Casos de uso
- Prototipar um agente de IA que opera apps iOS sem precisar de um Mac ou de uma conta de desenvolvedor.
- Automatizar tarefas repetitivas em um iPhone seu, como definir alarmes ou alterar ajustes.
- Pesquisar agentes que interagem com computadores em um dispositivo físico, em vez de um simulador.
- Coletar rastros de interações com o celular para análise por outro agente.
Tópicos
Perguntas frequentes
- O que é esp32-iphone-agent?
- Permite que um modelo de visão com IA opere um iPhone real usando uma placa ESP32-S3 de US$ 7, que funciona como receptor de tela AirPlay e mouse USB HID, sem precisar de um computador durante a execução. O ESP32 iPhone Agent é um sistema que permite a um modelo de IA controlar um iPhone físico. A placa ESP32-S3 funciona como receptor AirPlay, espelhando a tela do celular por Wi-Fi, e também é reconhecida pelo iPhone como um mouse e teclado USB padrão. Um app para iPhone no mesmo dispositivo decodifica o fluxo espelhado, envia capturas de tela para um modelo de visão compatível com OpenAI e executa toques, deslizes, digitação e pressionamentos de teclas com base nas respostas do modelo.
- esp32-iphone-agent é gratuito? Qual é a licença?
- esp32-iphone-agent é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- esp32-iphone-agent ainda é mantido?
- Manutenção ativa. O último commit de esp32-iphone-agent foi em 19 de out. de 2026.
- Para que posso usar esp32-iphone-agent?
- Prototipar um agente de IA que opera apps iOS sem precisar de um Mac ou de uma conta de desenvolvedor. Automatizar tarefas repetitivas em um iPhone seu, como definir alarmes ou alterar ajustes. Pesquisar agentes que interagem com computadores em um dispositivo físico, em vez de um simulador. Coletar rastros de interações com o celular para análise por outro agente.
- Onde consigo esp32-iphone-agent?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/onehumanbeing/esp32-iphone-agent
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Framework para uso autônomo de Android e computadores, que permite a um LLM planner e a um finder operar celulares e desktops a partir de tarefas em linguagem natural.
Um agente de IA que controla o Windows pela interface gráfica, lendo a árvore de UI Automation e deixando qualquer LLM escolher cliques, digitação e comandos.
App nativo para macOS que cria monitores virtuais por software, permitindo que agentes de IA visual trabalhem em apps enquanto os monitores físicos ficam desligados.
Colega de trabalho de IA open source para desktop, que conclui tarefas do dia a dia e revisões de segurança usando suas próprias chaves de modelo e ações sujeitas a aprovação.
Plugin para Codex, WorkBuddy e Doubao que permite a um assistente de IA operar um iPhone real via USB usando WebDriverAgent, com prévia da tela ao vivo.