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。
数据集
- 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
物料
- 摄像头、4 麦克风、扬声器(两版相同)
- Lite 版用 USB 连接 Mac/PC 作大脑
工具
- 是否需自行组装官网未写
技能
- JavaScript SDK(npm)或仓库源码
- Hugging Face Spaces 应用
软件
- @pollen-robotics/reachy-mini-sdk
- Hugging Face 应用与数据集