让代码拥有表情：开源机器人 Reachy Mini 快速上手指南

让代码拥有表情：开源机器人 Reachy Mini 快速上手指南

【免费下载链接】reachy_miniReachy Mini's SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini

你有没有想过，一个桌面机器人不仅能执行指令，还能像宠物一样"听懂"语气、用点头和歪头回应你？Reachy Mini 就是这样一款面向开发者的开源机器人——它把机械结构、运动算法、摄像头、麦克风和扬声器全部塞进一个约 30 厘米高的身体里，并通过一套简洁的 SDK 让你用 Python 或 JavaScript 自由指挥它。最大的价值在于：你不需要机器人学博士学位，就能在半小时内让它完成第一个动作，甚至把 LLM 接进来，让它开口说话。

为什么"能表达"比"能动"更难？

市面上多数桌面机器人只有几颗舵机，能做固定几个姿势，像个复读机。Reachy Mini 的不同之处在于它的"身体构造"：

• 6 自由度斯图尔特平台头部：6 根微型推杆协同控制，头部可以做俯仰、横滚、偏航和微小平移，动作平滑得像真人转动脖子；
• 一对会"说话"的天线：开心时竖起、困惑时摇摆，情绪全写在头顶；
• 120° 广角摄像头 + 4 麦克风阵列：能看人、听声辨位，配合内置扬声器形成完整的感知—表达闭环；
• 8 颗高精度电机 + 软件限位：运动前先计算安全范围，杜绝自撞和过载。

换句话说，它解决的核心痛点是：让开发者低成本获得一台"有表现力"的机器人试验台。过去这类硬件动辄数万元且闭源，而 Reachy Mini 的软件全部开源（Apache 2.0），硬件设计文件也以 CC 协议开放，从 3D 打印件到控制固件，你都能看得到、改得动。

三步走完环境搭建，先跑通再谈其他

新手最怕安装环节劝退。Reachy Mini 的思路很聪明：先把模拟器跑起来，再考虑真机。模拟器基于 MuJoCo 物理引擎，行为与真机一致，相当于给你发了一台"虚拟机器人"。

第一步，克隆仓库并安装 SDK：

git clone https://gitcode.com/GitHub_Trending/re/reachy_mini cd reachy_mini pip install -e .

第二步，启动模拟器（会弹出 3D 视图窗口）：

reachy-mini-daemon --sim

第三步，在另一个终端运行你的第一段代码——让机器人抬头并摆动天线：

import time import numpy as np from reachy_mini import ReachyMini from reachy_mini.utils import create_head_pose with ReachyMini() as mini: mini.goto_target(create_head_pose(), antennas=[0.0, 0.0], duration=1.0) while True: t = time.time() antennas = np.deg2rad(20 * np.sin(2 * np.pi * 0.5 * t)) pitch = np.deg2rad(10 * np.sin(2 * np.pi * 0.5 * t)) mini.set_target( head=create_head_pose(pitch=pitch), antennas=[antennas, antennas], ) time.sleep(0.01)

这段代码在做什么？goto_target让机器人先回到中立位，然后一个 100Hz 的控制循环让天线和头部做正弦摆动——你会看到它像在"挥手打招呼"。整个过程不到 5 分钟，这就是开源项目快速上手的魅力。

拆开看：一套"电脑 + 遥控器"的架构

理解 Reachy Mini 的内部逻辑，只需记住一个类比：机器人本体是"电脑"，SDK 是"遥控器"，两者通过局域网通信。

• Daemon（守护进程）：跑在连接硬件的设备上（Lite 版是 PC，无线版是树莓派），负责读写电机、做安全校验、采集传感器数据，并以 REST API + WebSocket 对外服务；
• SDK（客户端）：你写的 Python 代码，通过网络连接 Daemon。

这个"遥控器"设计带来一个实用好处：AI 重计算可以放在服务器上，机器人只负责执行。比如你可以在自己的 GPU 机器上跑视觉模型，再把结果发给机器人执行动作，互不阻塞。

运动控制方面，SDK 提供两种坐标方式：头部坐标系（相对脑袋本身）与世界坐标系（相对桌面）。想让它看向桌面上某个苹果，直接写：

mini.look_at_world(x=0.3, y=0.2, z=0.5)

它会自动解算 6 根推杆各自该伸长多少——逆运动学、插值算法、碰撞规避这些脏活，框架全包了。安全上也有三重保险：软限位自动截断越界指令、电机温度监控、急停接口，适合放在桌面上与人和孩子共存。

和同类方案比，它强在哪？

一句话总结：它是"可编程的情感表达"与"开发者友好"结合得最平衡的方案，尤其适合做 AI 机器人开发平台的试验品——社区里已经有人用它做语音对话、手势跟随、甚至让它当"电台主持人"。

新手最容易踩的四个坑

1. 模拟器没装 MuJoCo 依赖：请使用pip install "reachy-mini[mujoco]"安装扩展依赖，Mac 用户建议用mjpython启动而不是uv；
2. 连接失败先查地址：Lite 版连localhost，无线版连reachy-mini.local，两者别混；
3. 摄像头黑屏：多半是系统缺 GStreamer，参考文档中的 gstreamer-installation 安装步骤；
4. 电机"发软"：disable_motors()会让关节彻底断电，误调用会以为机器人坏了，检查一下状态即可。

生态与下一步

围绕这个项目已经长出一个完整生态：官方提供了基于 Hugging Face Spaces 的应用商店，对话、电台、手势跟踪等应用一键安装；浏览器端有 JavaScript SDK，通过 WebRTC 直连机器人，访问者无需任何安装就能在网页里"玩"你的机器人——这对分享作品来说非常友好。源码目录里examples/有 17 个可直接运行的示例，docs/notebooks/提供了带图文的 Jupyter 教程，跟着敲一遍就能覆盖移动、摄像头、音频三大主题。

从今天开始，你可以先跑通模拟器，把打招呼这段代码改成你自己的"性格动作"；等摸熟了，再考虑入手真机，把 AI 模型接到天线上，让它成为真正有情绪的桌面伙伴。记住那句话：机器人的乐趣不在目的地，而在你亲手赋予它表情的过程里。

【免费下载链接】reachy_miniReachy Mini's SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini