This release is a pre-release and may not be stable for production use.
Reachy Mini 🤖
Reachy Mini is an open-source, expressive robot made for hackers and AI builders.
⚡️ Build and start your own robot
Choose your platform to access the specific guide:
| 🤖 Reachy Mini (Wireless) | 🔌 Reachy Mini Lite | 💻 Simulation |
|---|---|---|
| The full autonomous experience. Raspberry Pi CM4 + Battery + WiFi. |
The developer version. USB connection to your computer. |
No hardware required. Prototype in MuJoCo. |
| 👉 Go to Wireless Guide | 👉 Go to Lite Guide | 👉 Go to Simulation |
⚡ Pro tip: Install uv for 10-100x faster app installations (auto-detected, falls back to
pip).
📱 Apps & Ecosystem
Reachy Mini comes with an app store powered by Hugging Face Spaces. You can install these apps directly from your robot's dashboard with one click!
- 🗣️ Conversation App: Talk naturally with Reachy Mini (powered by LLMs).
- 📻 Radio: Listen to the radio with Reachy Mini!
- 👋 Hand Tracker: The robot follows your hand movements in real-time.
👉 Browse all apps on Hugging Face
🚀 Getting Started with Reachy Mini SDK
User guides
- Installation: 5 minutes to set up your computer
- Quickstart Guide: Run your first behavior on Reachy Mini
- JavaScript SDK & Web Apps: Build browser apps that drive the robot over WebRTC — the easiest way to share your apps.
- AI Integrations: Connect LLMs, build Apps, and publish to Hugging Face.
- Core Concepts: Architecture, coordinate systems, and safety limits.
- Python SDK: Full robot control from Python — scripts, control loops, and on-robot code.
- 🤗Share your app with the community
- 📂 Browse the Examples Folder
- 📓 Tutorial Notebooks: Step-by-step Jupyter notebooks covering connection, movement, camera, and audio
🤖 AI-Assisted Development
Using an AI coding agent (Claude Code, Codex, Copilot, etc.)? You can start building apps right away. Paste this prompt to your agent:
I'd like to create a Reachy Mini app. Start by reading https://github.com/pollen-robotics/reachy_mini/blob/main/AGENTS.md
This AGENTS.md guide gives AI agents everything they need: SDK patterns, best practices, example apps, and step-by-step skills.
Quick Look
Most Reachy Mini apps are web / JS apps: a static page that drives the robot over WebRTC from any browser, with zero install for whoever uses it — this is the recommended path for new apps (see the JavaScript SDK & Web Apps guide).
Prefer to stay in Python for on-robot control loops? After installing the SDK, once your robot is awake, you can control it in just a few lines of code:
from reachy_mini import ReachyMini
from reachy_mini.utils import create_head_pose
with ReachyMini() as mini:
# Look up and tilt head
mini.goto_target(
head=create_head_pose(z=10, roll=15, degrees=True, mm=True),
duration=1.0
)
🛠 Hardware Overview
Reachy Mini robots are sold as kits and generally take 2 to 3 hours to assemble. Detailed step-by-step guides are available in the platform-specific folders linked above.
- Reachy Mini (Wireless): Runs onboard (RPi CM4), autonomous, includes IMU. See specs.
- Reachy Mini Lite: Runs on your PC, powered via wall outlet. See specs.
❓ Troubleshooting
Encountering an issue? 👉 Check the Troubleshooting & FAQ Guide
🤝 Community & Contributing
- Join the Community: Join Discord to share your moments with Reachy, build apps together, and get help.
- Found a bug? Open an issue on this repository.
- Guidelines: Review our contributing guidelines to learn how to contribute code, report issues, or suggest features.
License
This project is licensed under the Apache 2.0 License. See the LICENSE file for details. Hardware design files are licensed under Creative Commons BY-SA-NC.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file reachy_mini-1.10.0rc5.tar.gz.
File metadata
- Download URL: reachy_mini-1.10.0rc5.tar.gz
- Upload date:
- Size: 24.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7f33454a8b0f97fce75da1a7ad2dc8942ac776980773484450a91c4f09fbe138
|
|
| MD5 |
75b5a336672ef3fd9be609d79d54610e
|
|
| BLAKE2b-256 |
3a1d160cb45d92b05642d1d8d792126bbb866788601cacc4f15f2ef55076b8dd
|
Provenance
The following attestation bundles were made for reachy_mini-1.10.0rc5.tar.gz:
Publisher:
wheels.yml on pollen-robotics/reachy_mini
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
reachy_mini-1.10.0rc5.tar.gz -
Subject digest:
7f33454a8b0f97fce75da1a7ad2dc8942ac776980773484450a91c4f09fbe138 - Sigstore transparency entry: 2448659755
- Sigstore integration time:
-
Permalink:
pollen-robotics/reachy_mini@1adf25bee28815134106f2297c264a1ff889642c -
Branch / Tag:
refs/heads/main - Owner: https://github.com/pollen-robotics
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
wheels.yml@1adf25bee28815134106f2297c264a1ff889642c -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file reachy_mini-1.10.0rc5-py3-none-any.whl.
File metadata
- Download URL: reachy_mini-1.10.0rc5-py3-none-any.whl
- Upload date:
- Size: 24.2 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9769ca13b6a0fc151729097b75edc4dd66b95435078416824cf7fec60df27b6a
|
|
| MD5 |
6fd055207382fef2b6ed475f896cbe79
|
|
| BLAKE2b-256 |
07302c9e0501d4bb5935fb0ec985095cbd3be3613b7aa5c4893647eb80093407
|
Provenance
The following attestation bundles were made for reachy_mini-1.10.0rc5-py3-none-any.whl:
Publisher:
wheels.yml on pollen-robotics/reachy_mini
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
reachy_mini-1.10.0rc5-py3-none-any.whl -
Subject digest:
9769ca13b6a0fc151729097b75edc4dd66b95435078416824cf7fec60df27b6a - Sigstore transparency entry: 2448660184
- Sigstore integration time:
-
Permalink:
pollen-robotics/reachy_mini@1adf25bee28815134106f2297c264a1ff889642c -
Branch / Tag:
refs/heads/main - Owner: https://github.com/pollen-robotics
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
wheels.yml@1adf25bee28815134106f2297c264a1ff889642c -
Trigger Event:
workflow_dispatch
-
Statement type:
