Repolode
Submit
facebookincubator

facebookincubator/muse-gadget-sdk

Open source SDKs and firmware for building your own Muse gadgets on ESP32 boards and Linux devices like Raspberry Pi.

View on GitHubWebsite
Stars
2,309
Forks
491
Open issues
126
Last commit
13 hours ago

What is it?

Muse Gadgets is a set of open source device SDKs for building hardware that connects to the Muse app. You can program an off-the-shelf ESP32 board or set up a Linux device such as a Raspberry Pi, then attach displays, buttons, sensors, audio hardware, or actuators.

The repository has two parts: an ESP32 Device SDK for screens, audio input and output, and other sensors, and a Linux Device SDK for turning a spare Linux machine into a gadget and adding custom commands. Devices pair with the Muse app on iOS and Android through Developer mode, and pairing requires an SDK token from the Muse gadgets site.

The repository also includes a power profiling diagnostic for battery-powered ESP32 boards, a simulator that depends on LVGL and SDL, and AGENTS.md files for coding agents in each directory.

Key features

  • 01Connects ESP32 boards to the Muse app through an open source device SDK.
  • 02Supports attaching screens, audio input and output, and other sensors.
  • 03Lets a Raspberry Pi or Linux device run custom commands as a Muse gadget.
  • 04Includes an opt-in power profiling diagnostic for battery-powered ESP32 boards.
  • 05Provides a simulator built on LVGL and SDL.

Use cases

  • Building a small display gadget that shows images or status from a Muse account.
  • Adding custom sysadmin or Home Assistant commands to a spare Raspberry Pi.
  • Wiring sensors, buttons, or audio hardware to an ESP32 board for voice or input projects.
  • Measuring power consumption of a battery-powered ESP32 design.

Things to know

  • Requires hardware such as an ESP32 board or a Raspberry Pi, and the README warns that flashing can brick boards.
  • Every gadget needs a Muse SDK token and acceptance of the Gadget SDK Terms before it can pair.
  • Pairing requires the Muse app on iOS or Android with Developer mode turned on.

Topics

#esp32#embedded#iot#raspberry-pi#firmware#sdk#hardware

FAQ

What is muse-gadget-sdk?
Open source SDKs and firmware for building your own Muse gadgets on ESP32 boards and Linux devices like Raspberry Pi. Muse Gadgets is a set of open source device SDKs for building hardware that connects to the Muse app. You can program an off-the-shelf ESP32 board or set up a Linux device such as a Raspberry Pi, then attach displays, buttons, sensors, audio hardware, or actuators.
Is muse-gadget-sdk free to use? What license does it have?
muse-gadget-sdk is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is muse-gadget-sdk still maintained?
Actively maintained. The last commit to muse-gadget-sdk was on Oct 20, 2026.
What can I use muse-gadget-sdk for?
Building a small display gadget that shows images or status from a Muse account. Adding custom sysadmin or Home Assistant commands to a spare Raspberry Pi. Wiring sensors, buttons, or audio hardware to an ESP32 board for voice or input projects. Measuring power consumption of a battery-powered ESP32 design.
Where can I get muse-gadget-sdk?
The source code and installation instructions are on GitHub: https://github.com/facebookincubator/muse-gadget-sdk

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects