Step 1 of 5 · on this computer

Get your Muse SDK token

Meta asks every Muse gadget to carry a personal SDK token. It's free and tied to your Muse account. Do this on this computer, so you can paste it straight in.

Open the SDK tokens page

Open the SDK tokens pageUse the button above. It opens gadgets.muse.ai/settings/sdk-tokens in a new tab.
Click Log inOn “Log in or create an account”, type the mobile number or email you use for Muse, click Continue, and finish signing in. No account yet? The same screen creates one.
Tick the terms boxTick “I agree to the Gadget SDK Terms”. The token is for personal use and works with a limited number of devices.
Click Generate tokenA box called “Copy your new token” appears.
Click CopyIf you see “Couldn't copy”, select the whole token and press Cmd+C on Mac or Ctrl+C on Windows.
Come back here and pasteClick the box below and press Cmd+V or Ctrl+V. We check it straight away.

Paste your SDK token

Starts with mgst_ and is 48 characters long.

Already made a token and lost it?

The SDK tokens page only shows the first few characters of a saved token. Click Revoke, confirm, then click Generate token for a new one. The page may let you keep only one active token.

Your token stays in this tab and is written only to your AIPI. It never reaches AIPI's servers. Don't post it in screenshots or chats: Meta's terms make it personal to you.

Step 2 of 5 · on this computer

Connect your AIPI Lite

1Plug it inUse a USB-C data cable, straight into this computer, not a hub. AIPI turns on by itself.
2Close other appsQuit anything that talks to USB devices: Arduino IDE, serial monitors, other setup tabs.
3Click Connect, then pick itIn the box Chrome opens, select USB JTAG/serial debug unit and click Connect.

aipi.com wants to connect to a serial port Example

USB JTAG/serial debug unit (cu.usbmodem1101) CancelConnect

What you'll see in Chrome. On Windows the name ends in (COM3) or similar.

The list is empty, or my AIPI isn't in it

Try another cable. Many USB-C cables only charge. The one that came with a phone usually carries data.
Plug straight into the computer, not a hub, dock or monitor. Try another port.
Check the AIPI screen is lit. If it's dark, unplug it, wait five seconds and plug it in again.
Quit Arduino IDE, serial monitors and any other tab with this page open, then click Connect again.
On Linux, add your user to the dialout group, log out and back in, then reload this page.
Still nothing? Email support@aipi.com with your computer and browser version.

Step 3 of 5 · on this computer

Back up and install Muse

About 3–5 minutes

We save your AIPI system to this computer first. Then we install Muse, restart your AIPI and add your token.

Back up your AIPI system
Reads all 16 MB and saves aipi-backup.bin where you choose.
Install Muse for AIPI
Writes Muse for AIPI Lite [VERSION], tested on AIPI hardware.
Restart
Your AIPI starts Muse and reconnects over USB.
Add your SDK token
Saved on the device only. Then it shows its code.

Before you click

Chrome asks where to save aipi-backup.bin. Keep the name and click Save.
Keep the cable plugged in and this tab open until it finishes.
Plug your laptop into power so it doesn't sleep halfway.

Technical log

Step 4 of 5 · on this computer

Make it talk

Muse shows its answers on the screen as text, and that works fine. Add a voice service below and your AIPI reads the answers out loud instead. You can skip this step — it's optional, you can run setup again later, and nothing else about your AIPI changes.

Your AIPI isn't connected. Plug in the USB cable to save voice settings.

Voice service

Official OpenAI text-to-speech, already filled in. Pick Groq, or choose Custom for your own service.

Speech URL

Where your AIPI sends the text to be spoken. It must start with https://.

API key

Required for this service. Up to 255 characters.

Model

Which voice model to use. Up to 63 characters.

Voice

The voice Muse reads with. Up to 63 characters.

Your API key is written only to your AIPI, over the same USB cable as the rest of setup. It never reaches AIPI's servers. Don't post it in screenshots or chats.

Step 5 of 5 · on your phone

Add it in the Muse app

Pick up your phone and keep it near your AIPI. This page follows along live, so you'll see each step tick off.

Skipped voice? Add it any time — plug in your AIPI, reconnect, and open step 4.

Waiting for the Muse app to find it…Live from your AIPI over USB

In the Muse app, your AIPI is called MuseGadget-——

Open the Muse appUse the same Muse account you made the token with.
Go to Settings › Devices and turn on Developer modeMuse only lists gadgets like AIPI when it's on.
Tap + (Add Device) at the top right, and allow BluetoothIf asked: iPhone, tap Allow. Android, allow nearby devices.
Pick the name ending in your codeThe last six characters match the code on your AIPI.
Tap Continue on the community device noticeMuse tells you this gadget isn't made by Meta. It's yours, so continue.
Press the right button on your AIPIWhen the screen says Press. You have 60 seconds.
Choose your Wi-Fi and type its passwordA 2.4 GHz network with a password. Mistyped it? Muse lets you try again.
Wait for the faceYour AIPI shows Joining Wi-Fi, then its face. Up to a minute.

Something's not working

The name isn't in Muse's list: check Developer mode is on, Bluetooth is on and allowed for Muse, and your phone is within arm's reach. Close and reopen Muse, then tap + again.
Missed the 60 seconds to press: nothing is broken. Tap + in Muse and pick your AIPI again.
Stuck on Joining Wi-Fi: pick a 2.4 GHz network and retype the password. On an iPhone hotspot, turn on Maximize Compatibility.
Wrong account or wrong Wi-Fi: on your AIPI, press the left button to open the menu, move to Reset pairing with the left button, press the right button twice. Then start again from step 1 on your phone.