An animatronic Mech on the desk that reacts to Claude Code.
The Mech's bare mechanism, in progress
This README is for contributors. Building the Mech, using it and its gestures are on the site.
macOS or Linux, with:
| Tool | For |
|---|---|
| uv | Python 3.14 and the dependencies, from uv.lock |
| just | the recipes: uv run just (a dev dependency), or uv tool install rust-just |
| Node 24 | the site (site/.nvmrc) |
| Chrome | the site's browser tests |
| Docker | just linux-test, a model/ change's tests in the CI image |
just venv # .venv from uv.lock
just lint # ruff (lint, formatting) and pyright: the pre-push hook
just check-light # the PR gate: just lint and the fast tests
just linux-test <tests> # just ours and those tests in the CI image (Docker): a model/ change, before its push
just check # main's Code job: adds the workflow linters and the CadQuery build tests
just site # the site, built into site/dist
npm --prefix site run preview # serve it
npm --prefix site test # its tests; run smoke for the browser onesjust check-all adds the model tests (MuJoCo and the slow mesh sweeps). They and the other heavy recipes (sim,
render, web) run one at a time and are best left to CI.
What each workflow in .github/workflows does is on the CI/CD page.
Required checks on main: PR, Checks, Fetch Skills and Review. PRs go straight against main with auto-merge on;
how work runs is in CONTRIBUTING.md.
| Tool | Here it |
|---|---|
| Claude Code | sends the hook events the Mech reacts to |
| CadQuery | models the printed parts |
| MuJoCo | simulates the Mech and tests its motions |
| Blender | draws every picture and the viewer's look, and finishes the realistic Skeleton's bones in just ours |
| MicroPython | runs the programs on both Cores |
| Astro Starlight | builds the site |
| three.js | draws the 3D viewer |
The Mech is our own design on Bambu Lab's CyberBrick electronics; the full credits are on the site.
PolyForm Noncommercial 1.0.0, copyright Yellow Pine. You may use, change and share noggin for any
noncommercial purpose; contact hello@yellowpine.com for commercial licensing. The realistic skull's meshes in
model/skull/ are others' work under their own Creative Commons licences, each in its folder's LICENSE.md.


