Reachy Mini 开源桌面机器人保姆级教程从装包到第一行控制代码的完整指南【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini如果你想在周末就拥有一台会转头、会摆天线、还能和你聊天的桌面机器人Reachy Mini 这个开源项目几乎是最省心的起点。它提供一套完整的 SDK让你可以用几行 Python 或网页应用控制机器人的头部运动、摄像头、麦克风与扬声器还能一键接入大语言模型。下面这份教程面向零基础新手带你理清它是什么、为什么值得玩、怎么最快跑起来并附上常见坑位的排查方法。为什么这台桌面机器人值得新手入手很多人对机器人项目的第一印象是电机贵、板子难、代码玄学。Reachy Mini 恰好把这三道门槛都拆平了——它是为会写点代码的爱好者设计的开源平台机械结构可以 3D 打印软硬件全部开放甚至连调试文档都写成了手把手的 Notebook。更妙的是它的三档难度设计平台连接方式适合人群硬件门槛Reachy Mini无线版WiFi 内置电池独立运行想要完整桌面伙伴体验的人需树莓派 CM4 电池Reachy Mini LiteUSB 连电脑想先在电脑上开发的玩家只需一台电脑Simulation模拟版本地 MuJoCo 仿真完全没买硬件、只想先写代码的人零硬件没买硬件也别慌官方仿真模式可以直接在本地起一个 3D 虚拟机器人所有 SDK 代码原样可用。这意味着你可以今天就把代码逻辑跑通等硬件到货后无缝切换这一点新手很容易忽略。核心亮点解密它到底凭什么这么灵活六自由度头部斯图尔特平台带来的活人感Reachy Mini 最抓眼球的是那个能上下点头、左右歪头、还能微微前倾的头部。秘密在于头部内部装了一台小型斯图尔特平台Stewart Platform——六个电机协同拉伸把头部当作动平台同时实现 3 个方向平移 3 个方向旋转。对新手来说你不需要去推导逆运动学SDK 内部已经封装好了你只说头抬高 10 毫米、歪 15 度机器人自己算出六个电机各自该走多少。全身 9 个智能电机 完整感知套件硬件配置相当能打底部底座1 个高扭矩关节电机负责身体旋转头部6 个 XL330 系列智能电机驱动斯图尔特平台天线2 个小型电机专门用来比心和歪头杀感知120° 广角 1200 万像素摄像头 4 麦克风阵列可声源定位 5W 扬声器 IMU 惯性传感器全部电子元器件电池管理、电机驱动、摄像头排线都集成在定制 PCB 上官方还给了这张电子系统图组装时照着认即可想深挖细节可以看 硬件规格文档里面有完整的电机型号和接口说明。零基础快速上手最快三条路跑通你的机器人第一步五分钟装好 SDK推荐先装 uv包管理工具装应用能快 10 倍以上然后安装 SDK 并创建虚拟环境。无线版用户装好reachy-mini纯模拟体验则加上[mujoco]扩展pip install reachy-mini[mujoco] # 或 uv pip install reachy-mini[mujoco]第二步让大脑先醒过来Daemon机器人背后跑着一个叫Daemon的后台服务负责和电机、传感器打交道。它是所有代码能生效的前提无线版机器人开机即自动运行确保电脑和机器人同一局域网Lite 版终端执行reachy-mini-daemon模拟版终端执行reachy-mini-daemon --sim随即弹出 3D 窗口验证方法很简单浏览器打开 Daemon 的 API 文档页能看到 SDK 接口文档就说明服务活着。第三步你的第一段控制代码新建hello.py粘贴下面这几行运行python hello.py——天线左右摇摆的那一刻就算正式入门了from reachy_mini import ReachyMini from reachy_mini.utils import create_head_pose with ReachyMini() as mini: mini.goto_target(antennas[0.5, -0.5], duration0.5) # 天线左歪 mini.goto_target(antennas[-0.5, 0.5], duration0.5) # 天线右歪 mini.goto_target(headcreate_head_pose(z10, roll15, degreesTrue, mmTrue), duration1.0) # 抬头 歪头代码之外日常使用更推荐Reachy Mini Control桌面应用装应用、看状态、调参数都在图形界面里完成新手期可以完全不碰终端。想系统学的话教程 Notebook 目录 按连接 → 运动 → 摄像头 → 音频的顺序排好了四节课示例脚本目录 里则有看人脸追踪、体感控制、TTS 说话等现成可运行的 demo。进阶拓展与避坑指南把机器人变成 AI 应用平台真正好玩的阶段在这里SDK 支持接入 LLM 做自然对话也支持写网页版应用——浏览器通过 WebRTC 直接驱动机器人用户零安装。这意味着你写的 App 发给朋友打开一个网页就能玩。相关路径AI 集成文档接大模型、发布应用JavaScript SDK 指南浏览器应用开发应用开发文档创建、测试、发布全流程如果你用 AI 编程助手写代码仓库里的 AGENTS.md 是专门写给 AI 的施工手册直接丢给它就能开工。新手高频坑位排查表现象大概率原因快速解法代码连不上机器人Daemon 没启动先跑reachy-mini-daemon再开浏览器确认 API 文档页机器人无响应电脑与机器人不同网段无线版必须同一 WiFiLite 版检查 USB 线电机没全部识别电机接线/配置缺失运行src/reachy_mini/tools/scan_motors.py扫描排查模拟窗口打不开macOSMuJoCo 需要专用启动器改用mjpython -m reachy_mini.daemon.app.main --sim装包冲突macOS uvuv 与 MuJoCo 兼容性问题换pip直接安装完整的排查清单在 故障排除文档电机诊断还有专门的 电机诊断指南。核心代码想读懂吗想了解去哪看SDK 主入口src/reachy_mini/reachy_mini.py运动控制goto、录制回放src/reachy_mini/motion/摄像头 / 音频管线src/reachy_mini/media/运动学算法解析法 神经网络src/reachy_mini/kinematics/仿真场景MuJoCo 模型src/reachy_mini/descriptions/reachy_mini/mjcf/想玩更花的还可以给仿真场景加道具--scene minimal会摆上苹果、羊角面包和橡皮鸭或者参考 运动哲学文档 理解为什么官方强调动作要软、要慢、要有呼吸感。总结与展望回头看看这趟旅程三档平台任选、一个 Daemon 服务、几行代码你就已经摸到开源机器人的门了。Reachy Mini 的价值不止于组装一台机器人——它把运动控制、多传感器融合、AI 应用分发整条链路都摊开在你面前代码全开放你想改天线动作曲线还是加个新传感器仓库里都有位置。给下一步的你留三个小任务跑通examples/head_tracking.py让人脸追踪起来用 JS SDK 写一个点按钮歪头的网页应用最后把应用发布到社区让别人的浏览器也能指挥你的机器人。想动手拉取完整源码含 SDK、示例与文档git clone https://gitcode.com/GitHub_Trending/re/reachy_mini你的桌面机器人故事就从今天第一行goto_target开始。【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/24 3:54:07 · 阅读 1.2k Reachy Mini 开源桌面机器人保姆级教程：从装包到第一行控制代码的完整指南
Reachy Mini 开源桌面机器人保姆级教程从装包到第一行控制代码的完整指南【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini如果你想在周末就拥有一台会转头、会摆天线、还能和你聊天的桌面机器人Reachy Mini 这个开源项目几乎是最省心的起点。它提供一套完整的 SDK让你可以用几行 Python 或网页应用控制机器人的头部运动、摄像头、麦克风与扬声器还能一键接入大语言模型。下面这份教程面向零基础新手带你理清它是什么、为什么值得玩、怎么最快跑起来并附上常见坑位的排查方法。为什么这台桌面机器人值得新手入手很多人对机器人项目的第一印象是电机贵、板子难、代码玄学。Reachy Mini 恰好把这三道门槛都拆平了——它是为会写点代码的爱好者设计的开源平台机械结构可以 3D 打印软硬件全部开放甚至连调试文档都写成了手把手的 Notebook。更妙的是它的三档难度设计平台连接方式适合人群硬件门槛Reachy Mini无线版WiFi 内置电池独立运行想要完整桌面伙伴体验的人需树莓派 CM4 电池Reachy Mini LiteUSB 连电脑想先在电脑上开发的玩家只需一台电脑Simulation模拟版本地 MuJoCo 仿真完全没买硬件、只想先写代码的人零硬件没买硬件也别慌官方仿真模式可以直接在本地起一个 3D 虚拟机器人所有 SDK 代码原样可用。这意味着你可以今天就把代码逻辑跑通等硬件到货后无缝切换这一点新手很容易忽略。核心亮点解密它到底凭什么这么灵活六自由度头部斯图尔特平台带来的活人感Reachy Mini 最抓眼球的是那个能上下点头、左右歪头、还能微微前倾的头部。秘密在于头部内部装了一台小型斯图尔特平台Stewart Platform——六个电机协同拉伸把头部当作动平台同时实现 3 个方向平移 3 个方向旋转。对新手来说你不需要去推导逆运动学SDK 内部已经封装好了你只说头抬高 10 毫米、歪 15 度机器人自己算出六个电机各自该走多少。全身 9 个智能电机 完整感知套件硬件配置相当能打底部底座1 个高扭矩关节电机负责身体旋转头部6 个 XL330 系列智能电机驱动斯图尔特平台天线2 个小型电机专门用来比心和歪头杀感知120° 广角 1200 万像素摄像头 4 麦克风阵列可声源定位 5W 扬声器 IMU 惯性传感器全部电子元器件电池管理、电机驱动、摄像头排线都集成在定制 PCB 上官方还给了这张电子系统图组装时照着认即可想深挖细节可以看 硬件规格文档里面有完整的电机型号和接口说明。零基础快速上手最快三条路跑通你的机器人第一步五分钟装好 SDK推荐先装 uv包管理工具装应用能快 10 倍以上然后安装 SDK 并创建虚拟环境。无线版用户装好reachy-mini纯模拟体验则加上[mujoco]扩展pip install reachy-mini[mujoco] # 或 uv pip install reachy-mini[mujoco]第二步让大脑先醒过来Daemon机器人背后跑着一个叫Daemon的后台服务负责和电机、传感器打交道。它是所有代码能生效的前提无线版机器人开机即自动运行确保电脑和机器人同一局域网Lite 版终端执行reachy-mini-daemon模拟版终端执行reachy-mini-daemon --sim随即弹出 3D 窗口验证方法很简单浏览器打开 Daemon 的 API 文档页能看到 SDK 接口文档就说明服务活着。第三步你的第一段控制代码新建hello.py粘贴下面这几行运行python hello.py——天线左右摇摆的那一刻就算正式入门了from reachy_mini import ReachyMini from reachy_mini.utils import create_head_pose with ReachyMini() as mini: mini.goto_target(antennas[0.5, -0.5], duration0.5) # 天线左歪 mini.goto_target(antennas[-0.5, 0.5], duration0.5) # 天线右歪 mini.goto_target(headcreate_head_pose(z10, roll15, degreesTrue, mmTrue), duration1.0) # 抬头 歪头代码之外日常使用更推荐Reachy Mini Control桌面应用装应用、看状态、调参数都在图形界面里完成新手期可以完全不碰终端。想系统学的话教程 Notebook 目录 按连接 → 运动 → 摄像头 → 音频的顺序排好了四节课示例脚本目录 里则有看人脸追踪、体感控制、TTS 说话等现成可运行的 demo。进阶拓展与避坑指南把机器人变成 AI 应用平台真正好玩的阶段在这里SDK 支持接入 LLM 做自然对话也支持写网页版应用——浏览器通过 WebRTC 直接驱动机器人用户零安装。这意味着你写的 App 发给朋友打开一个网页就能玩。相关路径AI 集成文档接大模型、发布应用JavaScript SDK 指南浏览器应用开发应用开发文档创建、测试、发布全流程如果你用 AI 编程助手写代码仓库里的 AGENTS.md 是专门写给 AI 的施工手册直接丢给它就能开工。新手高频坑位排查表现象大概率原因快速解法代码连不上机器人Daemon 没启动先跑reachy-mini-daemon再开浏览器确认 API 文档页机器人无响应电脑与机器人不同网段无线版必须同一 WiFiLite 版检查 USB 线电机没全部识别电机接线/配置缺失运行src/reachy_mini/tools/scan_motors.py扫描排查模拟窗口打不开macOSMuJoCo 需要专用启动器改用mjpython -m reachy_mini.daemon.app.main --sim装包冲突macOS uvuv 与 MuJoCo 兼容性问题换pip直接安装完整的排查清单在 故障排除文档电机诊断还有专门的 电机诊断指南。核心代码想读懂吗想了解去哪看SDK 主入口src/reachy_mini/reachy_mini.py运动控制goto、录制回放src/reachy_mini/motion/摄像头 / 音频管线src/reachy_mini/media/运动学算法解析法 神经网络src/reachy_mini/kinematics/仿真场景MuJoCo 模型src/reachy_mini/descriptions/reachy_mini/mjcf/想玩更花的还可以给仿真场景加道具--scene minimal会摆上苹果、羊角面包和橡皮鸭或者参考 运动哲学文档 理解为什么官方强调动作要软、要慢、要有呼吸感。总结与展望回头看看这趟旅程三档平台任选、一个 Daemon 服务、几行代码你就已经摸到开源机器人的门了。Reachy Mini 的价值不止于组装一台机器人——它把运动控制、多传感器融合、AI 应用分发整条链路都摊开在你面前代码全开放你想改天线动作曲线还是加个新传感器仓库里都有位置。给下一步的你留三个小任务跑通examples/head_tracking.py让人脸追踪起来用 JS SDK 写一个点按钮歪头的网页应用最后把应用发布到社区让别人的浏览器也能指挥你的机器人。想动手拉取完整源码含 SDK、示例与文档git clone https://gitcode.com/GitHub_Trending/re/reachy_mini你的桌面机器人故事就从今天第一行goto_target开始。【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考