判断你手里是哪一版
三个问题就能判断手里是哪一版:怎么供电、怎么连接、有没有 CM4 计算模块。对照下表:
| 判断项 | Reachy Mini Wireless | Reachy Mini Lite |
|---|---|---|
| 计算模块 | 有,树莓派 CM4(型号 CM4104016,4GB RAM / 16GB flash,带 WiFi) | 没有,计算由所接电脑承担 |
| 供电 | LiFePO4 电池 2000 mAh / 6.4 V / 12.8 Wh,带过充过放过流短路保护与温度传感 | 墙电电源;USB-C 仅走数据,不充电 |
| 连接与接口地址 | WiFi(2.4–5 GHz 双频贴片天线),daemon 地址 reachy-mini.local:8000
|
USB 线接电脑,daemon 地址 localhost:8000
|
| IMU | 有 | 没有 |
| 重量 | 1.475 kg | 1.350 kg |
| daemon | 跑在板内,开机自启 | 跑在电脑上,桌面 App 或命令行启动 |
什么都不用买还有第三种:Simulation,在 MuJoCo 里跑同一套 SDK。行为等同 Lite 经 USB 连接,daemon 监听 localhost,脚本不用改。
名字与代次口径
「Reachy Mini」既指产品线(三个入口的总称),也单独指 Wireless 单机——Wireless 的上手指南标题就是「Reachy Mini (Wireless)」。官方没有「V2」这类代次命名,Wireless 与 Lite 是并列在售的两个版本,不是新旧两代。本 Wiki 项目层名字不带后缀,正文提到具体机器一律带 Lite / Wireless;读到不带后缀的说法,先确认它指的是哪一个。
三套版本号,互不换算
查资料最容易踩的坑是把三套数字当成一回事:
| 版本号 | 属于什么 | 主线值 / 官方下限 |
|---|---|---|
| SDK 版本 | 你安装的 reachy-mini 包与 GitHub 仓库 | 1.14.0 |
| 机器人软件版本 | Wireless 板内运行的机器人软件 | 1.2.3+ |
| 板卡固件版本 | 机器人板卡的固件 | 2.1.4+ |
SDK 升到 1.14.0 不等于机器人软件是 1.14.0,更不等于固件是 1.14.0——「固件 1.14.0」这种组合不存在。机器人软件与固件的升级走桌面应用的 System Updates,与升级 SDK 是两码事。
SDK 主线:锁定 1.14.0(抓取日期 2026-11-15)
名字口径:PyPI 包名 reachy-mini,import 名 reachy_mini(下划线),仓库名也是 reachy_mini,Linux daemon 命令是 reachy-mini-daemon(连字符),四种写法别混写。截至 2026-11-15 抓取:PyPI 上共 79 个 release,最新 1.14.0 于 2026-11-05 上传,包元数据 requires-python >=3.11;GitHub 共 70 个 release / 86 个 tag,最新 v1.14.0 发布于 2026-11-03,标题提到 busy-move 错误修复、全客户端遥测与 Windows 音频修复。仓库主干 pyproject 写的是 1.14.0.dev0 开发版号,安装以发布版为准。近几个版本的发布节奏(首个 release 1.0.0rc1 发布于 2025-10-15):
| 版本 | PyPI 上传日期 |
|---|---|
| 1.14.0 | 2026-11-05 |
| 1.14.0rc2 | 2026-11-04 |
| 1.14.0rc1 | 2026-11-03 |
| 1.13.0 | 2026-10-26 |
| 1.12.0 | 2026-10-15 |
| 1.11.0 | 2026-09-21 |
| 1.10.0 | 2026-08-25 |
Python 版本要求:官方两处口径不一致
官方两处口径并列,以你实际安装的包元数据为准:
| 出处 | 口径 |
|---|---|
| 官方安装页前置表 | Python 3.10–3.12,并推荐 3.12 |
| pyproject 与 PyPI 1.14.0 包元数据 | requires-python >=3.11 |
安装命令本身没有分歧,官方推荐用 uv 管理:
uv python install 3.12 --default uv venv reachy_mini_env --python 3.12 uv pip install "reachy-mini"
装 3.12 同时满足两处口径。两条中文流传的版本说法可以放下了:「Python 3.8 以上即可」在官方现行材料里没有依据;「Python 3.10+」是旧时代口径——1.2.7(2026-01-07 发布)的元数据确实是 >=3.10,但主线 1.14.0 已是 >=3.11,照过期教程配环境容易直接装不上。Linux、macOS、Windows 三端官方均标注支持,Windows 有独立的安装小节;前置工具 Git 与 Git LFS,装好执行一次 git lfs install。2026-10 官方安全通告要求 certifi>=2026.10.19、pip>=26.2.2、uv>=0.13.4,Wireless 板内用于 daemon 和应用的两个 Python 环境都要处理。
硬件规格对照
两版共用同一套身体,差异集中在计算与供电:
| 项目 | 数值 |
|---|---|
| 尺寸(展开) | 30×20×15.5 cm |
| 重量 | Lite 1.350 kg / Wireless 1.475 kg |
| 材料 | ABS / PC / 铝 / 钢 |
| 自由度 | 9:Head 6(3 旋转 + 3 平移)+ Body 1 + Antennas 2 |
| 电机 | Base 1× Dynamixel XC330-M288-PG(定制款,塑料齿轮);Stewart 平台 6× XL330-M288-T;Antennas 2× XL330-M077-T |
| 电机 ID / 波特率 | ID 10–18(body_rotation 10、stewart 11–16、右天线 17、左天线 18);波特率 1000000 |
| 供电输入 | 6.8–7.6 V |
| 相机 | Raspberry Pi Camera v3 wide(Sony IMX708 / 12MP / 自动对焦),视场 120° |
| 麦克风 | 4× PDM MEMS 数字麦,16 kHz 上限,-26 dBFS 灵敏度,64 dBA 信噪比,基于 XMOS XVF3800 方案 |
| 扬声器 | 5 W @4Ω |
许可证口径再确认一次:软件仓库采用 Apache 2.0,硬件设计文件采用 CC BY-SA-NC(非商业)。官方产品页的生态数字属营销口径,引用时标注「官方产品页 2026-11-15 抓取」,不作实时统计。