---
title: Reachy Recognizer
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 4.44.1
app_file: app.py
pinned: false
license: mit
---

# 🤖 Reachy Recognizer

**Human-Aware AI Companion for Reachy Mini**

A complete face recognition and conversational AI system that enables Reachy Mini robots to recognize people, greet them with personalized responses, and engage in natural voice conversations.

## ✨ Features

- **Face Recognition**: Real-time face detection and recognition using OpenCV DNN
- **Personalized Greetings**: Context-aware greetings based on person identity and time of day
- **Voice Conversation**: Natural language conversations powered by OpenAI GPT
- **Adaptive Behaviors**: Dynamic robot movements and expressions
- **Event System**: Smart debouncing and state management

## 🚀 Quick Installation

### Install to Your Reachy Robot

**[📥 Click here to install to your Reachy](https://pollen-robotics.github.io/reachy_mini_app_example/?install=true)**

Or use the manual installation:

```bash
curl -X POST http://localhost:8000/api/install \
  -H "Content-Type: application/json" \
  -d '{"url": "https://github.com/chelleboyer/reachy-recognizer", "name": "reachy_recognizer"}'
```

### Manual Setup

```bash
git clone https://github.com/chelleboyer/reachy-recognizer.git
cd reachy-recognizer
pip install -e .
python main.py
```

## � Documentation

- [Project Structure](https://github.com/chelleboyer/reachy-recognizer/blob/main/docs/PROJECT_STRUCTURE.md)
- [Configuration Guide](https://github.com/chelleboyer/reachy-recognizer/blob/main/docs/CONFIGURATION.md)
- [Setup Instructions](https://github.com/chelleboyer/reachy-recognizer/blob/main/docs/SETUP.md)

## 📊 Performance

- **Recognition Speed**: ≥5 FPS real-time processing
- **Detection Accuracy**: >95% with OpenCV DNN
- **Recognition Accuracy**: >90% with SFace embeddings
- **Response Latency**: <200ms end-to-end

## 🔗 Links

- [GitHub Repository](https://github.com/chelleboyer/reachy-recognizer)
- [Installation Page](https://pollen-robotics.github.io/reachy_mini_app_example/)

## 📄 License

MIT License - See [LICENSE](https://github.com/chelleboyer/reachy-recognizer/blob/main/LICENSE)