What you end up with
A round, 1.75-inch AMOLED gadget about the size of a big watch face. It listens through two built-in microphones, answers through its own speaker, shows pictures, and runs on a battery. The brain is Muse, Meta's assistant, through Meta's open source Muse Gadget SDK.
Part 1 gets you there with the official firmware. Part 2 is for people who want to replace it with their own: custom faces, their own AI brain, smart home control and updates over Wi-Fi. Most people stop after Part 1, and that's a good place to stop.
Why this board
The SDK supports about twenty boards. The one we built on, and the one we'd tell a friend to buy, is the Waveshare ESP32-S3-Touch-AMOLED-1.75C.
- 466 x 466 round AMOLED with touch. True blacks, so the avatar floats on the glass. It looks like a product, not a dev board.
- Two microphones and a speaker on board. Push-to-talk works out of the box. Nothing to wire.
- Battery management built in (an AXP2101 power chip) and a battery port, so it goes in your pocket.
- Aluminum case on the "C" version. A finished object, no 3D printing required.
- ESP32-S3 with 8 MB PSRAM and 16 MB flash. Plenty of room for Part 2.
- Full Muse UI support in the SDK: animated avatar, push-to-talk, settings, images.
Get the Waveshare ESP32-S3-Touch-AMOLED-1.75C. It was about $40 when we wrote this; check the page for today's price. A cheaper caseless "1.75" (no C) works with the SDK too. Buy the C unless you plan to print your own enclosure.
What you need
| Item | Notes |
|---|---|
| The board | The 1.75C above |
| A USB-C cable that carries data | Most "it won't flash" problems are charge-only cables |
| A small LiPo battery (optional) | For pocket use. Ours behaves like a 400 to 500 mAh cell |
| A computer | Mac or Linux is the official path. Windows works, see below |
| The Muse app | iOS or Android |
| A Muse SDK token | Free, from gadgets.muse.ai under Settings, SDK tokens |
Step 1. Get your SDK token
Sign in at gadgets.muse.ai, open Settings > SDK tokens, make one and keep it where you can copy it. Every gadget needs a token to pair, even one you only build for yourself. Read the Gadget SDK Terms while you're there.
Step 2. Build and flash
Route A: let an AI coding agent do it
The SDK ships with an AGENTS.md that tells a coding agent how to install the toolchain, build for your board, flash it and read the logs. Meta's Muse Code works, and so does any agent that reads AGENTS.md (we used Claude Code). Clone the SDK (github.com/facebookincubator/muse-gadget-sdk), plug in the board, start the agent in the esp32 folder and say:
I have a Waveshare ESP32-S3-Touch-AMOLED-1.75C. Build the Muse firmware for it and flash it.
Then: "Watch the serial log and tell me when it's ready to pair." The agent needs the USB port, so if it runs in a sandbox, let the flash and monitor commands run outside it.
Route B: by hand
Install Espressif's ESP-IDF version 6.0.1 exactly, then from the SDK's esp32 folder:
. ~/esp/esp-idf-v6/export.sh # in every new terminal
tools/muse/board.sh build s3 # "s3" is the 1.75C ("s3n" is the caseless 1.75)
tools/muse/board.sh flash s3 # finds the board's port for you
Add your SDK token when the build asks, or with idf.py menuconfig under ESP32 Device SDK > Muse Gadgets SDK token.
If flashing can't connect: hold BOOT, tap RESET, let go of BOOT and try again. If it still fails, swap the cable before you blame anything else.
On Windows
The SDK's docs cover Mac and Linux, and its helper scripts arrived with Windows line endings on our copy, which breaks them. What worked on Windows 11:
- Build inside Espressif's official Docker image,
espressif/idf:v6.0.1, with the SDK folder mounted, callingidf.pydirectly instead of the.shhelpers. - Flash from Windows with
esptool(pip install esptool). The board shows up as a USB serial COM port.
Step 3. Pair it with Muse
- When the firmware boots, the gadget shows it's ready for setup.
- In the Muse app, go to Settings > Devices and turn on Developer mode.
- Tap Add Device (the + top right). It shows up as
MuseGadget-XXXXXX. - When it asks you to confirm, press the button on the gadget. That press proves it's you.
- Give it your Wi-Fi. When it says connected, you're done.
Each pairing makes a fresh encrypted session, but community devices have no manufacturer verification, so pair on a network you trust. To start over, hold the button for 5 seconds.
Step 4. Use it
Hold the button, talk, let go. Muse answers out loud and can put pictures on the screen. For a lot of people that's the point: a small assistant you pick up instead of unlocking a phone.
What we learned so you don't have to
- Use a data cable. Really.
- ESP-IDF 6.0.1 only. Newer is not better here.
- Battery life follows how you use it. Awake and listening drains fast; resting barely sips. Expect hours of active use on a small cell, not days.
- Reflashing keeps your pairing and Wi-Fi. Only a full erase starts you from zero.
Part 2: your own firmware
The stock firmware is great at being Muse. It doesn't let you pick the brain, the faces or what the buttons do. We replaced it with our own and kept a door open to put Muse back on with one flash. Part 2 walks through all of it.
Leave your email in the box and we'll send Part 2 when it's published, along with the files when they're released.
Questions people ask
Which board should I buy for a Muse gadget with a screen?
The Waveshare ESP32-S3-Touch-AMOLED-1.75C: 466 by 466 round AMOLED touch screen, two microphones, a speaker, battery management and an aluminum case, with full Muse UI support in the Muse Gadget SDK.
Which ESP-IDF version does the Muse Gadget SDK need?
ESP-IDF 6.0.1 exactly. Other versions are not supported.
My ESP32-S3 board will not flash. What do I try?
Use a USB-C cable that carries data, not a charge-only cable. Then hold BOOT, tap RESET, release BOOT and flash again.
Can I build the Muse firmware on Windows?
Yes. Build inside Espressif's espressif/idf:v6.0.1 Docker image calling idf.py directly, then flash from Windows with esptool on the board's USB serial COM port.