How samubraila/stackchan works
StackChan is an open-source AI desktop robot ecosystem: CoreS3 firmware drives the robot, with a handheld ESP-NOW controller, iOS/Android mobile apps, a desktop BLE tool, and a Go server. The principal user workflow is controlling or configuring the robot through its screens or companion apps, then seeing movement, expression, or video on the robot/app. Firmware capabilities also include AI-agent interaction, dances, app downloads, and OTA. Groups show the separate products; edges are limited to relationships visible in excerpts or explicitly documented in the README.
Main entry points: apps.h Built-in apps · main.cpp Firmware runtime · SceneDelegate.swift iOS app setup · StackChan-RemoteControl-ESPNow.cpp Remote runtime
Components 26
Robot firmware
- Firmware runtime
firmware/main/main.cpp - Built-in apps
firmware/main/apps/apps.h - App launcher
firmware/main/apps/app_launcher - AI agent
firmware/main/apps/app_ai_agent - Avatar display
firmware/main/apps/app_avatar - Dance playback
firmware/main/apps/app_dance - App downloads
firmware/main/apps/app_app_center - Device setup
firmware/main/apps/app_setup - EZData app
firmware/main/apps/app_ezdata - Motion and servos
firmware/main/stackchan/motion - Avatar rendering
firmware/main/stackchan/avatar - Hardware interface
firmware/main/hal
Remote controller
- Remote runtime
remote/code/main/StackChan-RemoteControl-ESPNow.cpp - Joystick control
remote/code/main/joystick/joystick_handle.c - Remote screens
remote/code/main/ui - ESP-NOW link
remote/code/main/esp_now
Mobile apps
- AR robot view
app/ios/Runner/View/StackChanArView.swift - iOS native bridge
app/ios/Runner/Utils/NativeBridge.swift - iOS app setup
app/ios/Runner/SceneDelegate.swift - Android app
app/android/app/src/main/kotlin/com/m5stack/stackchan/MainActivity.kt
Cloud services
- Go service
server - Service APIs
server/api - Domain services
server/internal/service
Desktop tool
- Desktop interface
desktop/renderer/app.js - Desktop BLE
desktop/renderer/ble.js
Other components
- Robot user
Connections 30
- Robot user → Firmware runtime: uses robot
- Robot user → Remote runtime: uses controller
- Robot user → iOS app setup: uses mobile app
- Firmware runtime → Built-in apps: loads apps
- Built-in apps → App launcher: registers
firmware/main/apps/apps.h - Built-in apps → AI agent: registers
firmware/main/apps/apps.h - Built-in apps → Avatar display: registers
firmware/main/apps/apps.h - Built-in apps → Dance playback: registers
firmware/main/apps/apps.h - Built-in apps → App downloads: registers
firmware/main/apps/apps.h - Built-in apps → Device setup: registers
firmware/main/apps/apps.h - Built-in apps → EZData app: registers
firmware/main/apps/apps.h - Remote runtime → Joystick control: starts tasks
remote/code/main/StackChan-RemoteControl-ESPNow.cpp - Remote runtime → Remote screens: initializes UI
remote/code/main/StackChan-RemoteControl-ESPNow.cpp - Remote runtime → ESP-NOW link: initializes link
remote/code/main/StackChan-RemoteControl-ESPNow.cpp - Joystick control → ESP-NOW link: sends commands
remote/code/main/joystick/joystick_handle.c - Remote runtime → Robot user: controls robot
- iOS app setup → iOS native bridge: sets up bridge
app/ios/Runner/SceneDelegate.swift - iOS app setup → AR robot view: registers view
app/ios/Runner/SceneDelegate.swift - AR robot view → Robot user: shows robot view
- iOS app setup → Android app: parallel app
- iOS app setup → Go service: companion integration
- iOS app setup → Firmware runtime: connects to robot
- Go service → Service APIs: exposes endpoints
- Service APIs → Domain services: delegates domain work
- Desktop interface → Desktop BLE: uses BLE
- Desktop BLE → Firmware runtime: controls robot
- Firmware runtime → App downloads: downloads apps
- Firmware runtime → Go service: online updates
- AR robot view → Firmware runtime: remote avatar control
- AR robot view → Firmware runtime: views video