README.md

---
title: Haven Kitchen OS
emoji: 🌿
colorFrom: green
colorTo: yellow
sdk: static
pinned: false
license: mit
tags:
  - reachy_mini
  - reachy_mini_python_app
  - reachy-mini
  - robotics
  - ai-assistant
  - voice-assistant
  - smart-home
short_description: AI home management with Olivia & Brie for Reachy Mini
---

# 🌿 Haven Kitchen OS

**Olivia & Brie - Your AI Home Companions for Reachy Mini**

Haven Kitchen OS transforms your Reachy Mini into an intelligent home management system featuring two distinct AI personas that bring warmth and personality to your daily life.

## 👩🏻‍💼 Meet Olivia
Your professional household manager with a calm, sage-green presence. She handles:
- Daily scheduling and reminders
- Home organization tasks
- Professional, warm conversation
- Seamless handoffs to Brie for kitchen matters

## 👩🏻‍🍳 Meet Brie  
Your enthusiastic personal chef with a warm, amber glow. She specializes in:
- Creating personalized recipes based on your preferences
- Step-by-step cooking guidance with voice commands
- Celebrating your cooking victories
- Making every meal an experience

## ✨ Features

| Feature | Description |
|---------|-------------|
| 🗣️ Voice Interaction | Natural conversation with both personas |
| 🤖 Expressive Animations | Unique robot movements for each persona |
| 📖 Recipe Navigation | "Next", "Back", "Repeat", "Ingredients" voice commands |
| 📱 Cast to Devices | Send recipes to your phone via QR code |
| 🎭 Personality Eyes | Olivia = sage green, Brie = warm amber |
| 💾 Memory System | Remembers preferences across sessions |

## 🚀 Installation

### From Reachy Mini Dashboard
1. Open your Reachy Mini dashboard at `http://127.0.0.1:8000`
2. Find "Haven Kitchen OS" in the app store
3. Click Install

### Manual Installation
```bash
pip install haven-kitchen-os
```

## 🎤 Voice Commands While Cooking

| Command | Action |
|---------|--------|
| "Let's cook" | Start cooking mode |
| "Next" | Go to next step |
| "Back" | Go to previous step |
| "Repeat" | Hear current step again |
| "Ingredients" | List all ingredients |

## 🛠️ Requirements

- Reachy Mini robot (or MuJoCo simulation)
- Python 3.10+
- API keys for LLM providers (Groq/OpenAI)
- ElevenLabs API key (optional, for premium voices)

## 📝 Environment Variables

Create a `.env` file with:
```
GROQ_API_KEY=your_groq_key
OPENAI_API_KEY=your_openai_key
ELEVENLABS_API_KEY=your_elevenlabs_key
```

## 🏆 Contest Entry

Built for the **NVIDIA Reachy Mini Golden Ticket Contest**

#ReachyMini #HuggingFace #NVIDIAGTC

---

Made with ❤️ by MindXpansion