Muse boards / Build

Build: Raspberry Pi Zero 2 W

1-2 hr setup · needs a Mac or PC to set it up · some Terminal, or let your agent do it

Beginner · no toolsRaspberry Pi Imager for the SD card, then the SDK install script.

A working Muse Gadgets: Linux Device SDK (Linux) build on Raspberry Pi Zero 2 W, paired to your Muse account and ready for first prompts.

Linux boxBoard $15 · about $33 with cable/parts1-2 hr setup
Download build.md

See inside

Take the Raspberry Pi Zero 2 W apart

Drag to turn it, pull the slider to explode it, and tap a part to learn what it does. Open the full 3D view

Loading 3D model
1

Get the parts

You need the board and any build-specific accessories before flashing or pairing.

1 × Raspberry Pi Zero 2 W
Requiredboard

Main board or device for this build. List price $15. Prices vary by seller.

Buy from raspberrypi.com
1 × Micro-USB power supply (5 V / 2.5 A)
Requiredpart

Use the PWR port, not the USB data port.

Find on amazon.com
1 × microSD card, 16 GB or larger
Requiredpart

Flash Raspberry Pi OS Lite (64-bit) with Raspberry Pi Imager.

Find on amazon.com
Hackshop never buys for you. Links open the store.
2

Put it together

The Linux gadget needs storage, power and Bluetooth ready before pairing.

Put the board in its case, insert the flashed SD card if it uses one, connect the power supply and attach a USB Bluetooth LE adapter if the machine does not have Bluetooth built in.

3

Get your Muse SDK token

Muse gadgets pair with your account by using a private SDK token.

Create a token at gadgets.muse.ai > Account > SDK tokens (https://gadgets.muse.ai/settings/sdk-tokens). It starts with mgst_. The Linux installer takes it as --sdk-token mgst_YOUR_TOKEN. Never commit the real token or paste it anywhere public.

4

Install the Linux SDK

The installer creates the Muse gadget service and gives Muse a bounded command surface on the machine.

Download install.sh, read it, then run it with mgst_YOUR_TOKEN. Use --run-as USER with a dedicated low-privilege user unless you intentionally want Muse to have the install account's permissions.

curl -fsSL https://raw.githubusercontent.com/facebookincubator/muse-gadget-sdk/main/linux/install.sh -o install.sh
less install.sh
bash install.sh --sdk-token mgst_YOUR_TOKEN
5

Pair it with the Muse app

The Linux device needs to pair with your Muse account before it can receive commands.

In the Muse app, turn on Settings > Devices > Developer mode, then Settings > Devices > Add Device (+). Pick the MuseGadgetXXXXXX name the installer printed, within 10 minutes of install. Muse warns that this is a community device; continue if it's yours. Green = connected. If you miss the window, run sudo musegadget pair, then add the device from the app again.

sudo musegadget pair
6

Try it

A first prompt proves the device is paired, reachable, and useful for the project.

“Check the Pi's temperature and uptime.”“Message me if the garage sensor script stops.”

Hand it to your agent

# Build: Raspberry Pi Zero 2 W as a Muse gadget
Difficulty: Beginner (no tools). Raspberry Pi Imager for the SD card, then the SDK install script.

## Goal
A working Muse Gadgets: Linux Device SDK (Linux) build on Raspberry Pi Zero 2 W, paired to your Muse account and ready for first prompts.

## Hardware
- [Raspberry Pi Zero 2 W](https://www.raspberrypi.com/products/raspberry-pi-zero-2-w/) x1 (required, board): Main board or device for this build. List price $15. Prices vary by seller.
- [Micro-USB power supply (5 V / 2.5 A)](https://www.amazon.com/s?k=Raspberry%20Pi%20micro%20USB%20power%20supply%202.5A) x1 (required, part): Use the PWR port, not the USB data port.
- [microSD card, 16 GB or larger](https://www.amazon.com/s?k=microSD%2032GB%20A1) x1 (required, part): Flash Raspberry Pi OS Lite (64-bit) with Raspberry Pi Imager.

## Shopping list (ask before buying)

Caveats + terms

Same token terms as the ESP32 SDK: personal and non-commercial, at most 50 devices per token, no selling or public listing, revocable at any time. Read terms.

  • 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.
  • Messages from the device are capped at 256 KB; command output is cut at 96 KB per stream.
  • Muse labels it a community device; it is not a supported Meta product.