Tiny Engineer

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.

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

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

Star Tiny Engineer to follow the build.

How it 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)

Details: Integrations · HTTP API · USB serial · Cursor hooks

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

See LICENSING.md for scope and effective date. The Tiny Engineer name and logo are not licensed - see TRADEMARK.md.