haven_kitchen_os/README.md

metadata

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)