How to build Reachy Mini: the whole process
159 steps to build Reachy Mini, from buying parts, printing and assembly to software, calibration and training, with the bill of materials, shop links and the official s…
Lite $399 (needs a computer), Wireless $499 (on-board compute), currency not stated; lead time up to 90 days
Buy parts
- Buy a Reachy Mini
Purchase Reachy Mini to build or start your own robot.
- Obtain a Reachy Mini kit
Reachy Mini is available as the Wireless model, which runs onboard an RPi CM4 and includes an IMU, or the Lite model, which runs on your PC and uses a wall outlet.
- Buy the Hoverboard base
Buy the $149 Hoverboard for Reachy Mini Wireless. It arrives fully assembled with two wheels, soft tires, a built-in battery, built-in electronics, Bluetooth, Wi-Fi, and USB-C.
- Buy the NFC Accessory Pack
Buy the $35 NFC Accessory Pack for Reachy Mini Wireless or Reachy Mini Lite. The pack includes three hats, an NFC module, four NFC tags, and eight magnets.
Assemble
- Assemble the Reachy Mini kit
Put the kit together using the printed guide and step-by-step video; the screwdriver and tools are included. Everything is supplied in the box, no soldering is required, and assembly takes about 2.5 hours.
- Install the NFC module
Install the small NFC module yourself using its board, 3D-printed mount, cable, and screws.
- Assemble the robot
Follow the step-by-step guide in the platform-specific folder for the chosen robot. Assembly generally takes 2 to 3 hours.
Software
- Install uv with curl
Download the standalone installer with curl and execute it with sh.
- Install uv with wget
If the system does not have curl, download the installer with wget and execute it with sh.
- Install a specific uv version
Include version 0.13.7 in the installer URL to request that specific version.
- Install uv with PowerShell
Use irm to download the PowerShell installation script and execute it with iex.
- Install uv 0.13.7 on PowerShell
Include version 0.13.7 in the PowerShell installer URL to request that specific version.
- Inspect the shell installer
Display the installation script with less before using it.
- Inspect the PowerShell installer
Display the PowerShell installation script with more before using it.
- Download uv from GitHub
Alternatively, download the installer or uv binaries directly from GitHub.
- Install uv with pipx
Install uv into an isolated environment using pipx.
- Install uv with pip
Install uv using pip instead.
- Prepare for source builds
If a prebuilt wheel is unavailable for the platform, uv is built from source and requires a Rust toolchain.
- Install uv with Homebrew
Install uv from the core Homebrew packages.
- Install uv with Cargo
Install uv from crates.io with Cargo. This builds uv from source and requires a compatible Rust toolchain.
- Update a Standalone uv Installation
A uv installation made with the standalone installer can update itself on demand. Set UV_NO_MODIFY_PATH=1 to prevent the updater from modifying shell profiles.
- Upgrade uv with pip
When uv was installed with another method, self-updates are disabled. Use the package manager's upgrade method instead.
- Identify Your Shell
Run echo $SHELL to help determine which shell configuration file to update.
- Enable Bash Completion for uv
Add the uv shell-completion command to the Bash configuration file.
- Enable Zsh Completion for uv
Add the uv shell-completion command to the Zsh configuration file.
- Enable Fish Completion for uv
Create a Fish completions file that sources the generated uv completions.
- Enable Elvish Completion for uv
Add the uv shell-completion command to the Elvish configuration file.
- Enable PowerShell Completion for uv
Create the PowerShell profile file if it does not exist, then add the generated uv completion command to the profile.
- Enable Bash Completion for uvx
Add the uvx shell-completion command to the Bash configuration file.
- Enable Zsh Completion for uvx
Add the uvx shell-completion command to the Zsh configuration file.
- Enable Fish Completion for uvx
Create a Fish completions file that sources the generated uvx completions.
- Enable Elvish Completion for uvx
Add the uvx shell-completion command to the Elvish configuration file.
- Enable PowerShell Completion for uvx
Create the PowerShell profile file if it does not exist, then add the generated uvx completion command to the profile.
- Activate Shell Completions
Restart the shell or source the shell configuration file after enabling completions.
- Update the operating system certificates
First update the operating system's certificates, then handle pip, certifi and uv in each Python environment.
- Bootstrap patched pip in each Python environment
In each existing Python environment, bootstrap pip 26.2.2 with the notice's SHA-256-verified wheel, using that environment's Python executable in place of `python`.
- Upgrade certifi to 2026.10.19 or newer
Upgrade certifi to 2026.10.19 or newer in each Python environment to stop trusting the compromised eMudhra certificate authorities.
- Update both Wireless virtual environments
On Wireless this includes /venvs/mini_daemon/bin/python and /venvs/apps_venv/bin/python, when present.
- Update uv the way it was installed
Update uv through the method originally used to install it: rerun the installer in Step 1 for standalone uv, or use the patched pip for pip-installed uv.
- Restart the daemon and apps
Restart the daemon and the apps after updating their environments.
- Open the command line
On Windows, press Win + R, type cmd or powershell, and press Enter. On macOS, press Cmd + Space, type Terminal, and press Enter. On Linux, press Ctrl + Alt + T or search for Terminal in your applications.
- Install uv on Linux or macOS
Run the installation script in your terminal to install the uv Python package manager.
- Install uv on Windows
Run the PowerShell installation script in your Windows terminal to install the uv Python package manager.
- Verify the uv installation
After installation completes, close the terminal, open a new one, and run uv --version to verify the installation.
- Install Python 3.12
Use uv to install Python 3.12 and set it as the default version. The document recommends Python 3.12 because it is the latest supported version for Reachy Mini.
- Install Git and Git LFS on Linux
Install Git and Git LFS in the terminal.
- Install Homebrew
If Homebrew is not already installed, run its installation command in the terminal.
Calibrate and test
- Reload udev rules and join dialout group
Reload the udev rules and trigger them, and add the current user to the dialout group.
- Log out and back in for changes to apply
Log out and log back in so the USB permission and group membership changes take effect.
- Verify the Daemon API Documentation
Open `http://localhost:8000/docs` on Lite or Simulation, or `http://reachy-mini.local:8000/docs` on Wireless. You are ready when the Reachy SDK API documentation appears.
- Run the antenna wiggle test
Save the provided script as hello.py, then run it in a new terminal. The script connects to the running daemon and wiggles the antennas; if everything went well, the robot should wiggle its antennas.
- Test head movement
Use ReachyMini to look up and tilt the head by 10 mm and 15 degrees over 1 second.
- Verify the SDK Installation
Run a quick test to confirm the SDK is installed. If it fails, debug before marking setup complete.
- Test conversation through the microphone
Ask Reachy a question using the microphone and listen for its spoken answer. In the example, it replies that octopuses have three hearts and offers to tell you another fact.
Data and training
- Record and Share a Move
Use Marionette to record a move and share it as a dataset. Every Reachy Mini can play the recorded move.
Use it
- Talk with the Conversation App
Install and open the Conversation App, then talk naturally with Reachy Mini; the app is powered by LLMs.
- Listen to the radio
Install and open the Radio app to listen to the radio with Reachy Mini.
- Follow hand movements with Hand Tracker
Install and open the Hand Tracker app so Reachy Mini follows your hand movements in real time.
- Build a web app
Follow the JavaScript SDK & Web Apps guide to create a static page that drives the robot over WebRTC from any browser. This is the recommended path for new apps.
- Troubleshoot the robot
If you encounter an issue, use the Troubleshooting & FAQ Guide.
- Import the Reachy Mini Python SDK
Import ReachyMini and create_head_pose in a Python script.
- Make the robot look up and tilt
Create a ReachyMini instance, set the head target to 10 mm up and a 15-degree roll, and make the movement last 1.0 second.
- Browse ready-to-run example scripts
Open the Examples Folder and browse the ready-made scripts for understanding specific robot features.
- Pick an available robot
Listen for robotsChanged and read the robot IDs and names from the event data.
- Start a WebRTC session
Pass the video element to attachVideo(), then call startSession() with the selected robot ID.
- Send robot motion commands
Control the head, antennas, and body yaw with degree-based helpers, then play the wake_up.wav sound.
- Talk with Reachy Mini
Use Reachy Mini for spoken conversation by asking questions and listening to its answers. The built-in conversation system uses your microphone, speaker, and camera, and Reachy looks at you while speaking.
- Drive the Hoverboard from your phone
Use the Reachy Mini app on your phone to drive the robot and see the room through its camera.
- Snap on an accessory hat
Snap one of the hats onto Reachy Mini to switch its personality. The pack includes a chef hat, a crown with gems, and a pirate hat with a feather.
- Save and run the script
Save the file and run `python hello.py` in the new terminal. If everything went well, the robot should now wiggle its antennas.
- Check the troubleshooting guide
If you encounter an issue, check the Troubleshooting & FAQ Guide.
- Run scripts locally on the robot
When running scripts on the Reachy Mini itself, use the standard ReachyMini() constructor; Auto mode keeps the connection on localhost unless you explicitly override it. Benefits: lower latency, no network dependency, direct access to all robot resources. Drawbacks: lower CPU power and no GUI available.
Datasets
- tfrere/reachy-mini-move-previews
- pollen-robotics/reachy-mini-emotions-library
- pollen-robotics/reachy-mini-wall-data
- pollen-robotics/reachy-mini-dances-library
- BastienATOS/mini-reachy-animation
- tfrere/reachy-mini-generated-moves
- binhpham/reachy-mini-motion-synth
- FabienDanieau/reachy-mini-detection-dataset-v2
Parts
- Camera, 4 microphones, speaker (both versions)
- Lite uses a Mac/PC over USB as the brain
Tools
- Whether assembly is required is not stated
Skills
- JavaScript SDK (npm) or the repo source
- Hugging Face Spaces apps
Software
- @pollen-robotics/reachy-mini-sdk
- Hugging Face apps and datasets