1 × Seeed reTerminal E1001 (7.5" e-paper)
Requiredboard
Main board or device for this build.
Build: Seeed reTerminal E1001 (7.5" e-paper)
A working Muse Gadgets: ESP32 Device SDK (Status) build on Seeed reTerminal E1001 (7.5" e-paper), paired to your Muse account and ready for first prompts.
Status$69-791-3 hr setup
1
Get the parts
You need the board and any build-specific accessories before flashing or pairing.
Buy from seeedstudio.com
1 × USB-C data cable
Requiredpart
Must carry data, not just charge. Most flashing problems are charge-only cables.
Hackshop never buys for you. Links open the store.
2
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_. For this ESP32 build, set CONFIG_GADGET_SDK_TOKEN="mgst_YOUR_TOKEN" in build-reterminal-e1001/sdkconfig after the board build command has created that file, then run the build command again. idf.py menuconfig > ESP32 Device SDK > Muse Gadgets SDK token is the interactive alternative. Never commit the real token or paste it anywhere public.
3
Flash the firmware
The board needs the Muse ESP32 firmware configured with your SDK token.
Let your agent do it
Give your coding agent the build brief at https://www.hackshop.dev/build/seeed-reterminal-e1001/build.md. Tell it to keep the token private, use mgst_YOUR_TOKEN as the placeholder, and find the serial port before flashing. On macOS it should run ls /dev/cu.usbmodem* /dev/cu.usbserial*; on Linux, ls /dev/ttyACM* /dev/ttyUSB*; on Windows, use Device Manager to find the COM port, then run commands in the ESP-IDF shell.
Do it yourself
Install ESP-IDF v6.0.1 and only the esp32s3 target for this board. Muse's ESP32 README verifies macOS and Linux. Windows is not documented by the Muse SDK; if you use it, install ESP-IDF v6.0.1 with Espressif's Windows installer and run commands in the ESP-IDF shell. Clone the Muse Gadget SDK, run tools/board.sh reterminal-e1001 build once to create build-reterminal-e1001/sdkconfig, set CONFIG_GADGET_SDK_TOKEN="mgst_YOUR_TOKEN" in that file, run tools/board.sh reterminal-e1001 build again, then flash. If flashing cannot connect, hold BOOT, tap RESET, then release BOOT.
git clone -b v6.0.1 --recursive https://github.com/espressif/esp-idf.git ~/esp/esp-idf-v6
~/esp/esp-idf-v6/install.sh esp32s3
. ~/esp/esp-idf-v6/export.sh
git clone https://github.com/facebookincubator/muse-gadget-sdk
cd muse-gadget-sdk/esp32
tools/board.sh reterminal-e1001 build
printf '\nCONFIG_GADGET_SDK_TOKEN="mgst_YOUR_TOKEN"\n' >> build-reterminal-e1001/sdkconfig
tools/board.sh reterminal-e1001 build
ls /dev/cu.usbmodem* /dev/cu.usbserial* 2>/dev/null || ls /dev/ttyACM* /dev/ttyUSB* 2>/dev/null
tools/board.sh reterminal-e1001 flash-monitor PORT4
Pair it with the Muse app
Pairing links the freshly flashed board to your Muse account.
In the Muse app, turn on Settings > Devices > Developer mode, then Settings > Devices > Add Device (+). Pick MuseGadget-XXXXXX and press the BOOT button when the screen or edge status breathes blue. Green means connected. Status meanings: orange = ready for setup, blue breathing = press the button, blue = joining Wi-Fi and connecting, green = connected, yellow blinking = reconnecting, purple = unpaired, red blinking = error. Hold the button for 5 seconds to reset pairing.
5
Put it together
A physical agent body needs to sit safely, keep the cable clear and leave controls reachable.
Put the board in its stand, case or a stable spot on the desk. Route the USB-C cable through the slot or open edge, power it, and check that the buttons and display are reachable.
6
Try it
A first prompt proves the device is paired, reachable, and useful for the project.
“Put this week's family calendar on the e-paper board.”“Show a black-and-white photo of the kids on the board.”
Hand it to your agent
# Build: Seeed reTerminal E1001 (7.5" e-paper) as a Muse gadget
## Goal
A working Muse Gadgets: ESP32 Device SDK (Status) build on Seeed reTerminal E1001 (7.5" e-paper), paired to your Muse account and ready for first prompts.
## Hardware
- [Seeed reTerminal E1001 (7.5" e-paper)](https://www.seeedstudio.com/reTerminal-E1001-p-6534.html) x1 (required, board): Main board or device for this build.
- [USB-C data cable](https://www.amazon.com/s?k=USB-C%20data%20cable) x1 (required, part): Must carry data, not just charge. Most flashing problems are charge-only cables.
## Shopping list (ask before buying)
- Seeed reTerminal E1001 (7.5" e-paper) x1 (required, est. $69; buy: https://www.seeedstudio.com/reTerminal-E1001-p-6534.html)
- USB-C data cable x1 (required, est. $8; search: https://www.amazon.com/s?k=USB-C%20data%20cable)Caveats + 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 terms.
- 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.