Skip to content

Repository files navigation

Tiny Engineer

Give your AI coding agent a body.

Tiny Engineer demo

Watch the demo · Build your own · Community builds · How it works

  • Looks around while the agent reads
  • Types while it writes code
  • Looks up while it thinks
  • Rings the bell when the task is done

Works with

What it feels like

Your agent… Tiny Engineer…
Reads files Looks around
Edits code Types
Thinks / waits Looks up
Finishes a task Rings the bell

Open-source desk robot: 3D-printable body, Wi-Fi, and a small REST API so your tools can drive the poses.

See it move

YouTube demo

Build your own

Parts (electronics + 5× SG90 Servos) About $50–70 shopping list
Also budget for 3D printer + filament, or order prints; M2 screws; 5 V / ≥2 A USB supply
Tools Soldering required (modules and harness wires)
Difficulty Medium - fair first hardware project for a software engineer, not a one-LED kit. Optional primer: From Code to Circuits

Print → Wire → Flash → Assemble → Connect - step-by-step: Getting started.

Integrated PCB in progress - a main board that replaces most breakout modules and wiring. Interest check →

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:

  • Integrated PCB - less wiring, faster builds
  • 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

How Tiny Engineer works

Your agent (or a hook script) sends poses over HTTP. The ESP32-C3 on the robot runs the REST API, animations, and audio, then drives five servos, an OLED face, and a speaker.

Clients

  • Cursor - hooks → tiny-engineer-cursor → Wi-Fi
  • Antigravity - lifecycle hooks → tiny-engineer-antigravity → Wi-Fi
  • Claude Code - project hooks → tiny-engineer-claude-code → Wi-Fi
  • Bring your own - any tool that can POST to /anim

Details: Integrations · HTTP API · Cursor hooks

Documentation

Print it, wire 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

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

About

A small desktop robot that brings an AI coding assistant to life, physically acting out when it reads files, thinks, writes code, and finishes work.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

453 stars

Watchers

9 watching

Forks

Releases

Packages

Contributors

Languages