正在连接信源…

Reachy Mini 复刻全流程

Reachy Mini 从采购、打印、组装到装软件、标定和训练的 159 个步骤,附物料表、购买链接与官方出处。

Lite 399 美元(需电脑)、Wireless 499 美元(自带计算),币种未写明;交付最长 90 天

采购

  • 购买 Reachy Mini

    购买 Reachy Mini,开始搭建或使用自己的机器人。

  • 获取 Reachy Mini 套件

    Reachy Mini 有 Wireless 和 Lite 两种型号:Wireless 使用 RPi CM4 板载运行并包含 IMU;Lite 在 PC 上运行并使用墙插电源。

  • 购买 Hoverboard 底座

    为 Reachy Mini Wireless 购买售价 149 美元的 Hoverboard。它到货时已完成组装,包含两个轮子、柔软轮胎、内置电池、内置电子设备、蓝牙、Wi-Fi 和 USB-C。

  • 购买 NFC 配件包

    为 Reachy Mini Wireless 或 Reachy Mini Lite 购买售价 35 美元的 NFC 配件包。包装内含三顶帽子、一个 NFC 模块、四个 NFC 标签和八个磁铁。

组装

  • 组装 Reachy Mini 套件

    按照纸质指南和分步视频组装套件,随附螺丝刀和工具。盒内包含所有物品,无需焊接,组装约需 2.5 小时。

  • 安装 NFC 模块

    使用模块电路板、3D 打印支架、电缆和螺钉自行安装小型 NFC 模块。

  • 组装机器人

    按照所选机器人对应平台文件夹中的分步指南组装。组装通常需要 2 到 3 小时。

软件与固件

  • 使用 curl 安装 uv

    使用 curl 下载独立安装脚本,并通过 sh 执行。

  • 使用 wget 安装 uv

    如果系统没有 curl,可以使用 wget 下载安装脚本,并通过 sh 执行。

  • 安装指定版本的 uv

    在安装脚本 URL 中包含版本 0.13.7,以安装该指定版本。

  • 使用 PowerShell 安装 uv

    使用 irm 下载 PowerShell 安装脚本,并通过 iex 执行。

  • 使用 PowerShell 安装 uv 0.13.7

    在 PowerShell 安装脚本 URL 中包含版本 0.13.7,以安装该指定版本。

  • 检查 Shell 安装脚本

    使用 less 在使用前查看安装脚本。

  • 检查 PowerShell 安装脚本

    使用 more 在使用前查看 PowerShell 安装脚本。

  • 从 GitHub 下载 uv

    也可以直接从 GitHub 下载安装脚本或 uv 二进制文件。

  • 使用 pipx 安装 uv

    使用 pipx 将 uv 安装到隔离环境中。

  • 使用 pip 安装 uv

    也可以使用 pip 安装 uv。

  • 准备源码构建

    如果平台没有预构建 wheel,uv 将从源码构建,这需要 Rust 工具链。

  • 使用 Homebrew 安装 uv

    从 Homebrew 核心软件包安装 uv。

  • 使用 Cargo 安装 uv

    通过 Cargo 从 crates.io 安装 uv。此方法会从源代码构建 uv,因此需要兼容的 Rust 工具链。

  • 更新独立安装的 uv

    通过独立安装器安装的 uv 可以按需自行更新。设置 UV_NO_MODIFY_PATH=1 可防止更新程序修改 shell 配置文件。

  • 使用 pip 升级 uv

    使用其他方法安装 uv 时,自更新功能会被禁用。请改用相应包管理器的升级方法。

  • 确定当前 Shell

    运行 echo $SHELL 以帮助确定需要更新哪个 shell 配置文件。

  • 为 uv 启用 Bash 补全

    将 uv 的 shell 补全命令添加到 Bash 配置文件中。

  • 为 uv 启用 Zsh 补全

    将 uv 的 shell 补全命令添加到 Zsh 配置文件中。

  • 为 uv 启用 Fish 补全

    创建 Fish 补全文件,并加载生成的 uv 补全。

  • 为 uv 启用 Elvish 补全

    将 uv 的 shell 补全命令添加到 Elvish 配置文件中。

  • 为 uv 启用 PowerShell 补全

    如果 PowerShell 配置文件不存在,则创建该文件,然后将生成的 uv 补全命令添加到配置文件中。

  • 为 uvx 启用 Bash 补全

    将 uvx 的 shell 补全命令添加到 Bash 配置文件中。

  • 为 uvx 启用 Zsh 补全

    将 uvx 的 shell 补全命令添加到 Zsh 配置文件中。

  • 为 uvx 启用 Fish 补全

    创建 Fish 补全文件,并加载生成的 uvx 补全。

  • 为 uvx 启用 Elvish 补全

    将 uvx 的 shell 补全命令添加到 Elvish 配置文件中。

  • 为 uvx 启用 PowerShell 补全

    如果 PowerShell 配置文件不存在,则创建该文件,然后将生成的 uvx 补全命令添加到配置文件中。

  • 激活 Shell 补全

    启用补全后,重启 shell 或重新加载 shell 配置文件。

  • 更新操作系统证书

    先更新操作系统的证书,再处理各 Python 环境中的 pip、certifi 与 uv。

  • 在每个 Python 环境中引导安装已修补的 pip

    在每个已存在的 Python 环境中,用通告中经 SHA-256 校验的 wheel 引导安装 pip 26.2.2;把该环境的 Python 可执行文件用作命令中的 python。

  • 升级 certifi 到 2026.10.19 以上

    在每个 Python 环境中升级 certifi 到 2026.10.19 或更新版本,以停止信任被入侵的 eMudhra 证书颁发机构。

  • 在无线版上更新两个虚拟环境

    在 Wireless 上这包括 /venvs/mini_daemon/bin/python 和 /venvs/apps_venv/bin/python(若存在)。

  • 按原安装方式更新 uv

    按最初安装 uv 所用的方法更新它:独立安装的 uv 重新运行第 1 步的安装器,用 pip 安装的 uv 则用已修补的 pip 升级。

  • 更新环境后重启守护进程和应用

    更新各自环境后,重启守护进程(daemon)和应用。

  • 打开命令行

    Windows 按 Win + R,输入 cmd 或 powershell 后按 Enter。macOS 按 Cmd + Space,输入 Terminal 后按 Enter。Linux 按 Ctrl + Alt + T,或在应用程序中搜索 Terminal。

  • 在 Linux 或 macOS 安装 uv

    在终端中运行安装脚本,为项目安装 uv Python 包管理器。

  • 在 Windows 安装 uv

    在 Windows 终端中运行 PowerShell 安装脚本,为项目安装 uv Python 包管理器。

  • 验证 uv 安装

    安装完成后关闭终端并重新打开,然后运行 uv --version 检查安装。

  • 安装 Python 3.12

    通过 uv 安装 Python 3.12,并将其设为默认版本。文档推荐 Python 3.12,因为它是 Reachy Mini 最新支持的版本。

  • 在 Linux 上安装 Git 和 Git LFS

    在终端中安装 Git 和 Git LFS。

  • 安装 Homebrew

    如果尚未安装 Homebrew,请在终端中运行其安装命令。

标定与测试

  • 重载 udev 规则并加入 dialout 组

    重新加载 udev 规则并触发设备,同时把当前用户加入 dialout 组。

  • 注销并重新登录使设置生效

    注销并重新登录,使 USB 权限和组成员设置生效。

  • 验证守护进程 API 文档

    在 Lite 或模拟模式下打开 `http://localhost:8000/docs`;在无线模式下打开 `http://reachy-mini.local:8000/docs`。看到 Reachy SDK API 文档即表示已准备就绪。

  • 运行天线摆动测试

    将提供的脚本保存为 hello.py,然后在新终端中运行。脚本会连接正在运行的守护进程并摆动天线;如果一切正常,机器人现在应该会摆动天线。

  • 测试头部运动

    使用 ReachyMini 将头部向上看并倾斜:位移 10 毫米、角度 15 度,持续 1 秒。

  • 验证 SDK 安装

    运行快速测试以确认 SDK 已安装。如果测试失败,请在标记设置完成前进行调试。

  • 通过麦克风测试对话

    使用麦克风向 Reachy 提问并听取语音回答。示例中,它会回答章鱼有三颗心脏,并表示可以再告诉你一个有趣的事实。

采数据与训练

  • 录制并分享动作

    使用 Marionette 录制动作并将其作为数据集分享。每台 Reachy Mini 都可以播放录制的动作。

用起来

  • 使用 Conversation App 对话

    安装并打开 Conversation App,然后自然地与 Reachy Mini 对话;该应用由大语言模型驱动。

  • 收听电台

    安装并打开 Radio 应用,通过 Reachy Mini 收听电台。

  • 使用 Hand Tracker 跟随手部动作

    安装并打开 Hand Tracker 应用,让 Reachy Mini 实时跟随你的手部动作。

  • 开发网页应用

    按照 JavaScript SDK 与网页应用指南,创建通过 WebRTC 从任意浏览器控制机器人的静态页面。这是新应用的推荐方式。

  • 排查机器人问题

    遇到问题时,查阅故障排查与常见问题指南。

  • Import the Reachy Mini Python SDK

    在 Python 脚本中导入 ReachyMini 和 create_head_pose。

  • 控制机器人抬头并侧倾

    创建 ReachyMini 实例,将头部目标设置为向上 10 毫米、侧倾 15 度,并让动作持续 1.0 秒。

  • 浏览可直接运行的示例脚本

    打开 Examples Folder,浏览用于理解机器人特定功能的现成脚本。

  • 选择可用机器人

    监听 robotsChanged 事件,并在事件数据中读取机器人 ID 和名称列表。

  • 启动 WebRTC 会话

    将视频元素传给 attachVideo(),然后使用所选机器人的 ID 调用 startSession()。

  • 发送机器人动作命令

    使用角度辅助函数控制头部、触角和身体偏航,并播放 wake_up.wav 声音。

  • 与 Reachy Mini 对话

    向 Reachy Mini 提问并聆听回答,即可使用内置对话功能。该系统使用你的麦克风、扬声器和摄像头,Reachy 会在说话时看着你。

  • 使用手机驾驶 Hoverboard

    使用手机上的 Reachy Mini 应用驾驶机器人,并通过摄像头查看房间。

  • 扣上配件帽子

    将其中一顶帽子扣在 Reachy Mini 上即可切换其角色。包装内含厨师帽、带宝石的皇冠和带羽毛的海盗帽。

  • 保存并运行脚本

    保存文件,在新终端中运行 `python hello.py`。如果一切正常,机器人现在应该会摆动天线。

  • 检查故障排除指南

    遇到问题时,查看《Troubleshooting & FAQ Guide》故障排除与常见问题指南。

  • 在机器人本机运行脚本

    在 Reachy Mini 本机运行脚本时使用标准的 ReachyMini() 构造函数,Auto 模式会将连接保持在 localhost,除非显式覆盖。优点是延迟更低、无需网络依赖、可直接访问所有机器人资源;缺点是 CPU 性能较低且没有 GUI。

数据集

物料

  • 摄像头、4 麦克风、扬声器(两版相同)
  • Lite 版用 USB 连接 Mac/PC 作大脑

工具

  • 是否需自行组装官网未写

技能

  • JavaScript SDK(npm)或仓库源码
  • Hugging Face Spaces 应用

软件

  • @pollen-robotics/reachy-mini-sdk
  • Hugging Face 应用与数据集

文档