Metadata-Version: 2.4
Name: reachy_mini
Version: 1.2.2
Author-email: Pollen Robotics <contact@pollen-robotics.com>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=2.2.5
Requires-Dist: scipy<2.0.0,>=1.15.3
Requires-Dist: reachy_mini_motor_controller>=1.4.2
Requires-Dist: eclipse-zenoh~=1.7.0
Requires-Dist: opencv-python<=5.0
Requires-Dist: cv2_enumerate_cameras>=1.2.1
Requires-Dist: psutil
Requires-Dist: jinja2
Requires-Dist: uvicorn[standard]
Requires-Dist: fastapi
Requires-Dist: pyserial
Requires-Dist: huggingface-hub==0.34.4
Requires-Dist: sounddevice==0.5.1
Requires-Dist: soundfile==0.13.1
Requires-Dist: reachy-mini-rust-kinematics>=1.0.3
Requires-Dist: asgiref
Requires-Dist: aiohttp
Requires-Dist: log-throttling==0.0.3
Requires-Dist: pyusb>=1.2.1
Requires-Dist: libusb_package>=1.0.26.3
Requires-Dist: pip>=25
Requires-Dist: rich
Requires-Dist: questionary
Requires-Dist: websockets<16,>=12
Requires-Dist: toml
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-asyncio; extra == "dev"
Requires-Dist: ruff==0.12.0; extra == "dev"
Requires-Dist: onshape-to-robot==1.7.6; extra == "dev"
Requires-Dist: mujoco==3.3.0; extra == "dev"
Requires-Dist: placo==0.9.14; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: mypy==1.18.2; extra == "dev"
Requires-Dist: rustypot>=1.4.0; extra == "dev"
Requires-Dist: types-requests; extra == "dev"
Requires-Dist: types-toml; extra == "dev"
Requires-Dist: rerun-sdk>=0.27.2; extra == "dev"
Requires-Dist: urdf-parser-py==0.0.4; extra == "dev"
Provides-Extra: examples
Requires-Dist: pynput; extra == "examples"
Provides-Extra: mujoco
Requires-Dist: mujoco==3.3.0; extra == "mujoco"
Provides-Extra: nn-kinematics
Requires-Dist: onnxruntime==1.22.1; extra == "nn-kinematics"
Provides-Extra: placo-kinematics
Requires-Dist: placo==0.9.14; extra == "placo-kinematics"
Provides-Extra: gstreamer
Requires-Dist: PyGObject<=3.46.0,>=3.42.2; extra == "gstreamer"
Requires-Dist: gst-signalling>=1.1.2; extra == "gstreamer"
Provides-Extra: rerun
Requires-Dist: rerun-sdk>=0.27.2; extra == "rerun"
Requires-Dist: urdf-parser-py==0.0.4; extra == "rerun"
Provides-Extra: wireless-version
Requires-Dist: semver<4,>=3; extra == "wireless-version"
Requires-Dist: nmcli>=1.5; extra == "wireless-version"
Requires-Dist: pollen_BMI088_imu_library; extra == "wireless-version"
Requires-Dist: gpiozero>=2.0.0; extra == "wireless-version"
Requires-Dist: lgpio>=0.2.2.0; extra == "wireless-version"
Dynamic: license-file

# Reachy Mini 🤖

[![Ask on HuggingChat](https://img.shields.io/badge/Ask_on-HuggingChat-yellow?logo=huggingface&logoColor=yellow&style=for-the-badge)](https://huggingface.co/chat/?attachments=https%3A%2F%2Fgist.githubusercontent.com%2FFabienDanieau%2F919e1d7468fb16e70dbe984bdc277bba%2Fraw%2Fdoc_reachy_mini_full.md&prompt=Read%20this%20documentation%20about%20Reachy%20Mini%20so%20I%20can%20ask%20questions%20about%20it.)
[![Discord](https://img.shields.io/badge/Discord-Join_the_Community-7289DA?logo=discord&logoColor=white)](https://discord.gg/2bAhWfXme9)

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

It removes the hardware complexity, allowing you to focus on what matters: building intelligent agents that can see, hear, and interact with the physical world.

[![Reachy Mini Hello](/docs/assets/reachy_mini_hello.gif)](https://www.pollen-robotics.com/reachy-mini/)

## 🚀 Getting Started

**Choose your platform to access the specific guide:**

| **🤖 Reachy Mini (Wireless)** | **🔌 Reachy Mini Lite** | **💻 Simulation** |
| :---: | :---: | :---: |
| The full autonomous experience.<br>Raspberry Pi 4 + Battery + WiFi. | The developer version.<br>USB connection to your computer. | No hardware required.<br>Prototype in MuJoCo. |
| [**👉 Go to Wireless Guide**](docs/platforms/reachy_mini/get_started.md) | [**👉 Go to Lite Guide**](docs/platforms/reachy_mini_lite/get_started.md) | [**👉 Go to Simulation**](docs/platforms/simulation/get_started.md) |

> ⚡ **Pro tip:** Install [uv](https://docs.astral.sh/uv/getting-started/installation/) for 10-100x faster app installations (auto-detected, falls back to `pip`).

<br>

## 📱 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](https://huggingface.co/spaces/pollen-robotics/reachy_mini_conversation_app):** Talk naturally with Reachy Mini (powered by LLMs).
* **📻 [Radio](https://huggingface.co/spaces/pollen-robotics/reachy_mini_radio):** Listen to the radio with Reachy Mini !
* **👋 [Hand Tracker](https://huggingface.co/spaces/pollen-robotics/hand_tracker_v2):** The robot follows your hand movements in real-time.

[**👉 Browse all apps on Hugging Face**](https://pollen-robotics-reachy-mini-landing-page.hf.space/#/apps)

<br>

## 🐍 Software & SDK

Once your robot (or simulation) is running, the code is the same!
Control your Reachy Mini with Python to create movements, build apps, and connect AI models.

You will find the Installation guide, Quickstart, and API Reference in the SDK documentation.

[**👉 Go to SDK Documentation**](docs/SDK/readme.md)

<br>

## 🛠 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](docs/platforms/reachy_mini/hardware.md).
* **Reachy Mini Lite:** Runs on your PC, powered via wall outlet. [See specs](docs/platforms/reachy_mini_lite/hardware.md).

[**🛒 Buy Reachy Mini**](https://www.hf.co/reachy-mini/)

<br>

## ❓ Troubleshooting

Encountering an issue? 👉 **[Check the Troubleshooting & FAQ Guide](/docs/troubleshooting.md)**

<br>

## 🤝 Community & Contributing

Reachy Mini is a collaborative project between [Pollen Robotics](https://www.pollen-robotics.com) and [Hugging Face](https://huggingface.co/).

* **Join the Community:** We use [Discord](https://discord.gg/2bAhWfXme9) to share our moments with Reachy, build apps together, and get help.
* **Found a bug?** Open an issue on this repository.
* **Created an App?** Share it on [Hugging Face Spaces](https://huggingface.co/spaces?q=reachy_mini).

## License

This project is licensed under the Apache 2.0 License. See the [LICENSE](LICENSE) file for details.
Hardware design files are licensed under Creative Commons BY-SA-NC.
