# Muse Gadgets

Muse gadgets are open source devices you build yourself. Program an off-the-shelf ESP32 board or set up a Raspberry Pi with our device SDKs, then connect Muse to your displays, buttons, sensors, actuators, and whatever else you've got lying on your workbench. We open sourced the SDKs and firmware here. It's built by hackers, for hackers, just for fun. Side effects of tinkering may include bricked boards, voided warranties, brownouts, or bankruptcies. Proceed at your own risk! | | | |---|---| | [**ESP32 Device SDK**](esp32) | Connect your ESP32 board to Muse through our open source SDK. Throw in a screen to show images, add audio in and out, or wire up other sensors. | | [**Linux Device SDK**](linux) | Turn that spare Raspberry Pi or Linux box into a Muse gadget. Hack in your own commands to let Muse handle sysadmin chores or your Home Assistant setup. | Before you flash or pair a gadget, get an [SDK token](https://gadgets.muse.ai/settings/sdk-tokens) and review the [Gadget SDK Terms](https://gadgets.muse.ai/sdk-terms). Every gadget needs a token to pair. ESP32 and Linux gadgets pair with the Muse app on iOS and Android, via Settings > Devices. Turn on Developer mode there first, then look for devices prefixed with "MuseGadget". Each directory has a `README.md` to get started and an `AGENTS.md` for coding agents like [Muse Code](https://developer.meta.com/ai/lp/muse-code/). ## Community Meet other hackers who are building and customizing Muse gadgets in our community [Discord](https://discord.gg/3bhjCkZdd6). Get inspired, support each other, and share what you make. ## License Muse Gadgets is licensed under the Apache License, Version 2.0, found in [`LICENSE`](LICENSE), except for these third-party files, which keep their upstream licenses: | Path | Upstream | License | |---|---|---| | [`esp32/components/minimp3/include/minimp3.h`](esp32/components/minimp3) | [lieff/minimp3](https://github.com/lieff/minimp3) | CC0-1.0, see [`LICENSE`](esp32/components/minimp3/LICENSE) | | [`esp32/main/pixel_font.c`](esp32/main/pixel_font.c) | Adafruit GFX `glcdfont.c` | BSD-2-Clause, in the file header | Dependencies fetched at build time are under their own licenses: ESP-IDF components (into `esp32/managed_components/`), and the simulator's LVGL and SDL (listed in [`esp32/simulator/THIRD_PARTY.md`](esp32/simulator/THIRD_PARTY.md)). The Apache License does not cover the [Jollybot avatar](esp32/avatar).