Skip to content
yellow-pinePublic

About

Animatronic CyberBrick head that reacts to Claude Code

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

687 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

noggin

An animatronic Mech on the desk that reacts to Claude Code.

Stage 1, from the front
Stage 1, from the front
Stage 3
Stage 3
Stage 3, exploded
Stage 3, exploded

The Mech's bare mechanism, in progress

Docs   Build guide

Checks Site Release Licence: PolyForm Noncommercial 1.0.0

This README is for contributors. Building the Mech, using it and its gestures are on the site.

Setup

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 ones

just 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.

CI/CD

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.

Built with

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

Credits

The Mech is our own design on Bambu Lab's CyberBrick electronics; the full credits are on the site.

Licence

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.

About

Animatronic CyberBrick head that reacts to Claude Code

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages