Reachy Mini

🤖 开源人形机器人全栈遥控

通过 REST API 与 SSH 远程控制 Pollen Robotics 开源人形机器人 Reachy Mini,实现头部6自由度运动、情感动画、舞蹈、相机抓拍及应用管理。

收藏
9.9k
安装
2.7k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

本 Skill 为 Pollen Robotics 旗下 Reachy Mini 机器人提供完整的远程控制能力,通过封装好的 Bash 脚本 reachy.sh 或直接调用 REST API 实现交互。主要功能覆盖六大模块:

运动控制:头部具备 6 自由度(俯仰 ±0.5 rad、偏航 ±0.8 rad、翻滚 ±0.5 rad),支持 minjerk/linear/ease/cartoon 四种插值模式;机身支持 360° 无限旋转;双天线可独立控制角度。所有运动通过 goto 指令指定目标姿态与时长完成。

情感与舞蹈:内置 80+ 种预录制情感动画(如 curious1cheerful1surprised1)及 19 套舞蹈动作(如 groovy_sway_and_rolldizzy_spin),通过 play-emotionplay-dance 调用,适合社交互动与演示场景。

相机抓拍:利用 WebRTC 技术通过 snap 命令非侵入式捕获 IMX708 广角相机画面,保存为 JPEG;需 SSH 凭证(默认用户 pollen/密码 root)。注意机器人需处于唤醒状态(wake-up)否则镜头朝向机身内部。

应用管理:Reachy Mini 运行 Hugging Face Space 应用,支持 app-start/app-stop/apps 等指令管理,但同一时间仅允许单个应用运行,且应用可能独占机器人控制权。

音频感知:4 麦克风阵列支持声源定位(DOA),返回角度与语音检测状态。

系统状态:提供 statusstatemotorsvolumewifi-status 等诊断指令,并支持 motors-gravity 重力补偿模式便于手动摆姿。

显著优点

  • 功能全面:涵盖运动、视觉、听觉、情感表达四大维度,满足教育演示、科研原型、社交互动等多场景需求。
  • 非侵入式抓拍:WebRTC 快照不中断后台守护进程,保证机器人持续可用。
  • 开源生态:基于 Pollen Robotics 与 Hugging Face 的开源硬件/软件栈,社区资源丰富。
  • 灵活控制:CLI 封装降低使用门槛,同时保留 raw 指令与直接 curl 访问,兼顾易用与扩展。

潜在缺点与局限性

  • 硬件依赖性强:必须物理拥有 Reachy Mini 机器人并处于同一局域网,无法云端模拟。
  • 网络配置敏感:默认 IP 192.168.8.17 需手动配置或环境变量覆盖,网络变更时需重新调整。
  • 安全凭证硬编码风险:SSH 密码默认 root,虽可通过环境变量覆盖,但用户易遗忘修改,存在横向移动隐患。
  • 应用独占冲突:运行中的 HF Space 应用会抢占机器人控制权,需手动 app-stop 才能恢复手动指令,易造成困惑。
  • 相机视角受限:睡眠状态下镜头朝内,必须预唤醒才能获取有效画面,增加操作步骤。

适合人群

  • 机器人研究者与开发者:需要快速验证算法在实体机器人上的效果。
  • 教育工作者与科普机构:利用情感动画与舞蹈进行人机交互演示。
  • Hugging Face 生态用户:已熟悉 Spaces 与开源硬件流程的 Maker 社区成员。
  • 创意技术艺术家:将机器人作为表演或装置艺术的执行终端。

常规风险

  • 物理碰撞风险cartoon 插值模式动作幅度大,若机器人靠近边缘或障碍物,可能因旋转/俯仰导致跌落或碰撞。
  • 网络暴露风险:REST API(端口 8000)与 WebRTC 信令(端口 8443)若暴露于公网,可能被未授权控制。
  • 凭证泄露风险:SSH 密码若保持默认且环境变量泄露,攻击者可远程执行任意命令。
  • 设备损坏风险motors-enable 状态下强行手动搬动关节可能造成电机过载;motors-gravity 虽保护电机但仍需小心操作。
  • 隐私风险:相机抓拍功能若被滥用,可能拍摄到敏感环境信息,需确保物理访问控制。

Reachy Mini 内容

references文件夹
scripts文件夹
手动下载zip · 12.3 kB
api-reference.mdtext/markdown
请选择文件