Skip to content

Repository files navigation

Tamagooshi

Docs · Configure · Flash from the browser

Pixel-art pet for M5Stack StickC Plus and StickS3 that turns live metrics into its mood. Local hub feeds readings from metric sources such as Datadog and PostHog over BLE/MQTT. config.yaml selects the mascot, themes, games, and more that ship in the firmware. Follows sessions from coding agents such as Claude and Cursor, down to approving or denying their requests from the device.

Tamagooshi overview

Quick start

make hub        # run the hub, pairs with your device over BLE
make sim        # desktop simulator, no board needed

make lists every target.

Hardware

M5Stack StickC Plus, StickC Plus SE, and StickS3. Flash from the browser via the docs, or locally:

cd firmware
TAMA_BRAND=<id> pio run -e m5sticks3 -t upload   # or m5stickc-plus, m5stickc-plus-se

<id> is a folder under brands/, its config.yaml defines what the build includes.

Hub

Runs on the machine and communicates with the device over BLE. TAMA_BRAND selects the brand config.

pip install -e "hub/backend[voice,claude,cursor]"   # once, Python 3.10+, extras optional
make hub TAMA_BRAND=<id>          # pairs with your device over BLE
make hub-test                     # hub unit tests

Apps & Games

Apps and games ship in firmware (device.apps, device.games). Claude Desktop Buddy and Cursor both support voice conversations via the hub.

Apps, games, and AI catalog

License

MIT. See LICENSE.

About

Desk companion on ESP32. Live metrics from different sources, AI agent session with approvals, voice conversations, and config-driven apps, themes, and games.

Topics

Resources

Contributing

Stars

22 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages