Connecting to sources…

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

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

Documents