gesture_mirror / README.md
jrubiosainz's picture
Initial publish: gesture_mirror
f386794 verified
---
title: Gesture Mirror
emoji: πŸ–οΈ
colorFrom: purple
colorTo: blue
sdk: static
pinned: false
short_description: "Hand gestures make the robot react!"
tags:
- reachy_mini
- reachy_mini_python_app
---
# Gesture Mirror πŸ–οΈπŸ€–
Detects hand gestures (wave, thumbs up, point, peace, fist, open palm) via MediaPipe Hands and makes the Reachy Mini robot react with matching movements.
## Reactions
| Gesture | Robot Response |
|---------|--------------|
| πŸ‘‹ Wave | Waves back with head sway |
| πŸ‘ Thumbs Up | Nods approvingly |
| πŸ‘† Point | Looks in pointed direction |
| ✌️ Peace | Excited bounce with antenna wiggle |
| ✊ Fist | Startled shake |
| πŸ–οΈ Open Palm | Calm reset |
## Features
- Real-time hand gesture recognition using MediaPipe Hands
- Gesture stability tracking (3 consistent frames required)
- Cooldown system to prevent reaction spam
- Smooth interpolated animations between keyframes
- Idle breathing animation when no gestures detected
## Requirements
- Camera connected to Reachy Mini
- `mediapipe`, `opencv-python`, `numpy`
## Install & Run
```bash
pip install .
reachy-mini run gesture_mirror
```