AccidentalCoder80/alcove

Alcove

The room inside the Haven.

An open-source dual-persona voice framework for 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. 1.Duplicate this Space — three-dot menu → Duplicate this Space. You get your own copy under your account.
2. 2.Rename the two profiles — inside profiles/, rename persona_a and persona_b to whoever your two characters are.
3. 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. 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. 5.Install on your Reachy Mini — from the Discover Apps panel on the robot, or run:

   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 (optional, for the web search tool)

License

Apache 2.0. Take it, fork it, make it yours.

Credits

Built by @AccidentalCoder80 on Reachy Mini and OpenAI Realtime.