reachy-mini-bwc 1.3.1.post1

Brain Wave Collective maintained fork of reachy-mini (originally developed by Pollen Robotics).

⚠️ reachy-mini-bwc — Brain Wave Collective Maintained Fork

Important: This package (reachy-mini-bwc) is a maintained fork of the official reachy-mini SDK developed by Pollen Robotics.

Official upstream project: https://github.com/pollen-robotics/reachy_mini

If you are not using Brain Wave Collective software or Anima integrations, you most likely want the official package and NOT this repo:

pip install reachy-mini

Why does this fork exist?

reachy-mini-bwc exists to provide a version of the Reachy Mini SDK that is:

• Compatible with Anima
• Compatible with Anima Reachy Conversation
• Compatible with other Brain Wave Collective integrations
• Released independently when upstream dependency constraints conflict with BWC systems

This fork applies minimal changes to upstream reachy-mini, primarily limited to:

• Dependency resolution adjustments
• Version coordination with BWC ecosystem components

We do not modify core robot functionality unless explicitly documented.

Version Mapping

reachy-mini-bwc	Upstream reachy-mini	Notes
1.3.1.post1	1.3.1	Dependency adjustments for Anima compatibility

Future releases will document their upstream base version in this table.

Attribution

Original SDK:

• © Pollen Robotics
• https://github.com/pollen-robotics/reachy_mini

This fork:

• Maintained by Brain Wave Collective
• https://brainwavecollective.ai

All original licensing from upstream is preserved.

---

Reachy Mini 🤖

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

🛒 Buy Reachy Mini

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

• Installation: 5 minutes to set up your computer
• Quickstart Guide: Run your first behavior on Reachy Mini
• Python SDK: Learn to move, see, speak, and hear.
• AI Integrations: Connect LLMs, build Apps, and publish to Hugging Face.
• Core Concepts: Architecture, coordinate systems, and safety limits.
• 🤗Share your app with the community
• 📂 Browse the Examples Folder

🤖 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.