📇 📟 - M5Stack-based robot with an MCP server for AI-controlled interactions and emotions
Stack-chan
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
日本語
Stack-chan is an open-source, JavaScript-driven, super-kawaii robot built with M5Stack.
This repository provides firmware with M5StackChan CoreS3 as its standard configuration, user applications called MODs, browser development tools, cases, and schematics.
- Video (with English subtitles): https://youtu.be/fZb_mF08xV0
- Official hashtag: #stackchan | #スタックチャン (JP)
Getting started
If this is your first Stack-chan, start with a preassembled M5StackChan and the browser tools.
1. Get an M5StackChan
The standard M5StackChan AI Desktop Robot (K151) package is enough to get started.
The joystick remote controller is optional.
- Worldwide: M5Stack Official Store
- Japan: M5StackChan
- Japan: M5StackChan with joystick remote controller
2. Flash the firmware
Connect M5StackChan to a computer with a data-capable USB cable, then open the Web firmware installer in Chrome or Edge.
Select "M5StackChan CoreS3" as the device.
You do not need to install the Moddable SDK or ESP-IDF.
> [!IMPORTANT]
> Flashing this repository's firmware replaces the factory firmware supplied by M5Stack.
> To restore it, follow the restore procedure in the M5Stack product documentation and use M5Burner.
3. Try a MOD
Find published MODs and mini apps in the MOD Gallery.
Choose a MOD, then run it in the simulator or install it on a device.
Block-based samples can be opened directly in the block editor and changed.
Browser tools
Use the Stack-chan browser tools to set up a device, change its preferences, and create MODs in a browser.
| Tool | Purpose |
| --- | --- |
| Firmware installer | Flash firmware to a supported M5Stack over USB |
| Preferences | Change Wi-Fi and device preferences over BLE |
| MOD Gallery | Find, try, and install published MODs |
| Block editor | Create MODs with Blockly and run them in the simulator or on a device |
| Shape face editor | Arrange eyes and a mouth to create a custom Face |
| Simulator | Run MODs with the WebAssembly firmware and a 3D model |
| MediaPipe BLE tracking | Send tracked face and hand movement over BLE |
Supported hardware
The distributed firmware supports M5Stack, M5Stack Core2, M5Stack CoreS3, and M5StackChan CoreS3.
M5StackChan CoreS3 is the standard configuration and the target used for physical-device release validation.
Firmware for Stack-chan RT and Takao Core2 + SG90 can be built from source.
See the firmware guide for target-specific commands and constraints.
To build the hardware yourself, see the case guide for parts and assembly instructions.
See the schematics for board information.