Saihub prerouted

SAIHub

Give your agent a hand.

An MIT-licensed, agent-ready IO board.
ESP32-C5 firmware that speaks MCP, so Cursor, Claude Code, and Codex can drive real hardware.

中文 · Cookbook · Hardware · Protocol · Build · Releases · MIT

Watch the video: YouTube · Bilibili

---

What it is

SAIHub is a pocket IO companion for coding agents. Flash it, join Wi-Fi, paste an MCP URL, and the agent gets a hand on real hardware:

• GPIO / PWM / programmable power — toggle pins, generate PWM up to 50 kHz, capture edges like a logic analyzer, and switch the 3.3 V / 5 V rails on and off, all over MCP.
• On-device scripting — the agent can upload Lua scripts and run them on the board itself, so timing-critical or multi-step logic executes locally without a round-trip per pin.

The board is SAIHub-Mini: 48 × 28 mm, ESP32-C5, USB-C, a BOOT button, a 12-pin header, and an external U.FL antenna. Pinout and electrical details: docs/hardware.md. Firmware, KiCad design, and the relay server all live in this repo.

You do not have to use our board — the firmware runs on any ESP32-C5. See bring your own board for what changes and where to remap the GPIOs.

What you can do with it

Buy an agent a hand. Drop SAIHub next to a DUT and let the agent debug a real embedded board: drive GPIO, generate PWM, capture traces, and speak UART instead of asking you to probe every line.

An agent-ready IO board. The simplest way to hang other IO off an agent:

• Sweep a servo from a Lua script while the agent watches the mechanism.
• Dim a light or blink a status LED over PWM.
• Close an electromagnetic relay to switch a pump, a lock, or a heater.
• Power a 3.3 V sensor from the switched rail, then read it over UART or GPIO.

Quick start

The cookbook walks through every step:

1. Open the SAIHub web flasher in Chrome or Edge, pick a release, and flash the board.
2. Click BOOT to open Wi-Fi pairing, join the SAIHUB-xxxxxx AP, and pick your network.
3. Point Cursor / Claude Code / Codex CLI at http://<device-ip>/mcp. The agent now has a hand on your bench.

Ways to connect

The LAN URL is all you need at the bench. To reach the board from anywhere, put a relay in front of it — our managed cloud, or one you deploy yourself:

After the board authenticates with the relay, the serial log prints its landing page — https://<origin>/cloud/landing/<digest>/page — with live online status, copyable MCP or REST/OpenAPI URLs, and a button to mint a authentication token.

The relay protocol is server-agnostic — the Cloudflare Worker in this repo is the reference implementation (design notes).

No vendor lock-in

Nothing here ties you to us:

• Any ESP32-C5 board works. SAIHub-Mini is just one carrier; an off-the-shelf DevKit or your own PCB runs the same firmware. See bring your own board.
• You don't need our managed cloud. The relay is a Cloudflare Worker you can deploy under your own account — or replace entirely, since the protocol is documented and server-agnostic.
• Everything is open source under MIT. Firmware, KiCad hardware design, and the cloud relay all live in this repo.
• LAN mode needs no service at all. Wi-Fi plus the local MCP URL is a complete setup; the cloud is optional convenience, not a requirement.

Capabilities

Logic pins are 3.3 V only — full electrical limits in docs/hardware.md.

Repo layout

Community

• Join our Discord
• QQ group: 499504696

License

MIT.