Third Party Services LLC Contact
Home/Round AMOLED companion

Build guide / Part 1 of 2

A pocket AI companionon a round AMOLED.

Hold a button, talk, and a little round screen answers out loud. About an hour from the box to talking with Muse, no soldering.

Third Party Services · Updated

Some links on this page are affiliate links. If you buy through them we may earn a small commission at no extra cost to you. Disclosures

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

ItemNotes
The boardThe 1.75C above
A USB-C cable that carries dataMost "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 computerMac or Linux is the official path. Windows works, see below
The Muse appiOS or Android
A Muse SDK tokenFree, 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:

  1. Build inside Espressif's official Docker image, espressif/idf:v6.0.1, with the SDK folder mounted, calling idf.py directly instead of the .sh helpers.
  2. Flash from Windows with esptool (pip install esptool). The board shows up as a USB serial COM port.

Step 3. Pair it with Muse

  1. When the firmware boots, the gadget shows it's ready for setup.
  2. In the Muse app, go to Settings > Devices and turn on Developer mode.
  3. Tap Add Device (the + top right). It shows up as MuseGadget-XXXXXX.
  4. When it asks you to confirm, press the button on the gadget. That press proves it's you.
  5. 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.

Your own brainSpeech to text, any AI model, and a voice, all on a small server at home, with fallbacks when one provider hits a limit.
Faces and appsAnimated characters, a clock, weather, a timer, notes and a remote, on a button map you design.
Home and updatesHome Assistant control over MQTT, and new firmware over Wi-Fi without a cable.

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.