8个电机撑起6自由度表情Reachy Mini 开源机器人开发实战指南【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini做一台会表达情绪的桌面机器人究竟难在哪里Reachy Mini 开源机器人开发给了我们一个可对照的答案难的不在让电机转起来而在让电机转得像个人。这个项目把一台带 6 自由度斯图尔特平台头部、双天线和 8 个电机的桌面机器人连同 3D 打印文件、SDK、控制 daemon 和示例应用全部开源读完全文你将知道它的表情控制怎么实现、代码从哪写起、以及新手最该避开的几个坑。一个让人失眠的晚上机器人转了但它没活着很多人第一次接触机器人套件的经历是这样的零件装好驱动装好电机嗡嗡转动你调用接口让头转了 30 度——然后呢它停在那里像一台昂贵的闹钟。你真正想要的不是能转的头而是会回应你的头你走近它抬头它跟着看你你说话它侧耳你逗它天线竖起。Reachy Mini 的设计出发点正是这个落差。它把表达拆成了三层可编程的东西头部姿态6 自由度并联平台能点头、歪头、转头、双天线左右独立旋转情绪外挂、身体朝向自动跟随头部转动。换句话说你不需要自己拼凑运动学SDK 已经把表情抽象成了几个直白的 API。表情从哪来先分清管家和管家命令Reachy Mini 的软件是典型的两层结构理解它后面的所有代码就都顺了daemon管家跑在连接机器人的电脑Lite 版或机器人板载 Raspberry Pi无线版上负责 USB/串口通信、传感器读取和所有安全检查对外暴露 REST API 与 WebSocket。核心代码在 src/reachy_mini/daemon/。SDK你的命令你写的 Python 代码通过网络连上 daemon。好处是你可以让 AI 推理跑在强大服务器上机器人本体只负责执行。入口类在 src/reachy_mini/reachy_mini.py。这套分离让换后端变得廉价同一份 SDK 代码可以驱动真实硬件也可以驱动 MuJoCo 仿真reachy-mini-daemon --sim一行命令启动。没有机器人也能先学会全部 API这是新手最友好的入口。第一次让机器人看你十行代码的完整旅程环境准备按官方安装指南走一遍即可克隆与安装git clone https://gitcode.com/GitHub_Trending/re/reachy_mini cd reachy_mini pip install -e .随后启动仿真 daemonLinux/Windows 下执行reachy-mini-daemon --sim接着写你的第一段行为代码from reachy_mini import ReachyMini from reachy_mini.utils import create_head_pose with ReachyMini() as mini: mini.goto_target( headcreate_head_pose(z10, roll15, degreesTrue, mmTrue), duration1.0 )这段代码在做什么create_head_pose(z10, roll15, degreesTrue, mmTrue)生成一个抬头 10 毫米、侧倾 15 度的头部位姿——z 和 roll 的单位通过关键字明确指定避免新手常见的单位混淆goto_target则负责在一秒内平滑插值到该位姿而不是瞬间跳过去。注意with ReachyMini()退出代码块时机器人会自动断电进入安全状态这个上下文管理器是新手最容易忽略、也最值得养成的习惯。让动变成回应三组 API 打开互动大门运动控制只是地基Reachy Mini 真正抓人的是它把感知接进了运动点哪看哪。示例 examples/look_at_image.py 展示了一个很有意思的交互OpenCV 弹出摄像头画面你用鼠标点画面里的任意位置机器人就真的看向那个点。背后的look_at_image把 2D 像素坐标换算成世界坐标再解算到头部关节你完全不用碰坐标系。耳朵跟着声源走。4 麦克风阵列配合声源定位示例 examples/sound_doa.py 里机器人会朝向说话人的方向转头。这比固定朝向的对话体验真实得多——它看起来真的在听。天线说心情。两条天线各自独立转动是成本最低的情绪外设mini.set_target(antennas[0.5, -0.5])一行代码一边天线竖起一边垂下一个歪头杀的困惑表情就出来了。官方把这套位姿控制、插值、记录的完整语义写在了 docs/source/SDK/core-concept.md建议在写复杂动作前先读一遍坐标系的说明。为什么新手不容易玩坏它内置的防呆设计桌面机器人离人太近安全不是加分项而是底线。Reachy Mini 的防护有三个层次且都写进了 SDK软限位自动收敛头部俯仰/横滚限制在 ±40°偏航 ±180°身体偏航 ±160°且头与身体偏航差最大 65°。你传入越界值SDK 不会报错崩溃而是自动 clamp 到最近的合法位置。扭矩三态enable_motors()刚性保持、disable_motors()完全无力、enable_gravity_compensation()软模式用手拨动头部它会停在原地——调试期用第三种模式手动摆姿势比改代码快得多。碰撞与运动学校验仓库里甚至有专门的 tests/test_collision.py 来回归验证不会自撞。这些机制意味着新手可以放心大胆地实验最坏的结果是机器人不动而不是损坏。从脚本到应用把机器人打包给别人用SDK 只解决机器人在你电脑上跑而 Reachy Mini 的野心是让别人不装任何东西就能玩你的机器人。它提供了一条现成的发布路径用 JavaScript SDK 写浏览器应用通过 WebRTC 直接驱动机器人再发布到 Hugging Face Spaces——用户打开网页就能玩零安装。同时项目准备了全套 App 模板对话、跟随手势、广播电台等模板文件在 src/reachy_mini/apps/templates/你甚至可以 fork 一份改造。进阶路线建议先跑通 examples/minimal_demo.py 确认环境再玩 examples/recorded_moves.py 录一段自己的动作最后试 examples/sequence.py 把动作编排成连贯行为——这条路从能动走到会演每一步都有现成范例对照。给第一次动手的人从改一个参数开始不要一上来就规划宏大功能。先让机器人在仿真里抬头看你把roll15改成roll-15看它歪向另一边再给天线设几个不同数值感受情绪刻度。当你理解了位姿、扭矩、限位这三个词你已经超过大多数只看不练的人。硬件玩家可以直接用仓库里的 3D 打印文件自建软件玩家从仿真起步两条路在同一个 SDK 上汇合。把你的第一个行为跑起来然后发给朋友看——那一下它活了的惊呼就是最好的回报。【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考