README.md

metadata

title: CoWonder.ai Reachy Mini Educational Apps
emoji: 🔘
colorFrom: blue
colorTo: purple
sdk: static
pinned: false
short_description: Learn emotions, language, science & bots
tags:
  - reachy_mini
  - reachy_mini_python_app

CoWonder Reachy Mini Educational Apps

Interactive educational apps for the Reachy Mini robot, designed for parents and kids.

Developed by CoWonder.ai.

Apps Included

App	Description
Emotion Mirror	Robot mirrors your facial expressions
Simon Says	Classic game with robot poses
Science Lab	"What if?" science experiments
Language Pal	Learn new languages
I-Spy	Scavenger hunt game
Animal Charades	Act like animals!
Code Robot	Program the robot with words
Teach Robot	Teach custom behaviors

Requirements

• Reachy Mini robot (or simulation mode)
• Python 3.10+
• API keys for:
  • Google Gemini API (for AI features)
  • ElevenLabs API (for text-to-speech)

Installation

pip install reachy-mini-apps

Or install from source:

git clone https://github.com/CoWonder-ai/reachy-mini-apps.git
cd reachy-mini-apps/hf-apps
pip install -e .

Usage

With Reachy Mini Daemon

1. Start the Reachy Mini daemon:

   reachy-mini-daemon
   

2. The app will automatically start and be accessible at http://localhost:8001

Environment Variables

Set your API keys as environment variables or HuggingFace Secrets:

export GEMINI_API_KEY="your-gemini-api-key"
export ELEVEN_LABS_API_KEY="your-elevenlabs-api-key"

Development

Building Static Apps

The web apps are built from the Next.js sources in web-apps/:

cd hf-apps
./scripts/build-all.sh

Running Locally

cd hf-apps
pip install -e .
python -m reachy_mini_apps.main

API Endpoints

Robot Control

• GET /status - Check robot connection
• GET /frame/base64 - Get camera frame
• GET /video - MJPEG video stream
• POST /pose - Set robot pose
• POST /pose/goto - Smooth pose transition
• POST /reset - Reset to neutral pose

AI Services

• POST /api/emotion - Detect facial emotion
• POST /api/verify - Verify scavenger hunt items
• POST /api/translate - Translate text
• POST /api/experiment - Generate science explanations
• POST /api/followup - Generate follow-up questions
• POST /api/speak - Text-to-speech
• POST /api/match - Match voice commands
• POST /api/parse - Parse natural language commands