Connecting to sources…

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

Documents