Spaces:
Running
Running
| title: Alcove | |
| emoji: 🕯️ | |
| colorFrom: green | |
| colorTo: yellow | |
| sdk: static | |
| pinned: false | |
| license: apache-2.0 | |
| short_description: The open-source dual-persona voice framework for Reachy Mini | |
| tags: | |
| - reachy_mini | |
| - voice-assistant | |
| - dual-persona | |
| - conversational-ai | |
| - openai-realtime | |
| # Alcove | |
| **The room inside the Haven.** | |
| An open-source dual-persona voice framework for [Reachy Mini](https://github.com/pollen-robotics/reachy-mini). Two voices, one robot, one continuous conversation. Yours to personalize. | |
| Alcove was extracted from *Haven Kitchen* — a private, personal dual-persona kitchen companion. Haven stays closed; Alcove is the framework underneath, given away. | |
| --- | |
| ## What's in the box | |
| - **Dual-persona architecture** — two personas share a single OpenAI Realtime session, with the topic handed off between them. | |
| - **Handoff engine** — the response-cancel-before-create pattern that makes the incoming persona actually get to speak. | |
| - **Signature moves** — each persona configures a dance from the Reachy Mini library as their handoff cue. | |
| - **Vision** — a camera tool wired into the OpenAI Realtime image input. | |
| - **Live web** — a Tavily-powered search tool. | |
| - **Motion & emotion** — dance, head movement, head tracking, and the full Reachy expressive kit. | |
| - **Deploy patterns** — runtime.env for secrets, headless-mode fixes, fast-shutdown, package-data hygiene. | |
| ## How to fork it | |
| 1. **Duplicate this Space** — three-dot menu → *Duplicate this Space*. You get your own copy under your account. | |
| 2. **Rename the two profiles** — inside `profiles/`, rename `persona_a` and `persona_b` to whoever your two characters are. | |
| 3. **Write the instructions** — each persona's `instructions.txt` is where you write who they are, how they speak, and when they hand off. | |
| 4. **Pick voices and moves** — each persona's `voice.txt` chooses a voice from OpenAI Realtime; each configures a signature move in `persona_manager.py`. | |
| 5. **Install on your Reachy Mini** — from the Discover Apps panel on the robot, or run: | |
| ```bash | |
| reachy-mini-app-assistant install your-username/your-fork | |
| ``` | |
| ## Requirements | |
| - A Reachy Mini robot | |
| - An OpenAI API key (with Realtime API access) | |
| - A [Tavily API key](https://tavily.com) (optional, for the web search tool) | |
| ## License | |
| Apache 2.0. Take it, fork it, make it yours. | |
| ## Credits | |
| Built by [@AccidentalCoder80](https://huggingface.co/AccidentalCoder80) on [Reachy Mini](https://github.com/pollen-robotics/reachy-mini) and OpenAI Realtime. | |