Give your AI coding agent a body.
Watch the demo · Build your own · Community builds · How it works
A small robot on your desk. It moves, changes its face, and rings a bell as your coding AI agent works.
| Your agent… | The robot… |
|---|---|
| Reads files | Looks around |
| Writes code | Types |
| Thinks or waits | Looks up |
| Finishes the task | Rings the bell |
Open source. Print the body, plug the ESP32, servos, OLED, and speaker into the main control board, flash it, and it joins your Wi-Fi.
Works with Claude Code · Cursor · Antigravity — via npx -y tiny-engineer setup — or Codex, Windsurf, and any script that can POST (integration guide · HTTP API), including speech through POST /play.
| Parts (electronics + 5× SG90 Servos) | shopping list: main control board plus ESP32, servos, OLED, and speaker |
| Also needed | 3D printer + filament, or order prints; M2 screws; 5 V / ≥2 A USB supply |
| Tools | Plug in the ESP32, servos, OLED, and speaker on the main control board. Want to add extra modules? advanced wiring |
| Difficulty | Medium - fair first hardware project for a software engineer, not a one-LED kit. Optional primer: From Code to Circuits |
The default build uses the open-source main control board. Order it from any fab (how to order · KiCad).
If a ~$15–20 assembled board like this would be useful to you, Vote here 👍 → → I’m using the interest to decide whether it’s worth developing further.
Print → Connect → Flash → Assemble - step-by-step: Getting started.
Finished builds, mods, and desk setups live in Show and tell on GitHub Discussions - browse what others made and post photos of yours.
Built one? Share in Show and tell →
What we are building toward:
- More agent integrations - one-command hooks for more IDEs and CLIs
- Simplified build process - easier assembly and setup for quicker builds
- New characters / bodies - alternate shells and mods
- Multi-agent desk - more than one tiny teammate
Star Tiny Engineer to follow the build.
Your agent (or a hook script) sends poses over Wi‑Fi HTTP or USB serial. The ESP32-C3 runs the firmware, optional Wi‑Fi/REST, USB CDC control, and drives the servos, face, and speaker.
Clients
- Default —
npx -y tiny-engineer(setup/hook) for Cursor, Claude Code, Antigravity (HTTP or--transport serial) - Advanced —
POST /anim(HTTP API) or framed USB serial (serial.md)
Details: Integrations · HTTP API · USB serial · Cursor hooks
| You want to… | Start here |
|---|---|
| Build the robot | Getting started |
| Buy parts | Shopping list |
| Flash the board | Web flash · Flash |
| Assemble the prints | Assembly |
| Print the parts | 3D models |
| Hook up an agent | Integrations |
| Call the HTTP API | API |
| Anything else | Docs index |
Print it, connect it, change the CAD, or hook up another agent. Issues and PRs welcome - especially new integrations. CONTRIBUTING.md · SECURITY.md · CODE_OF_CONDUCT.md
- Software (firmware, integrations, scripts, documentation) — MIT
- Hardware designs (CAD source and printables in
3d_models/and undermods/*/3d_models/; KiCad PCBs inhardware/) — CERN-OHL-S-2.0
See LICENSING.md for scope and effective date. The Tiny Engineer name and logo are not licensed - see TRADEMARK.md.