Reachy Mini开源桌面机器人:3D打印运动控制到自定义行为的完整路径
Reachy Mini开源桌面机器人:3D打印运动控制到自定义行为的完整路径
【免费下载链接】reachy_miniReachy Mini's SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini
Reachy Mini 是一个会看、会听、会说、会动的开源桌面机器人:头部有六个自由度,接上麦克风阵列和广角摄像头,再用几行 Python 就能让它转头、追你的脸、跟你打招呼。如果你也想动手体验桌面机器人,又不想一上来就掏大几千买硬件、花半天时间拼装,它有个很讨巧的设计——不装硬件也能玩:在电脑上跑一个 MuJoCo 仿真,写的代码和驱动真机完全一样,改完直接就能在 3D 窗口里看效果。
📦 它是什么:一个可以先仿真、再上手的桌面机器人
Reachy Mini 由 Pollen Robotics 开发(Apache 2.0 协议),解决的问题很直接:想做一个"有表情、能交互"的小型机器人,但不想从零设计机械结构和驱动底层。它把硬件做成套件(约 2-3 小时拼好,结构件主要是 3D 打印),软件做成"机器人上跑守护进程 + 电脑上跑 SDK"的架构,所以你只需要关心行为逻辑本身。它适合三类人:想学机器人运动控制的学生、做 AI 交互应用的开发者、以及想验证控制算法的研究者。
几个具体的点:
- 9 个 Dynamixel 舵机:6 个驱动头部的斯图尔特平台、2 个摆天线、1 个转身体
- 三种接入方式:无线版(板载树莓派 CM4 + 电池 + WiFi)、Lite 版(USB 连电脑)、仿真版(MuJoCo,零硬件)
- 全套媒体硬件:120° 12MP 广角摄像头、4 麦克风阵列、5W 喇叭,支持声源定位和 TTS 语音
- 客户端-服务器架构:daemon 在机器人或电脑上管电机和安全限幅,Python / JavaScript SDK 通过网络发指令
Reachy Mini 的组件分解,头部斯图尔特平台、摄像头与麦克风阵列、树莓派 CM4 都清晰可见
🦾 三个值得留下来玩的能力
头里六个电机:斯图尔特平台带来的 6 自由度运动
普通桌面机器人头部多是 2-3 个舵机,做转头、点头;Reachy Mini 头部是一个六自由度斯图尔特平台——6 个电机并联支撑,能让头同时做 3 个方向的旋转和 3 个方向的平移。有用在哪?你可以让机器人"凑近看东西""歪头思考",头姿的自然程度完全不是串联机构能比的。技术上巧妙的一点:六个电机解耦成 6 自由度目标,靠的是实时的逆运动学求解,下面细说。
头部 6 自由度 + 身体 1 自由度 + 天线 2 自由度,是它"有表情"的机械基础
指个世界坐标,机器人自己算关节角
你写代码时从不碰关节角,而是说"头抬高 10 毫米、向左转 15 度",SDK 负责把它解算到 6 个电机电位。项目里内置了三套运动学后端,按需切换:
| 后端 | 特点 | 适合 |
|---|---|---|
| 神经网络(Rust + ONNX) | 速度最快,树莓派上也能跑 100Hz | 实时交互、追踪 |
| 解析运动学 | 闭式解,精度高 | 路径规划、标定 |
| Placo | 完整物理仿真,带重力补偿 | 物理实验、软模式控制 |
配合两套控制原语也很省心:goto_target()负责平滑过渡的"表情动作"(内置 minjerk 等四种插值曲线),set_target()负责 100Hz 控制循环里的实时反应,官方示例(如examples/head_tracking.py)就是按这个模式写的。
打开摄像头,它就盯着你看
daemon 内置人脸识别,一行mini.start_head_tracking()开启后,机器人会持续把头转到离镜头最近的脸的方向;配合 4 麦克风阵列还能做声源定位,声从哪边来它就看向哪边。也就是说,"转头看你"这个最有机器人感的交互,你几乎不用写算法。
浏览器里的控制面板,无需装任何软件就能观察和控制仿真或真机
🔌 五分钟第一次挥手:装环境、连上、写五行
第一步,环境准备。需要 Python 3.11+,然后:
# 获取代码并安装 SDK git clone https://gitcode.com/GitHub_Trending/re/reachy_mini cd reachy_mini pip install -e . # 启动仿真机器人(无硬件也能玩) reachy-mini-daemon --sim跑通之后你会看到一个 MuJoCo 3D 窗口,机器人就在里面;浏览器打开localhost:8000/docs还能直接看到它全部的 REST API。
第二步,第一次交互。开一个新终端,建一个hello.py:
from reachy_mini import ReachyMini # 连接正在运行的机器人(或仿真) with ReachyMini() as mini: # 天线左右摆一摆,再回正 mini.goto_target(antennas=[0.5, -0.5], duration=0.5) mini.goto_target(antennas=[-0.5, 0.5], duration=0.5) mini.goto_target(antennas=[0.0, 0.0], duration=0.5)跑通之后你就走完了"写代码 → 机器人有反应"的完整链路,接下来把head=create_head_pose(yaw=30, degrees=True)加进去让它转头,或者打开examples/里的sequence.py、sound_tts.py看完整动作和语音是怎么编排的。
🎓 这个项目适合谁
- 学生 / 初学者:适合从它学运动控制,因为三套运动学后端、URDF 模型和标定工具全在仓库里,"世界坐标 → 关节角"这条链路每一环都能读源码追下去,而不是只调黑盒 API。
- 应用开发者:适合快速做交互原型,因为 JavaScript SDK 走 WebRTC,浏览器里就能驱动机器人,你做的应用发给朋友零安装即可运行,分享成本极低。
- 研究者:适合做控制与感知实验,因为 MuJoCo 仿真和真机共用同一套 API,
tests/integration_tests/里还有录制-对比脚本,算法可以先在仿真里验证再上真机。
🧭 Reachy Mini 资源入口:文档、示例与教程
- 官方文档(安装、快速上手、Python/JS SDK、硬件说明):docs/source/
- 可运行的示例代码(头部追踪、看图转向、TTS 语音、动作序列等 17 个):examples/
- Jupyter 教程(连接、运动、相机、音频,逐节带图):docs/notebooks/
- 给 AI 编程助手看的开发手册(用 Copilot、Claude Code 等直接生成应用):AGENTS.md
回到开头那个场景:如果你只是好奇桌面机器人好玩不好玩,仿真路线是免费的,装完 Python 就能开始;如果你手里正好有个 3D 打印机,花两三个小时拼一台 Lite,就能让代码里的那个"它"真的在你桌上转过头来看你。
【免费下载链接】reachy_miniReachy Mini's SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
