esp32-iphone-agent

An iPhone automation agent that uses an ESP32-S3 as an AirPlay screen receiver and USB mouse and keyboard, letting an OpenAI-compatible vision model observe and control a real iPhone without a Mac.

Browse open issues

Pick a small issue you can reproduce, then fix it with your AI coding agent.

Share on XLicense: MIT

Overview

ESP32 iPhone Agent lets an AI vision model operate a real iPhone through an ESP32-S3 board, without a Mac, developer account, or jailbreak. The board creates a Wi-Fi hotspot, receives the iPhone’s AirPlay screen stream, and acts as a USB mouse and keyboard. An app on the iPhone decodes the stream, sends screenshots to an OpenAI-compatible vision model, and performs actions such as tapping, swiping, and typing. Runs can be replayed and exported for review.

Key features

  • Creates a Wi-Fi hotspot and receives the iPhone’s AirPlay screen stream, forwarding it to the app over Bluetooth Low Energy.
  • Acts as a USB mouse and keyboard to control the iPhone with AssistiveTouch.
  • Uses an iPhone app to send screenshots to an OpenAI-compatible vision model and perform actions such as tapping, swiping, and typing.
  • Keeps run history for step-by-step replay and export of screenshots, actions, and annotations.

Best for

People who want to automate tasks on a real iPhone with a vision model and an ESP32-S3, without using a Mac. It is also useful for reviewing or exporting agent runs.

Upstream
onehumanbeing/esp32-iphone-agent
Fork on GitHub
Guo-astro/esp32-iphone-agent
Upstream stars
776
Category
AI agents and LLM tools
Language
C
License
MIT
Forked
2026-10-12
Sync status
Updated by last syncLast synced 2026-10-20