LibreAI / AI Agents / ESP32 iPhone Agent
// agents · onehumanbeing/esp32-iphone-agent

ESP32 iPhone Agent

ESP32 iPhone Agent — let an AI model use a real iPhone with a $7 ESP32: AirPlay eyes, USB HID hands, no computer, no jailbreak

★ 2.4k stars⑂ 322 forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

ESP32 iPhone Agent is an open-source ai agents project by onehumanbeing (onehumanbeing/esp32-iphone-agent on GitHub). It has 2,424 GitHub stars and 322 forks, is released under the MIT license, and was last updated on GitHub on 15 October 2026.

GitHub stars
2,424
Forks
322
License
MIT
Last updated on GitHub
15 October 2026
Category
AI Agents
Listing
Full install guide
Official site
GitHub repository
// how it works

How it works

  1. Flash the board

    Plug the ESP32-S3 into a Mac and run the project’s flash script, which applies the required BLE buffer configuration.

  2. Build the app once

    Build the ESP32 Agent iPhone app with Xcode and install it on the phone.

  3. Plug in and go

    Connect the board to the iPhone, open the app, and let the guided setup check each step itself — then ask the agent to do things on the phone.

// features

Why people love it

The computer is gone

Earlier versions needed a Mac/Linux box running the agent; now the board and the phone do everything.

AirPlay eyes, HID hands

Screen mirroring gives the model vision; USB HID gives it taps and keystrokes on a completely stock iPhone.

~$7 of hardware

A XIAO ESP32-S3-class board is the whole bill of materials — no capture cards or test farms.

Any compatible vision model

Point it at an OpenAI-compatible vision endpoint; the reference setup used a locally served Qwen3.8 model.

Advertisement
// run it

Run it yourself

  1. Get the code

    Firmware, app and docs live in one repo.

    git clone https://github.com/onehumanbeing/esp32-iphone-agent.git
  2. Flash the board

    Always build with flash.sh so the nimble configuration is applied.

    hardware/flash.sh
  3. Plug in and open the app

    Setup walks through four steps and verifies each one itself.

    Plug the board into the iPhone and open ESP32 Agent
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains it?

onehumanbeing (Henry Yuan); demos are posted on X @iamhenryyuan and YouTube.

Is it free?

Yes, MIT-licensed; you supply the ~$7 ESP32-S3 board and an iPhone running iOS 18+.

Does it need a paid API key?

It needs a vision model — any OpenAI-compatible endpoint, including a locally served open model, works.

How does it compare to a well-known alternative?

Simulator and cloud-device agents never touch real hardware. This agent sees and taps a physical, unmodified iPhone through a $7 board.

How do I get started?

Clone the repo, flash the board with hardware/flash.sh from a Mac, build the app once in Xcode, then plug the board into your iPhone.

// keep exploring

Similar tools

AI Agents

Rakazo

Rakazo — an open-source, self-hosted AI agent for persistent teammates: bring your own model and computer, run it on web, desktop, iPhone and Android

★ 4.1k starsApache-2.0
View guide →
AI Agents

open-codex-computer-use

Open-source Computer Use as an MCP service: let any agent drive macOS, Linux, and Windows desktops.

★ 2.4k starsMIT
View guide →
AI Agents

agent-desktop

Reliable computer use for any agent: drive real apps through accessibility trees, not pixel guessing.

★ 1.8k starsApache-2.0
View guide →
AI Agents

OpenMausBot

OpenMausBot — the open-source Grok Bot alternative: your own team of AI bots in a chat app, each a real local agent with its own personality, model and cloud computer

★ 4.9k starsApache-2.0
View guide →
AI Agents

openfang

An open-source agent operating system in Rust - autonomous 'Hands' that do real work

★ 18.2k starsApache-2.0
View guide →
AI Agents

agent-world-model

Snowflake's Agent World Model: synthesise 1,000 executable MCP tool-use environments for agentic RL.

★ 465 starsNOASSERTION
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if ESP32 iPhone Agent is not the right fit.

Get ESP32 iPhone Agent

Free and open — grab the source, star the repo, and start creating.