README.md

Awesome Stack-chan

A curated list of projects, resources, articles, mods, and tools for Stack-chan / ｽﾀｯｸﾁｬﾝ.

Contents

• Getting Started
• Hardware
• 3D Printable Parts
• Firmware
• Software
• AI / Conversation
• Mods
• Build Logs
• Articles
• Videos
• Community

Getting Started

• Stack-chan Cosense - Community-maintained notes and resources for Stack-chan.
• Stack-chan - Firmware and project repository.
• Stack-chan Documentation - Documentation site for building and using Stack-chan.
• Stack-chan on Protopedia - Project overview and background for Stack-chan.

Hardware

• Takao Kit Notes - Notes about the Takao kit and related hardware.
• RT Stack-chan - Hardware and software resources for the RT Stack-chan kit.

3D Printable Parts

• Takao 3D Models - 3D printable models and accessories for Stack-chan.
• Stack-chan 360 Unit Parts - 3D model data for a Stack-chan 360 unit.
• Xiaozhi Avatar Face - 3D face data for Xiaozhi-style avatar hardware.
• Stack-chan Case - Case data for Stack-chan.
• Basic v2.7 Magnetic Body - Magnetic body data for Basic v2.7.
• NekomimiLED for M30 Case - Case data for NekomimiLED for M30.

Firmware

• stackchan-arduino - Arduino framework firmware for Stack-chan.
• AI StackChan2 README - Setup notes for AI StackChan2.
• AI StackChan2 - AI conversation firmware for Stack-chan.
• BinsPack for StackChan Core2 - Multi-application package support for StackChan Core2.
• AI StackChan DevCam - Camera-based AI Stack-chan firmware for CoreS3.
• Bluetooth Simple - Bluetooth speaker firmware with avatar reactions.
• Stack-chan Tester - Servo and motion test firmware for Stack-chan.
• M5Unified StackChan Radiko - Radiko streaming player firmware for Stack-chan.
• Stack-chan bit - micro:bit integration for Stack-chan.
• SDU AI StackChan2 - SD-updatable variant of AI StackChan2.

Software

• Scratch with Stack-chan - Scratch-based interaction project for Stack-chan.
• Stack-chan meets Scratch with M5bitLess - Scratch interaction project using M5bitLess.

AI / Conversation

• stackchan-mcp - MCP server and ESP-IDF firmware that lets AI agents drive a Stack-chan over WebSocket (servos, avatar, LEDs, touch, camera, microphone).
• AI StackChan Ex - AI conversation firmware with LLM, STT, and TTS integrations.
• AI StackChan Minimal - Minimal AI conversation setup for Stack-chan.
• StackFlow Releases - Releases for local AI components used with M5Stack LLM workflows.

Mods

Build Logs

• Stack-chan Build Notes - Build notes for making Stack-chan.
• AI Stack-chan Build Guide - Guide for building an AI Stack-chan.
• Core2 StackChan Setup - Setup and troubleshooting notes for M5Stack Core2 and StackChan.
• Stack-chan Assembly - Assembly log for building Stack-chan.

Articles

• AI Stack-chan RT Setup - Setup article for AI Stack-chan with the RT kit.
• Stack-chan on Non-Core M5 Devices - Article about making Stack-chan with non-Core M5 devices.

Videos

• Stack-chan YouTube Channel - YouTube channel for Stack-chan videos and event archives.
• Stack-chan Kit Assembly - Video guide for assembling a Stack-chan kit.
• AI Stack-chan Setup - Video guide for setting up AI Stack-chan.
• AI Stack-chan PlatformIO Setup - Video guide for writing AI Stack-chan firmware with PlatformIO.

Community

• Stack-chan Gallery - Gallery of Stack-chan builds and examples.
• Stack-chan Zoo - Collection of Stack-chan-related works on Protopedia.
• Stack-chan Advent Calendar 2025 - Advent calendar for Stack-chan articles.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.