Skip to main content

⚠️ Notice: This is a Brain Wave Collective Maintained Fork

This repository is a fork of the original upstream project.

It exists to maintain compatibility with Brain Wave Collective systems and may include dependency or version adjustments that differ from upstream.

If you are not using Brain Wave Collective software, you likely want the official upstream project instead.

All original licensing and attribution are preserved.


Reachy Mini 🤖

Ask on HuggingChat Discord

Reachy Mini is an open-source, expressive robot made for hackers and AI builders.

🛒 Buy Reachy Mini

Reachy Mini Hello

⚡️ 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 4 + 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

🤖 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/develop/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

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 4), 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.

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.

Metadata

Release files for reachy-mini-bwc 1.3.1.post2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reachy-mini-bwc 1.3.1.post2
File Size Uploaded Provenance Actions
reachy_mini_bwc-1.3.1.post2.tar.gz 3.0 MB Without provenance Details for reachy_mini_bwc-1.3.1.post2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for reachy-mini-bwc 1.3.1.post2
File Interpreter ABI Platform Actions
reachy_mini_bwc-1.3.1.post2-py3-none-any.whl Python 3 none any Details for reachy_mini_bwc-1.3.1.post2-py3-none-any.whl

Total release size: 6.2 MB

Release files / reachy_mini_bwc-1.3.1.post2.tar.gz

Download URL reachy_mini_bwc-1.3.1.post2.tar.gz
Size 3.0 MB
Tags Source
SHA-256 checksum
How to use checksums
017d074f8bba1f09c0cfde46bbc81b78ff77ff551697c83668f87e803fb66520
BLAKE2b-256 checksum
How to use checksums
30751954e7044f56022282bed319f105b3202f07d319f4ab5a33d574463160be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / reachy_mini_bwc-1.3.1.post2-py3-none-any.whl

Download URL reachy_mini_bwc-1.3.1.post2-py3-none-any.whl
Size 3.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
1405ef71b95794e3389959a084ba2449e4b78f6b51e7be5dd6c6b6f943d49e7f
BLAKE2b-256 checksum
How to use checksums
f79138698f68b0e01fa16b05d3958f53e15375a4c912657d6f1012c6ab41592e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Security for reachy-mini-bwc 1.3.1.post2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page