Muse Gadgets · launched Oct 2, 2026

Give Muse a body

Open-source ESP32 firmware that turns an off-the-shelf board into a device for Muse, Meta's personal AI agent. The board pairs to the Muse app over BLE, joins Wi-Fi and holds an encrypted session to your Muse VM. Meta's SDK is open source (Apache-2.0); this page tracks which boards it supports and what each one can do.

Last verified 2026-10-05 · Sources linked below.

How to start

Pick a board, start a build, hand it to your agent

1

Answer a few questions or pick a board

Tell the planner below what you want, or compare the boards further down. Not sure? The M5Stack StickS3 is a cheap pocket board with a screen and a mic.

2

Start this build

It saves the parts list with store links, print files and a step checklist to My builds. You can also save just the idea and pick a board later.

3

Tell your agent

Copy the prompt or open the build in Claude, ChatGPT, Codex, Cursor or Muse Code. It walks you through ordering, assembly, flashing and pairing.

Find your board

Answer a few quick questions, describe the Muse gadget you want, or both. We'll pick boards that can do it, then save it to My builds.

A few quick questions, all optional
Where will it live?
How will you use it?
Should it sense the room?
Budget
Or try:

ESP32 device SDK

Compare the boards

Muse Gadgets ESP32 board feature comparison
BoardPriceCameraTypeHow hardVoiceImagesTouchAir sensorsHome tunnelPrintable
$22about $32 with cable/partsnoScreen and voiceIntermediate · extra stepsVoice in, text repliesColornonoyesStand
$24about $34 with cable/partsnoScreen and voiceBeginner · no toolsVoice in, text repliesColoryesnoyesno
$29-30about $39 with cable/partsnoScreen and voiceBeginner · no toolsText repliesnoyesnonoStand
$30about $40 with cable/partsnoScreen and voiceIntermediate · extra stepsText repliesnonononono
$30-40about $40 with cable/partsnoScreen and voiceBeginner · no toolsVoice in, text repliesColoryesnoyesno
$36about $46 with cable/partsnoScreen and voiceBeginner · no toolsVoice in, text repliesColornonoyesno
$40-42about $50 with cable/partsnoScreen and voiceBeginner · no toolsVoice in, text repliesColoryesnoyesStand
$45about $55 with cable/partsnoScreen and voiceBeginner · no toolsVoice in, text repliesColoryesnoyesno
$50about $60 with cable/partsnoScreen and voiceBeginner · no toolsVoice in, text repliesColoryesnoyesno
$60about $70 with cable/partsnoScreen and voiceBeginner · no toolsVoice in, text repliesColoryesnoyesno
$61about $64 with cable/partsyesScreen and voiceIntermediate · extra stepsVoice in, text repliesColoryesnoyesno
Price unknownnoScreen and voiceIntermediate · extra stepsnoColoryesnoyesno
Price unknownnoScreen and voiceIntermediate · extra stepsVoice in, text repliesColoryesnoyesno
$15-20about $25 with cable/partsnoScreen and voiceEOLIntermediate · extra stepsVoice in, no speakerColornonoyesStand
$10about $20 with cable/partsnoStatus screenBeginner · no toolsnononononono
$12-18about $22 with cable/partsnoStatus screenBeginner · no toolsnoColornononono
$12-13about $22 with cable/partsnoStatus screenBeginner · no toolsnoColornononono
$15-20about $25 with cable/partsnoStatus screenBeginner · no toolsnonononoyesno
$20about $23 with cable/partsnoStatus screenBeginner · no toolsnonononoyesno
$31about $41 with cable/partsnoStatus screenIntermediate · extra stepsVoice in, text repliesnononoyesno
$49-89about $52 with cable/partsnoStatus screenIntermediate · extra stepsnoColoryesyesyesno
$69about $89 with cable/partsnoStatus screenBeginner · no toolsVoice in, text repliesnononoyesno
$69-79about $72 with cable/partsnoStatus screenBeginner · no toolsnoB&Wnonoyesno
$99-109about $102 with cable/partsnoStatus screenBeginner · no toolsnoColornonoyesno
  • M5Stack StickS3Screen and voice

    Board $22 · about $32 with cable/parts

    • Voice: yes
    • Screen: yes
    • Camera: no
    • Battery: yes
    Intermediate · extra steps
  • Board $24 · about $34 with cable/parts

    • Voice: yes
    • Screen: yes
    • Camera: no
    • Battery (optional): yes
    Beginner · no tools
  • Board $29-30 · about $39 with cable/parts

    • Voice: yes
    • Screen: yes
    • Camera: no
    • Battery (optional): yes
    Beginner · no tools
  • M5Stack Cardputer ADVScreen and voice

    Board $30 · about $40 with cable/parts

    • Voice: yes
    • Screen: yes
    • Camera: no
    • Battery: no
    Intermediate · extra steps
  • Board $30-40

    • Voice: yes
    • Screen: yes
    • Camera: no
    • Battery (optional): yes
    Beginner · no tools
  • AIPI LiteScreen and voice

    Board $36 · about $46 with cable/parts

    • Voice: yes
    • Screen: yes
    • Camera: no
    • Battery: yes
    Beginner · no tools
  • Board $40-42 · about $50 with cable/parts

    • Voice: yes
    • Screen: yes
    • Camera: no
    • Battery (optional): yes
    Beginner · no tools
  • M5Stack StopWatchScreen and voice

    Board $45 · about $55 with cable/parts

    • Voice: yes
    • Screen: yes
    • Camera: no
    • Battery: yes
    Beginner · no tools
  • Espressif ESP32-S3-BOX-3Screen and voice

    Board $50 · about $60 with cable/parts

    • Voice: yes
    • Screen: yes
    • Camera: no
    • Battery: no
    Beginner · no tools
  • M5Stack CoreS3Screen and voice

    Board $60 · about $70 with cable/parts

    • Voice: yes
    • Screen: yes
    • Camera: no
    • Battery: yes
    Beginner · no tools
  • Seeed SenseCAP WatcherScreen and voice

    Board $61 · about $64 with cable/parts

    • Voice: yes
    • Screen: yes
    • Camera: yes
    • Battery: yes
    Intermediate · extra steps
    • Voice: no
    • Screen: yes
    • Camera: no
    • Battery: no
    Intermediate · extra steps
  • M5Stack Core2 (v1.0)Screen and voice
    • Voice: yes
    • Screen: yes
    • Camera: no
    • Battery: yes
    Intermediate · extra steps
  • M5Stack StickC Plus2Screen and voiceEOL

    Board $15-20 · about $25 with cable/parts

    • Voice: yes
    • Screen: yes
    • Camera: no
    • Battery: yes
    Intermediate · extra steps
  • Board $10 · about $20 with cable/parts

    • Voice: no
    • Screen: no
    • Camera: no
    • Battery: no
    Beginner · no tools
  • Board $12-18 · about $22 with cable/parts

    • Voice: no
    • Screen: yes
    • Camera: no
    • Battery: no
    Beginner · no tools
  • Board $12-13 · about $22 with cable/parts

    • Voice: no
    • Screen: yes
    • Camera: no
    • Battery: no
    Beginner · no tools
  • Board $15-20 · about $25 with cable/parts

    • Voice: no
    • Screen: no
    • Camera: no
    • Battery: no
    Beginner · no tools
  • Board $20 · about $23 with cable/parts

    • Voice: no
    • Screen: no
    • Camera: no
    • Battery: no
    Beginner · no tools
  • Board $31 · about $41 with cable/parts

    • Voice: yes
    • Screen: no
    • Camera: no
    • Battery: no
    Intermediate · extra steps
  • Board $49-89

    • Voice: no
    • Screen: yes
    • Camera: no
    • Battery: no
    Intermediate · extra steps
  • Board $69 · about $89 with cable/parts

    • Voice: yes
    • Screen: no
    • Camera: no
    • Battery: no
    Beginner · no tools
  • Board $69-79

    • Voice: no
    • Screen: yes
    • Camera: no
    • Battery: yes
    Beginner · no tools
  • Board $99-109

    • Voice: no
    • Screen: yes
    • Camera: no
    • Battery: yes
    Beginner · no tools

How hard is it?

  • Beginner · no tools. A USB-C data cable and one flash command. No backups, no workarounds, no opening the case.
  • Intermediate · extra steps. One or more extra steps: a backup before the first flash, a special port, a workaround or an add-on part.
  • Expert · needs a pro or better to buy. Soldering, opening the case or hardware mods. Unless you do this often, buy something ready-made.

ESP32 boards

Every board in detail

Screen and voice

M5Stack StickS3

M5Stack StickS3

Screen and voice
Intermediate · extra steps

Pocket ESP32-S3 stick (8MB PSRAM) with 1.14" LCD, mic, 1W speaker, IMU, IR TX/RX, 250mAh battery, magnetic back. Full Muse UI: push-to-talk, two-button menu, images. Successor to the StickC Plus2 and the best pocket remote for Muse.

What works

  • Push-to-talk with text replies; add text-to-speech for spoken replies
  • Color images
  • Home-network tunnel
  • Over-the-air updates
  • Battery powered
Developer details

Pocket stick with speaker, mic, IMU and battery; the best push-to-talk remote.

Build command

tools/muse/board.sh build sticks3

Printable stand

M5Stack StickS3 printable stand preview
Bbox
32 x 45 x 53.9 mm
Filament
16.4 g PLA

Dimensions from a drawing source. Print once and check the fit before batch printing.

Dimension source: docs.m5stack.com

Freenove FNK0104B (ESP32-S3 2.8" touch)

Freenove FNK0104B (ESP32-S3 2.8" touch)

Screen and voice
Beginner · no tools

ESP32-S3 board with a 2.8" 240x320 touch LCD, 16 MB flash, 8 MB PSRAM and ES8311 audio. Full Muse UI: BOOT is push-to-talk, settings on the touch screen, images. Battery shows voltage only. Freenove listed the touch version (FNK0104B) at $23.99 on 2026-10-05.

What works

  • Push-to-talk with text replies; add text-to-speech for spoken replies
  • Color images
  • Touchscreen
  • Home-network tunnel
  • Over-the-air updates
  • Optional battery
Developer details

2.8" touch avatar; BOOT is push-to-talk. Battery shows voltage only.

Build command

tools/muse/board.sh build fnk0104b

Use the vendor case.

Waveshare ESP32-C6-Touch-AMOLED-1.8

Waveshare ESP32-C6-Touch-AMOLED-1.8

Screen and voice
Beginner · no tools

1.8" 368x448 touch AMOLED in a case, ESP32-C6, mic + speaker, IMU, RTC. No PSRAM: full Muse UI, but push-to-talk replies scroll past as text, no images and no home-network tunnel. Cheapest full-UI board.

What works

  • Push-to-talk with text replies
  • Touchscreen
  • Over-the-air updates
  • Optional battery
Developer details

No PSRAM: voice notes go over the control session and replies come back as scrolling text.

Build command

tools/muse/board.sh build c6

Printable stand

Waveshare ESP32-C6-Touch-AMOLED-1.8 printable stand preview
Bbox
38.6 x 45 x 33.6 mm
Filament
15.0 g PLA

Dimensions from a drawing source. Print once and check the fit before batch printing.

Dimension source: docs.waveshare.com

M5Stack Cardputer ADV

M5Stack Cardputer ADV

Screen and voice
Intermediate · extra steps

Experimental in the Muse SDK. ESP32-S3 keyboard computer (8 MB flash, no PSRAM) with a 1.14" LCD. Hold Space/GO to send a voice note; replies show as scrolling text. No images, home-network tunnel or battery telemetry. M5Stack listed it at $29.90 on 2026-10-05.

What works

  • Push-to-talk with text replies
Developer details

Experimental in the Muse SDK. Hold Space/GO to send a voice note; replies scroll past as text. No images, home-network tunnel or battery telemetry.

Build command

tools/muse/board.sh build cardputer-adv

Use the vendor case.

Waveshare ESP32-S3-Touch-AMOLED-1.75 (round)

Waveshare ESP32-S3-Touch-AMOLED-1.75 (round)

Screen and voice
Beginner · no tools

Round 1.75" 466x466 touch AMOLED with ESP32-S3, 16 MB flash and 8 MB PSRAM. Full Muse UI: animated avatar, push-to-talk on BOOT, settings and images. The 1.75C sibling has 32 MB flash. Waveshare listed it at $29.99-39.99 on 2026-10-05.

What works

  • Push-to-talk with text replies; add text-to-speech for spoken replies
  • Color images
  • Touchscreen
  • Home-network tunnel
  • Over-the-air updates
  • Optional battery
  • Round display
Developer details

Round AMOLED avatar with BOOT as push-to-talk; the 16 MB flash sibling of the 1.75C.

Build command

tools/muse/board.sh build s3n

Use the vendor case.

AIPI Lite

AIPI Lite

Screen and voice
Beginner · no tools

Palm-size ESP32-S3 voice buddy (X-ORIGIN / AIPI Labs) with a 128x128 LCD, mic, speaker and a snap-on 450mAh battery. Full Muse UI with push-to-talk, two-button menu and images. No official firmware repo; community ESPHome port exists.

What works

  • Push-to-talk with text replies; add text-to-speech for spoken replies
  • Color images
  • Home-network tunnel
  • Over-the-air updates
  • Battery powered
Developer details

Palm-size voice buddy with a snap-on battery and a two-button menu.

Build command

tools/muse/board.sh build aipi

No printable stand yet. Manual lists 55.5 x 47.5 x 7.8 mm, likely without the snap-on battery module; width/depth orientation is unclear. Request one

Waveshare ESP32-S3-Touch-AMOLED-1.75C (round)

Waveshare ESP32-S3-Touch-AMOLED-1.75C (round)

Screen and voice
Beginner · no tools

Round 1.75" 466x466 touch AMOLED in a CNC aluminum case (the C SKU). ESP32-S3, 8MB PSRAM, dual mics, speaker, IMU. Full Muse UI: animated avatar, push-to-talk, settings, images. The closest DIY match to a Muse Charm on your desk. Optional internal battery.

What works

  • Push-to-talk with text replies; add text-to-speech for spoken replies
  • Color images
  • Touchscreen
  • Home-network tunnel
  • Over-the-air updates
  • Optional battery
  • Round display
Developer details

Round AMOLED avatar; best desk object.

Build command

tools/muse/board.sh build s3

Printable stand

Waveshare ESP32-S3-Touch-AMOLED-1.75C (round) printable stand preview
Bbox
36 x 45.0 x 58.0 mm
Filament
18.0 g PLA

Dimensions from a drawing source. Print once and check the fit before batch printing.

Dimension source: waveshare.com

M5Stack StopWatch

M5Stack StopWatch

Screen and voice
Beginner · no tools

ESP32-S3 with a round 1.75" 466x466 touch AMOLED, 16 MB flash, 8 MB PSRAM and the StickS3's ES8311 audio. Full Muse UI: yellow button for push-to-talk, blue for sleep, settings on the touch screen, battery status. M5Stack listed it at $45 on 2026-10-05.

What works

  • Push-to-talk with text replies; add text-to-speech for spoken replies
  • Color images
  • Touchscreen
  • Home-network tunnel
  • Over-the-air updates
  • Battery powered
  • Round display
Developer details

Round AMOLED with the yellow button for push-to-talk, the blue one for sleep and settings on the touch screen.

Build command

tools/muse/board.sh build stopwatch

Use the vendor case.

Espressif ESP32-S3-BOX-3

Espressif ESP32-S3-BOX-3

Screen and voice
Beginner · no tools

ESP32-S3 kit with a 2.4" 320x240 touch LCD, 16 MB flash, 16 MB PSRAM, speaker and mics. Full Muse UI: BOOT/CONFIG push-to-talk, touch settings and images. Dock sensors, SD card, IR and battery telemetry aren't used. Adafruit listed it at $49.95 (out of stock) on 2026-10-05.

What works

  • Push-to-talk with text replies; add text-to-speech for spoken replies
  • Color images
  • Touchscreen
  • Home-network tunnel
  • Over-the-air updates
Developer details

Touch screen avatar; BOOT/CONFIG is push-to-talk and the hardware mic mute button still works.

Build command

tools/muse/board.sh build box3

Use the vendor case.

M5Stack CoreS3

M5Stack CoreS3

Screen and voice
Beginner · no tools

ESP32-S3 core with a 2" 320x240 touch LCD, 16 MB flash, 8 MB PSRAM, 1 W speaker and mics. Full Muse UI: PWR is push-to-talk and pairing, settings on the touch screen. The camera, IMU and SD card aren't used yet. M5Stack listed it at $59.90 on 2026-10-05.

What works

  • Push-to-talk with text replies; add text-to-speech for spoken replies
  • Color images
  • Touchscreen
  • Home-network tunnel
  • Over-the-air updates
  • Battery powered
Developer details

Touch screen avatar; PWR on the left side is push-to-talk. The camera isn't used yet.

Build command

tools/muse/board.sh build cores3

Use the vendor case.

Seeed SenseCAP Watcher

Seeed SenseCAP Watcher

Screen and voice
Intermediate · extra steps

ESP32-S3 + Himax vision chip, 5MP camera, 1.45" round touch LCD, mic, speaker, scroll wheel. Full Muse UI plus camera capture, so Muse can look at a room or a 3D printer. Camera and on-device vision mean high privacy exposure; place it deliberately.

What works

  • Push-to-talk with text replies; add text-to-speech for spoken replies
  • Color images
  • Touchscreen
  • Camera capture
  • Home-network tunnel
  • Over-the-air updates
  • Battery powered
  • Round display
Developer details

camera.capture returns a JPEG (CONFIG_MUSE_WATCHER_CAMERA=y).

Build command

tools/muse/board.sh build watcher

No printable stand yet. Seeed lists 69 x 65 x 20; Make: lists 64 x 68 x 19.5; which side is which is not stated. Request one

No image

Guition JC3248W535 (3.5" touch)

Screen and voice
Intermediate · extra steps

ESP32-S3 with a 3.5" 320x480 IPS touch panel, 16 MB flash, 8 MB PSRAM and a speaker amp. Full Muse UI and images. It has no microphone: push-to-talk needs an I2S MEMS mic such as an INMP441 wired in. Sold as JC3248W535C_I_Y and JC3248W535EN. No seller price verified.

What works

  • Color images
  • Touchscreen
  • Home-network tunnel
  • Over-the-air updates
Developer details

3.5" touch avatar and speaker, but no microphone: push-to-talk records silence until you wire in an I2S mic.

Build command

tools/muse/board.sh build jc3248w535

Use the vendor case.

M5Stack Core2 (v1.0)

M5Stack Core2 (v1.0)

Screen and voice
Intermediate · extra steps

Core2 v1.0 (AXP192 power chip): classic ESP32, 2" 320x240 touch LCD, 16 MB flash, 8 MB PSRAM. Full Muse UI: hold the middle touch zone to talk; settings, battery, images and the home-network tunnel work. Core2 v1.1 (AXP2101) isn't supported; check the back sticker or PCB. No seller price verified.

What works

  • Push-to-talk with text replies; add text-to-speech for spoken replies
  • Color images
  • Touchscreen
  • Home-network tunnel
  • Over-the-air updates
  • Battery powered
Developer details

Core2 v1.0 only (AXP192 power chip); v1.1 isn't supported. Hold the middle touch zone to talk.

Build command

tools/muse/board.sh build core2

Use the vendor case.

M5Stack StickC Plus2

M5Stack StickC Plus2

Screen and voiceEOL
Intermediate · extra steps

ESP32 stick (2MB PSRAM) with 1.14" LCD, mic, buzzer, IMU, IR, 200mAh battery. Full Muse UI with push-to-talk, but it has a buzzer, not a speaker, so replies are quiet; they show as text on the screen. M5Stack lists it as end-of-life; buy the StickS3 unless you already own one.

What works

  • Push-to-talk (buzzer, no speaker)
  • Color images
  • Home-network tunnel
  • Over-the-air updates
  • Battery powered
Developer details

End of life at M5Stack. It has a buzzer, not a speaker, so replies are quiet; they show as text on the screen.

Build command

tools/muse/board.sh build plus2

Printable stand

M5Stack StickC Plus2 printable stand preview
Bbox
32 x 43.5 x 54.1 mm
Filament
16.0 g PLA

Dimensions from a published source. Print once and check the fit before batch printing.

Dimension source: docs.m5stack.com

Status screen

Espressif ESP32-C6-DevKitC-1 (no PSRAM)

Espressif ESP32-C6-DevKitC-1 (no PSRAM)

Status screen
Beginner · no tools

ESP32-C6 dev board without PSRAM (8 MB flash). Muse shows status on its RGB light and uses the BOOT button. No PSRAM, so no home-network tunnel; Muse can still reach and control it. Adafruit listed the N8 at $9.95 (out of stock) on 2026-10-05.

What works

    Developer details

    Status light and BOOT button. No PSRAM, so no home-network tunnel; Muse can still reach and control it.

    Build command

    tools/board.sh c6-nopsram build

    Use the vendor case.

    ideaspark ESP32 with 1.9" LCD

    ideaspark ESP32 with 1.9" LCD

    Status screen
    Beginner · no tools

    Classic ESP32 (no PSRAM) with a 1.9" 170x320 ST7789 LCD. Muse shows status and draws images straight to the screen, but there is no home-network tunnel. Needs chip rev 3.0+ for signed apps (the D0WD-V3 qualifies). Cheap, bare PCB, no case.

    What works

    • Color images
    Developer details

    No PSRAM, so no home-network tunnel; draws images straight to the screen.

    Build command

    tools/board.sh ideaspark build

    No printable stand yet. Listed as 2.51 x 1.24 in. Thickness and USB edge not published; display active area 24.91 x 41.49 mm. Request one

    Waveshare ESP32-C6-LCD-1.47

    Waveshare ESP32-C6-LCD-1.47

    Status screen
    Beginner · no tools

    ESP32-C6 board with a 1.47" 172x320 ST7789 LCD and 4 MB flash, no PSRAM. Muse shows status on the screen and draws images; no PSRAM, so no home-network tunnel. Uses the BOOT button.

    What works

    • Color images
    Developer details

    Status and images on a 1.47" screen. No PSRAM, so no home-network tunnel.

    Build command

    tools/board.sh waveshare-c6-lcd-147 build

    Use the vendor case.

    Espressif ESP32-C5-DevKitC-1

    Espressif ESP32-C5-DevKitC-1

    Status screen
    Beginner · no tools

    Muse Gadgets' recommended starter board: status light + button only, no screen. Dual-band Wi-Fi 6, BLE, Thread/Zigbee, 8MB flash + 4/8MB PSRAM, so it gets Muse's home-network tunnel. Cheapest way to give Muse a physical presence or a local-network foothold.

    What works

    • Home-network tunnel
    Developer details

    Status light and button. Muse's recommended starting point. The direct `idf.py build` command is correct; `tools/board.sh devkit build` also works.

    Build command

    idf.py build

    No printable stand yet. PCB 53.6 x 25.4 mm; module antenna overhangs 6.5 mm (60.1 total). Thickness incl. headers not published. Request one

    Espressif ESP32-S3-DevKitC-1 (N8R8)

    Espressif ESP32-S3-DevKitC-1 (N8R8)

    Status screen
    Beginner · no tools

    ESP32-S3 dev board with 8 MB flash and 8 MB PSRAM. Muse shows status on its RGB light, uses the BOOT button and gets the home-network tunnel. No screen or audio. Micro-USB ports. Adafruit listed it at $19.95 (out of stock) on 2026-10-05.

    What works

    • Home-network tunnel
    Developer details

    Status light and BOOT button, with PSRAM for the home-network tunnel. No screen or audio.

    Build command

    tools/board.sh espressif-s3-devkitc-1 build

    Use the vendor case.

    Seeed reSpeaker Lite with XIAO ESP32-S3

    Seeed reSpeaker Lite with XIAO ESP32-S3

    Status screen
    Intermediate · extra steps

    Experimental in the Muse SDK. reSpeaker Lite 2-mic array with a XIAO ESP32-S3 (8 MB flash, 8 MB PSRAM). RGB status LED and push-to-talk on the XIAO BOOT button; replies show as text in the Muse app. The XMOS must run Seeed's 16 kHz I2S firmware v1.0.9. Seeed listed the pre-soldered reSpeaker/XIAO board at $30.99, the 4 ohm / 5 W speaker at $2, and the self-assembled acrylic enclosure at $5 on 2026-10-07.

    What works

    • Push-to-talk with text replies; add text-to-speech for spoken replies
    • Home-network tunnel
    Developer details

    Experimental in the Muse SDK. Push-to-talk on the XIAO BOOT button; replies show as text in the Muse app. Needs Seeed's 16 kHz I2S XMOS firmware v1.0.9, and speaker playback isn't verified on hardware yet.

    Build command

    tools/board.sh seeed-respeaker-lite build

    Use the vendor case.

    Seeed SenseCAP Indicator (D1 series)

    Seeed SenseCAP Indicator (D1 series)

    Status screen
    Intermediate · extra steps

    4" 480x480 touchscreen (ESP32-S3 + RP2040) in a finished case with kickstand. Muse: status screen + images. D1S/D1Pro add CO2, tVOC and temp/humidity that Muse can read; D1 has no sensors. Buzzer only, no mic/speaker.

    What works

    • Color images
    • Touchscreen
    • Air sensors
    • Home-network tunnel
    Developer details

    Air sensors only on D1S/D1Pro (temp/humidity via the bundled Grove AHT20).

    Build command

    tools/board.sh sensecap-indicator build

    No printed part needed: it ships with its own stand or mount (Fold-out kickstand and keyhole wall slot (no dimensions published).).

    Home Assistant Voice Preview Edition

    Home Assistant Voice Preview Edition

    Status screen
    Beginner · no tools

    ESP32-S3 + XMOS voice puck: dual mics, speaker, 3.5mm out, LED ring, rotary dial, hardware mute. Under Muse it is push-to-talk with status on the LED ring and the dial as volume; replies show as text in the Muse app. Flashing Muse replaces the ESPHome firmware; reflash ESPHome to go back to Home Assistant.

    What works

    • Push-to-talk with text replies; add text-to-speech for spoken replies
    • Home-network tunnel
    Developer details

    Status on the LED ring, push-to-talk, dial as volume. Replies show as text in the Muse app.

    Build command

    tools/board.sh home-assistant-voice build

    No printed part needed: it ships with its own stand or mount (it ships in a finished case).

    Seeed reTerminal E1001 (7.5" e-paper)

    Seeed reTerminal E1001 (7.5" e-paper)

    Status screen
    Beginner · no tools

    7.5" 800x480 black-and-white e-paper, ESP32-S3, 2000mAh battery, temp/humidity sensor, ships with a stand. Muse shows status text and black-and-white images; the E1002 is the color sibling.

    What works

    • B&W images
    • Home-network tunnel
    • Battery powered
    Developer details

    Status text and black-and-white images on 7.5" e-paper.

    Build command

    tools/board.sh reterminal-e1001 build

    No printed part needed: it ships with its own stand or mount (Wall hole on the back; embedded nuts for the included stand.).

    Seeed reTerminal E1002 (7.3" color e-paper)

    Seeed reTerminal E1002 (7.3" color e-paper)

    Status screen
    Beginner · no tools

    7.3" E Ink Spectra 6 full-color ePaper with ESP32-S3 and up to 3-month battery life. Muse shows status text and six-color images. Official SDK build command is reterminal-e1002.

    What works

    • Color images
    • Home-network tunnel
    • Battery powered
    Developer details

    Status text and six-colour images on 7.3" e-paper.

    Build command

    tools/board.sh reterminal-e1002 build

    Use the vendor case.

    Firmware path

    How to build one

    1. Get an SDK token at https://gadgets.muse.ai/settings/sdk-tokens (never commit it or paste it into a public repo).
    2. Install ESP-IDF v6.0.1 for your board's chip only: git clone -b v6.0.1 --recursive https://github.com/espressif/esp-idf.git ~/esp/esp-idf-v6 && ~/esp/esp-idf-v6/install.sh <chip> && . ~/esp/esp-idf-v6/export.sh
    3. git clone https://github.com/facebookincubator/muse-gadget-sdk && cd muse-gadget-sdk/esp32
    4. Set the token: idf.py menuconfig > ESP32 Device SDK > Muse Gadgets SDK token (or CONFIG_GADGET_SDK_TOKEN in the build's sdkconfig).
    5. Build with the board's command below, set the token, build again, then flash with the board's flash command (tools/muse/board.sh flash <board> PORT). If flashing can't connect: hold BOOT, tap RESET, release BOOT.
    6. In the Muse app, turn on Settings > Devices > Developer mode, then Settings > Devices > Add Device (+). Pick MuseGadget-XXXXXX and press the board's button (BOOT on dev kits) when the light breathes blue. Green = connected.

    Or let a coding agent do it:

    curl -fsSL https://dev.meta.ai/install.sh | sh && git clone https://github.com/facebookincubator/muse-gadget-sdk && cd muse-gadget-sdk/esp32 && muse --disable-sandbox   # then: "Build this firmware for my <board> and flash it." Any coding agent that reads AGENTS.md can do the same.

    Your SDK token ships inside the firmware: never commit it or paste it into a public repo.

    Linux device SDK

    Turn a Linux box into a Muse gadget

    A Python service (musegadget) that turns a Linux box with Bluetooth LE into a Muse gadget. Muse gets shell, file and health commands on the machine and can push messages back to you.

    Official boards

    • Raspberry Pi 5 · $110-175 · Featured on gadgets.muse.ai.
    • Raspberry Pi 4 Model B · $35-65 · Listed in the Linux SDK README.
    • Raspberry Pi Zero 2 W · $15 · Listed in the Linux SDK README; slow but enough for shell and file commands.

    Revive an old mini PC

    • Dell Wyse 5070 (thin client) · $40-90 · Not on Meta's list. Meets the stated requirements on Debian/Ubuntu if it has Bluetooth LE; most units need a USB BLE adapter.
    • HP t620 Plus (thin client) · $30-70 · Not on Meta's list. Add a USB Bluetooth LE adapter.
    • Intel NUC (Older Generations) · $40-150 · Not on Meta's list. Many NUCs ship with Bluetooth; check yours.
    • Lenovo ThinkCentre Tiny (M Series) · $35-120 · Not on Meta's list. Bluetooth depends on the Wi-Fi card fitted; add a USB BLE adapter if missing.

    Built-in commands

    • system.run
    • file.read
    • file.write
    • device.health

    Add a spec to COMMAND_SPECS in linux/src/musegadget/executor.py (description, required/optional params with type + description, optional timeout_ms), handle it in Executor.run returning ok(payload) or error(message), then restart the service.

    Commands run as the install user with exactly that account's permissions. If it can sudo, so can Muse. Use a dedicated low-privilege user (--run-as USER) unless you need more.

    Fabrication package

    Print it, or get it made

    Each package includes an STL for printing, STEP for CAD/CNC, and a fab.json file with print settings and checks.

    Need a stand for a board that doesn't have one yet? Request one.

    Hackshop never places orders for you.

    SDK token terms

    The fine print (SDK token terms)

    Personal, non-commercial use with your own Muse account. A token can be linked to at most 50 devices. You may not put it in any device you sell, advertise, or list publicly or in a marketplace or app store; other distribution needs Meta's written permission. Provided as-is; Meta can change, withdraw or revoke access at any time. Read the terms.

    • Personal and non-commercial use only.
    • ≤ 50 devices per token.
    • No selling or public listing.
    • Meta can revoke at any time.

    Limits

    Caveats

    • Boards without PSRAM (classic ESP32, ESP32-C6) run without the home-network tunnel; Muse can still reach and control them.
    • The home-network tunnel lets Muse reach devices on your LAN that expose a local HTTP API. Treat it like giving the agent a foothold on your network.
    • Pairing has no manufacturer verification and can't prevent an active man-in-the-middle attack.
    • Builds are signed with the included development key and never enable Secure Boot. Enable NVS encryption (CONFIG_HOMEHUB_NVS_ENCRYPTION).
    • Custom ESP32 commands are not a documented API yet: the command set (display.draw_url, sensors.read, camera.capture, ...) is hardcoded in main/app.c.

    Common questions

    FAQ

    Which board should I buy first?

    M5Stack StickS3 ($22) for a pocket remote, Waveshare ESP32-S3-Touch-AMOLED-1.75C (round) ($40-42) for a desk avatar, or Espressif ESP32-C5-DevKitC-1 ($15-20) as the cheapest start; Muse calls it the recommended starting point.

    Which boards can't do voice or images?

    No voice: Guition JC3248W535 (3.5" touch), Espressif ESP32-C6-DevKitC-1 (no PSRAM), ideaspark ESP32 with 1.9" LCD, Waveshare ESP32-C6-LCD-1.47, Espressif ESP32-C5-DevKitC-1, Espressif ESP32-S3-DevKitC-1 (N8R8), Seeed SenseCAP Indicator (D1 series), Seeed reTerminal E1001 (7.5" e-paper) and Seeed reTerminal E1002 (7.3" color e-paper). No images: Waveshare ESP32-C6-Touch-AMOLED-1.8, M5Stack Cardputer ADV, Espressif ESP32-C6-DevKitC-1 (no PSRAM), Espressif ESP32-C5-DevKitC-1, Espressif ESP32-S3-DevKitC-1 (N8R8), Seeed reSpeaker Lite with XIAO ESP32-S3 and Home Assistant Voice Preview Edition.

    Do I need a paid Muse subscription?

    The SDK needs a Muse account and the Muse app with Developer mode. Muse Home Link (Meta's own dongle) is the piece that requires an active US subscription.

    Can I sell gadgets I build?

    No. The SDK token terms forbid putting a token in any device you sell, advertise or list publicly; other distribution needs Meta's written permission. A token can be linked to at most 50 devices.

    What is the home-network tunnel?

    It lets Muse reach devices on your home Wi-Fi that have a local web API, like a printer, a smart plug or a Home Assistant server, so it can check on them or control them for you. Treat it like giving the agent a foothold on your network. Boards without PSRAM (classic ESP32, ESP32-C6) run without the home-network tunnel; Muse can still reach and control them.

    Primary links

    Sources

    Start from an idea

    Gadget ideas

    Official SDK

    A desk orb that shows what Muse is doing

    Round AMOLED avatar on your desk: push-to-talk, Muse's replies as text and images from Muse, in a printed stand.

    Experimental

    A self-assembled voice node for Muse

    Build the complete reSpeaker Lite kit: dual microphones, XIAO ESP32-S3, 5 W speaker and acrylic enclosure.

    Official SDK

    Pocket push-to-talk remote for Muse

    M5Stack StickS3 on a keychain or desk dock: press, talk, read Muse's answer on the screen.

    Official SDK

    E-paper status board Muse can draw on

    7.5" reTerminal E1001 on the wall showing Muse's status and black-and-white images.

    Official SDK

    Air-quality sensor Muse can read

    SenseCAP Indicator D1S/D1Pro reports CO2, tVOC, temperature and humidity when Muse asks.

    Official SDK

    A camera Muse can use to check your 3D printer

    SenseCAP Watcher on a stand: Muse can grab a frame and tell you if a print failed.

    Experimental

    Revive an old mini PC as Muse's home-server hands

    Muse Linux SDK on a thrift-store thin client: shell, files and Home Assistant, with a USB Bluetooth dongle.