How to build Tiny Engineer: the whole process
17 steps to build Tiny Engineer, from buying parts, printing and assembly to software, calibration and training, with the bill of materials, shop links and the official …
Tiny Engineer is a small desktop robot that moves, changes its face, and rings a bell while an AI coding assistant reads files, thinks, and writes code. The repository provides printable body files and CAD, an ESP32 main control board design, and instructions for connecting, flashing, and assembling it.
Buy parts
- Order the open-source board
The default build uses the open-source main control board, which can be ordered from any fab.
Print and make
- Print the robot body
Print the robot body.
Assemble
- Connect the components
Plug the ESP32, servos, OLED, and speaker into the main control board.
- Assemble the robot
Assemble the robot after printing the body and connecting its components.
Software
- Insert the ESP32 module
Push the ESP32 module into the sockets on the main board.
- Align the ESP32 module
Align the module with the USB mark printed on the board.
- Connect the USB-C data cable
Connect a USB-C data cable to the board’s USB-C port. Do not use the small port on the ESP32 module.
- Wait for the model to load
Wait while the flashing page loads the model.
- Select Install
Select Install in the firmware flashing interface.
- Wait for releases to load
Wait while the flashable releases load.
- Continue the firmware flashing
Select Continue to put the robot software on the board over USB.
- Confirm the board is flashed
Confirm that the board is flashed, then proceed to mechanical assembly.
- Flash firmware and join Wi-Fi
Flash the main control board; the robot then joins your Wi-Fi.
- Configure the coding-agent connection
Run the setup command to integrate Claude Code, Cursor, Antigravity, or a script that can send POST requests.
- Run the default client
Run the default client with `npx -y tiny-engineer`, using `setup` or `hook`. It supports Cursor, Claude Code, and Antigravity over HTTP or `--transport serial`.
Use it
- Send poses over HTTP or serial
Have an agent or hook script send poses over Wi‑Fi HTTP or USB serial. The ESP32-C3 runs the firmware and drives the servos, face, and speaker.
- Use advanced control
Advanced clients can send requests to `POST /anim` or use framed USB serial.
Common problems
- Incorrect SG90 dimensions prevent the servo from fitting the sizing tester. #30 #93
- Unstandardized servo and OLED choices make builds inconsistent. #5 #6
- Required M2 screw lengths and quantities are undocumented. #15
- Firmware flashing fails with an ESP32 NVS-not-found error. #81
- Diffuser material guidance does not clarify whether translucent plastic works. #17