---
title: Haven Kitchen OS
emoji: 👩🏻‍🍳
colorFrom: green
colorTo: orange
sdk: streamlit
sdk_version: 1.28.0
app_file: app.py
pinned: false
license: apache-2.0
short_description: AI Kitchen Assistant with Dual Personalities
---

# 🏡 Haven Kitchen OS

**Your AI-Powered Kitchen Companion for the Reachy Mini Robot**

Haven Kitchen OS brings two delightful AI personalities into your kitchen:

## 👩🏻‍💼 Meet Olivia
Your sophisticated household manager who handles:
- 📅 Calendar management & scheduling
- ✉️ Email summaries
- 🏠 Smart home coordination
- 🎂 Birthday & event reminders

## 👩🏻‍🍳 Meet Brie
Your enthusiastic culinary assistant who helps with:
- 🍳 Recipe discovery & suggestions
- 📖 Step-by-step cooking guidance
- 🥗 Ingredient substitutions
- ⏱️ Kitchen timers & conversions

## ✨ Features

- **Dual AI Personalities** - Olivia for home management, Brie for cooking
- **Voice Interaction** - Speak naturally with your kitchen assistant
- **Google Calendar Integration** - Manage your schedule hands-free
- **Recipe Navigation** - Step-by-step voice-guided cooking
- **Smart Handoffs** - Olivia seamlessly transfers cooking questions to Brie

## 🤖 Reachy Mini Integration

When running locally with the Reachy Mini robot or MuJoCo simulator:
- Expressive head movements and animations
- Persona-specific eye colors (sage green for Olivia, warm amber for Brie)
- Reactive gestures during conversations

*Note: Robot animations require local hardware/simulator and are disabled in the cloud version.*

## 🚀 Contest Entry

This project is a submission for the **NVIDIA Golden Ticket Contest** showcasing creative applications of the Reachy Mini robot.

**#NVIDIAGTC** | Built with 💚 for Hugging Face & Pollen Robotics

---

## 🔧 Setup (Local)

1. Clone the repository
2. Install dependencies: `pip install -r requirements.txt`
3. Copy `.env.example` to `.env` and add your API keys
4. Run: `streamlit run app.py`

For robot simulation, run `mjpython start_sim.py` in a separate terminal first.

## 📝 Environment Variables

Required API keys (set in HF Secrets for cloud deployment):
- `GROQ_API_KEY` - Primary LLM (Groq)
- `ELEVENLABS_API_KEY` - Text-to-Speech
- `OPENAI_API_KEY` - Backup LLM
- `SERPER_API_KEY` - Web search (optional)