README.md

Reachy Mini conversation demo

Working repo, we should turn this into a ReachyMini app at some point maybe ?

Installation

You can set up the project quickly using uv:

uv venv --python 3.12.1  # Create a virtual environment with Python 3.12.1
source .venv/bin/activate
uv sync

Note: The pyproject.toml expects reachy-mini-dances-library to be located in the same directory as this project.

Run

reachy-mini-conversation-demo

Runtime Options

Option	Values	Default	Description
--sim	(flag)	off	Run in simulation mode (no physical robot required).
--vision	(flag)	off	Enable the vision system (must be paired with --vision-provider).
--vision-provider	local, openai	local	Select vision backend: • local → Hugging Face VLM (SmolVLM2) runs on your machine. • openai → OpenAI multimodal models via API (requires OPENAI_API_KEY).
--head-tracking	(flag)	off	Enable head tracking (ignored when --sim is active).
--debug	(flag)	off	Enable debug logging (default log level is INFO).

Examples

• Simulated run with OpenAI Vision:

reachy-mini-conversation-demo --sim --vision --vision-provider=openai