Corvelis

Corvelis / stackchan-pet-fw

Public

Pet-like affection firmware for Stack-chan on M5Stack CoreS3 Visibility: Public

19
1
100% credibility
Found May 21, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
C++
AI Summary

Stack-chan CoreS3 Controller is firmware for a desktop robot companion built on the M5Stack CoreS3 hardware platform. The robot features an animated face displayed on its screen, servo-controlled head movement, microphone and speaker for audio interaction, a back touch sensor for petting detection, motion sensors for shake detection, and a camera for photo capture. The firmware manages the robot's emotional state through an 'affection' system that tracks positive and negative interactions over time, displaying different facial expressions and behaviors based on the relationship level. The robot can operate in standalone mode with local WiFi setup, or connect to external AI services for voice interaction. All settings and interactions are accessible through an on-device touch screen interface.

How It Works

1
📦 You receive your robot companion

You unbox your Stack-chan robot with its screen face and servo motors, excited to bring it to life.

2
💻 You install the brain

Using a simple tool, you load the firmware onto your robot's computer brain so it can think and feel.

3
📶 You connect it to your world

Your robot creates its own WiFi signal that you join, or it connects to your home network so it can communicate.

4
🤗 You pet your robot and watch it react

When you touch the sensor on its back, your robot wiggles with joy, showing a happy face and moving its head.

5
Your robot can be controlled in different ways
🎤
Voice mode

Your robot listens through a connected AI assistant, responding with expressions and sounds when you speak.

🌐
Direct control

You open a web page from your phone to change expressions, move the head, or take photos.

6
❤️ Your robot remembers how you treat it

Over time, your robot's affection meter grows when you're kind to it, and it shows different expressions based on your relationship.

😊 You have a living companion

Your robot greets you, responds to your touch, watches you with its camera, and develops its own personality through your interactions.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is stackchan-pet-fw?

This is C++ firmware for Stack-chan, a character robot face that mounts on M5Stack CoreS3 hardware. The firmware turns a servo-driven head with an LCD display into a pet-like companion that responds to physical interaction. It handles face rendering from PNG images, servo motion control, two-way audio streaming, and camera capture. The standout feature is an on-device affection system that tracks mood, confusion, and attachment levels that shift based on how you treat the robot. Pet it, and affection rises. Shake it, and confusion spikes. The robot's face expressions and behavior change dynamically based on its emotional state and your relationship level.

The device exposes HTTP and WebSocket APIs so external clients can control state, trigger expressions, and receive audio. You can build custom integrations with voice assistants or other systems.

Why is it gaining traction?

The affection system is the hook. Unlike static robot faces that show preset animations, this one tracks your relationship over time. The robot remembers interactions through an event-weighted system with cooldown timers and decay curves. Five affection tiers range from "cautious" to "daisuki" (adored), each with distinct visual expressions. The system broadcasts level-up and level-down events so external clients can react to relationship changes.

The documentation is thorough and bilingual. Setup involves PlatformIO, copying a config template, and uploading PNG face assets to LittleFS. The device can run in station mode or create its own access point for direct connection. A browser-based Wi-Fi setup page handles credential management without recompiling.

Who should use this?

Hardware hobbyists building interactive robot companions. Developers integrating personality-driven robots with voice interfaces or home automation. Anyone with an M5Stack CoreS3 and Stack-chan shell who wants a robot that feels like it has feelings. Not useful unless you have the specific hardware.

Verdict

This is a creative, well-documented firmware for a niche hardware combination. The affection system adds genuine personality depth that separates it from simple animation players. At 19 stars and 1.0% credibility, it's early-stage and unproven at scale, but the code is clean, the API is well-documented, and the concept is solid. Try it if you have the hardware and want a robot that actually responds to being loved.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.