onehumanbeing/esp32-iphone-agent
Let an AI model use a real iPhone with a $7 ESP32: AirPlay eyes, USB HID hands, any OpenAI-compatible vision model. No Mac, no developer account, no jailbreak.
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
Let an AI model use a real iPhone with a $7 ESP32. Just the phone and the board: no computer, no jailbreak. English · 简体中文 Demo video and updates: X @iamhenryyuan · YouTube demo [](https://github.com/onehumanbeing/esp32-iphone-agent/actions/workflows/ci.yml) [](LICENSE) "Set an alarm for 8:00 AM that repeats every Monday and Tuesday, then save it": the agent leaves its own app, opens Clock, types the time into the wheel, ticks the days and saves. (Photo from v0.1.0; the task is the same.) Left: the real phone. Right: what the agent sees through the board's AirPlay mirror. The second shot is the pointer calibration. list as ESP32 Agent. It keeps the H.264 stream (no decoding on the board) and forwards it to the app over BLE. The phone keeps using cellular data for the model while it is on the board's hotspot. on-screen pointer, so a click is a tap and a drag is a…
Read the full README ↗ · Preview checked 2026-10-28T04:37:51.355Z
Inside the original README — Document outline
- ESP32 iPhone Agent
- How it works
- Hardware
- Quick start
- 1. Flash the board (plugged into the Mac)
- 2. Install the app
- 3. Set up (once, in the app)
- 4. Give it a task
- Model and prompts
- Project layout
- Roadmap
- Limitations
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
Let an AI model use a real iPhone with a $7 ESP32: AirPlay eyes, USB HID hands, any OpenAI-compatible vision model. No Mac, no developer account, no jailbreak.
Repository facts
- Owner
- onehumanbeing
- Primary language
- C
- Stars
- 4,143
- Forks
- 553
- Open issues + pull requests
- 16
- License
- MIT
- Archived
- No
- Default branch
- main
- Created
- 2026-10-11T19:10:25.000Z
- Last push
- 2026-10-28T07:40:06.000Z
Topics and intended use
Owner-supplied topics: ai-agent, airplay, automation, computer-use, esp32, esp32-s3, iphone, llm, usb-hid
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-10-31T12:18:20.650Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.