项目>Reachy Mini>版本辨识:Lite、Wireless、仿真与 SDK 版本怎么对齐

版本辨识:Lite、Wireless、仿真与 SDK 版本怎么对齐

摘要:靠供电方式、连接方式和有没有 CM4 判断自己手里是哪一版,并锁定 SDK 主线版本与抓取日期,避免照着过期教程装环境。

判断你手里是哪一版

三个问题就能判断手里是哪一版:怎么供电、怎么连接、有没有 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 抓取」,不作实时统计。

资料来源

  • 官方 README
  • 双平台硬件数据手册
  • 安装指南官方页
  • PyPI 包元数据
  • GitHub 版本发布记录

相关内容

Reachy Mini 深拆:399 美元的开源桌面机器人实践