开源桌面机器人 Reachy Mini六自由度平台控制好不好上手【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_miniReachy Mini 是一款开源桌面机器人头部是六自由度斯图尔特平台配两根天线和一套 Python SDK。它的主打点就一个仿真、Lite 版USB 接电脑、无线版Raspberry Pi CM4 独立运行三套硬件用的都是同一套 API。30 秒跑通验证仿真模式先跑起来不用接硬件最短路径是仿真模式。安装 SDK 然后启动 MuJoCo 仿真 daemonuv pip install reachy_mini[all,mujoco] reachy-mini-daemon --sim你输入这两条命令后浏览器打开http://localhost:8000/docs看到 REST API 文档页说明 daemon 已就绪同一目录下写个脚本python hello.py你看到仿真窗口里的机器人动了一下。这就是入门的全部动作daemon 常驻SDK 只是它的客户端。Reachy Mini Control 控制应用的仪表板开源桌面机器人开源桌面机器人的关节状态、媒体状态都在这里它到底替你省了什么事笔记本上跑仿真不接硬件。以前想试一个转头逻辑得先装配好机器人、刷好电机固件现在reachy-mini-daemon --sim起来就能写代码逻辑验证完再搬到真机。让机器人追着说话人转头。以前声源定位要自己调 ReSpeaker 麦克风阵列、算 DoA、再做坐标变换现在 examples/sound_doa.py 已经轮询/api/state/doa接口、把角度转成世界坐标、调look_at转头通读一遍就能抄到自己的应用里。AI 代码和机器人分开部署。以前控制代码只能写在机器人那颗性能有限的主板上现在 SDK 是纯客户端走 WebSocket 连 daemon重活视觉模型、LLM 调用放你自己的电脑或服务器上Raspberry Pi 机器人本体只负责硬件 I/O 和安全限位这就是典型的 Raspberry Pi 机器人部署里强弱分工的玩法。架构一张图看懂从 SDK 到六自由度关节Reachy Mini 开源桌面机器人开源桌面机器人的斯图尔特平台组件分解六根执行器撑起头部的六自由度整条链路分四层src/reachy_mini/reachy_mini.py的ReachyMini类是 SDK 入口管连接和高层动作wake_up、goto_target、look_at_world。src/reachy_mini/io/是通信层WebSocket 客户端把命令发给 daemon同时订阅状态广播。src/reachy_mini/daemon/是 FastAPI 服务跑在连着机器人的机器上负责命令排队、状态发布、安全检查。daemon/backend/提供三个可替换后端真机串口、MuJoCo 仿真、mockup上层对它们一视同仁。核心调用就这几行位姿目标传 4x4 矩阵插值在客户端算好逐帧下发from reachy_mini import ReachyMini from reachy_mini.utils import create_head_pose with ReachyMini() as mini: mini.wake_up() mini.goto_target(headcreate_head_pose(z10, roll15), duration1.0)head frame 坐标系goto_target 的开源桌面机器人开源桌面机器人位姿目标都以这个基准为准三个值得你翻源码的点三套运动学引擎共用一个接口。src/reachy_mini/kinematics/ 里 analytical、nnONNX 推理含 int8 量化模型、placo物理引擎三个实现都是ik(pose) / fk(joints)签名daemon 启动参数kinematics_engine切换。这样设计是因为三种方案各占一头解析解最准但有边界特例NN 在 Pi 上推理快placo 能算重力补偿和碰撞检测。你复用时能学到给算法留同一个接口上层代码就不怕换实现。指令流和状态流分开两个通道。SDK 发命令走请求-回执daemon 的关节角、IMU、媒体状态走独立广播io/publisher.pyws_server.py互不阻塞。原因是 WebSocket 长连接下如果 UI 每帧都等回执后台任务会互相卡死。这是做机器人前端时很实用的模式状态用发布动作用任务加完成通知。安全限位长在 API 里不靠自觉。create_head_pose收毫米和角度SDK 把请求自动 clamp 到关节限位head pitch/roll ±40°、body yaw ±160°越界目标被截断而不是抛异常。翻源码会发现 clamp 逻辑在 daemon 侧而不是客户端任何客户端都绕不过去。你的项目如果是上位机发指令、下位机执行的结构把安全边界放在服务端而不是 SDK 里这个思路可以直接搬。踩坑提醒连不上机器人。现象ReachyMini()构造时超时。原因默认走 mDNS 发现reachy-mini.local公司网络常禁组播广播。处理先用find_robots()src/reachy_mini/utils/discovery.py看局域网里实际发现了什么发现不了就构造时显式传host192.168.x.x, connection_modenetwork。扫描电机时一个都找不到。现象Testbench 里 scan 全空但 daemon 明明正常。原因扫描要求独占串口daemon 占着就不行。处理先停掉 daemon桌面应用设置里关掉 motor backend再扫描扫完重启 daemon 即可详见 docs/source/troubleshooting/motors_diagnosis.md。macOS 上仿真段错误。现象reachy-mini-daemon --sim起来就崩。原因uv装的 MuJoCo 相关包在 macOS 有兼容问题libgstpython也可能段错误。处理按 docs/source/platforms/simulation/get_started.md 的建议Mac 上用pip而不是uv装 MuJoCo 相关依赖必要时改用mjpython -m reachy_mini.daemon.app.main --sim启动。下一步往哪走路径由轻到重。先跑 examples/ 里三个脚本sound_doa.py 看声源追踪、look_at_image.py 看图像坐标转头、sequence.py 看动作编排。再翻 src/reachy_mini/kinematics/对比三套ik/fk实现的输入输出顺手看 docs/source/SDK/core-concept.md 里的坐标系和限位表。最后尝试接自己的传感器把任何方位估计接进look_at_world(x, y, z)六自由度平台的运动控制部分就归你调了。把reachy-mini-daemon --sim拉起来今天就能让机器人在你屏幕上动一下。【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
