01
Reachy Mini App

hermes-body

A voice-driven brain for Reachy Mini, backed by Nous Research's hermes-agent.

OpenAI Realtime drives the sub-second voice loop and robot motion — look, dance, antennas, camera. A single ask_hermes tool reaches a local hermes-agent for web search, calendar, and persistent memory. Cross-channel memory stays in sync via post-turn syncs.

Architecture
01 — Body
OpenAI Realtime
voice + motion
ask_hermes
02 — Brain
hermes-agent
memory + tools
§ 01

Three layers, one robot.

hermes-body splits responsibility cleanly. The body listens and moves in real time. The brain remembers and reasons. A single tool call connects them.

01

Realtime voice

Sub-second turn-taking. The robot listens through its mic; OpenAI Realtime handles ASR, reasoning, and TTS in a single WebSocket.

02

Embodied tools

Eight robot tools — look, antennas, emotion, dance, camera, face_tracking, stop_moves, idle.

03

Knowledge backend

One ask_hermes tool reaches a hermes-agent container for web search, calendar, files, and long-term memory.

§ 02

Install on your Reachy Mini.

Four steps from a fresh robot to a talking, listening, moving body.

  1. 01

    Run hermes-agent

    Run hermes-agent in Docker on a machine reachable from the robot. Enable its OpenAI-compatible API server and note the base URL and API key.

    Setup guide →
  2. 02

    Install the app

    From the Reachy Mini dashboard — Apps tab, search "hermes-body" — or via the daemon API:

    curl -X POST http://localhost:8000/api/apps/install \
      -H "Content-Type: application/json" \
      -d '{"url":"https://huggingface.co/spaces/wschenk/hermes-body"}'
  3. 03

    Configure

    Set the OpenAI API key and hermes-agent endpoint via env vars on the robot. See the README for the full list.

  4. 04

    Start it

    Start the app from the dashboard. The robot listens on its mic and begins moving.