Tiny Engineer

Give your AI coding agent a body.

!Tiny Engineer demo

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.

Build your own

| | | | --- | --- | | 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.

Community builds

!Built Tiny Engineer

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 →

Roadmap

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

How it works

!How Tiny Engineer works

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)

Documentation

| 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

License

• Software (firmware, integrations, scripts, documentation) — MIT
• Hardware designs (CAD source and printables in 3d_models/ and under mods/*/3d_models/; KiCad PCBs in hardware/) — CERN-OHL-S-2.0