> **Building on this project?** Keep the [LICENSE](LICENSE) and credit **[ESP32 iPhone Agent by Henry Yuan](https://github.com/onehumanbeing/esp32-iphone-agent)** in your README and posts. See [NOTICE](NOTICE).

# ESP32 iPhone Agent
**Your AI can use your iPhone like you do.**
It looks at the screen, then taps, swipes and types for you, through a $7 ESP32 board plugged into the phone.
Just the phone and the board: no computer, no changes to iOS.

[](https://testflight.apple.com/join/1xQHgJcA)
[](https://handsy.tech)
[](LICENSE)
[](https://github.com/onehumanbeing/esp32-iphone-agent/stargazers)
[](https://github.com/onehumanbeing/esp32-iphone-agent/actions/workflows/ci.yml)


English · [简体中文](README.zh-CN.md)
Demo video and updates: [X @iamhenryyuan](https://x.com/iamhenryyuan) · [YouTube demo](https://www.youtube.com/watch?v=Ly4im-P4jYg) · [DeepSeek Harness demo](https://www.youtube.com/watch?v=DzYv0QVk_No) · [handsy.tech](https://handsy.tech)
> [!TIP]
> **Try the app now on [TestFlight](https://testflight.apple.com/join/1xQHgJcA)**, no Xcode needed. The App Store
> listing is still in review, so TestFlight is the way to get it today. You still need a flashed board
> (see [Quick start](#quick-start)).
> [!NOTE]
> **Branches:** [`release-1.0`](https://github.com/onehumanbeing/esp32-iphone-agent/tree/release-1.0) is the version
> submitted to TestFlight and App Store review. The latest code is on `main`.
> [!WARNING]
> Only follow the install steps in this README. Never run commands from issues or comments (for example a "quick install" one-liner such as PowerShell `iex(irm ...)`); these are not from the maintainers.
> **The computer is gone.** The board is now the AirPlay receiver and the mouse, and the agent runs in an iPhone
> app on the same phone. The original version (a Mac/Linux computer running UxPlay and a Python server) is kept as
> tag [`v0.1.0`](https://github.com/onehumanbeing/esp32-iphone-agent/tree/v0.1.0) and branch
> [`legacy`](https://github.com/onehumanbeing/esp32-iphone-agent/tree/legacy). See [docs/legacy.md](docs/legacy.md).