开源情感机器人Reachy Mini快速上手从零组装到AI对话的桌面机器人开发全攻略【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini想象这样一个场景你加班到深夜桌面上那台巴掌大的机器人转头看向你两根天线轻轻竖起像宠物听到主人回家一样打了个招呼。这不是科幻电影而是开源情感机器人Reachy Mini的日常。今天这篇文章就是一份面向零基础新手的桌面机器人开发全攻略——不堆术语、不绕弯子带你把这台会卖萌的机器人从零件盒一路玩到能接AI大模型。为什么说它是会表达情绪的机器人先说结论Reachy Mini不是那种只会原地转圈的玩具而是一台真正为人机交互设计的开源情感机器人。它的灵魂在于那颗6自由度斯图尔特平台头部——三根伸缩连杆托起整个脑袋能实现抬头、歪头、点头、转动等接近人类的细腻动作加上身体旋转和两根独立转动的天线一共9个自由度。真正有意思的是那两根天线。它们不只是装饰而是机器人的耳朵和心情晴雨表开心时竖起疑惑时左右摇摆困了会垂下来。配合自带的唤醒犯困等音效Reachy Mini能在几行代码内完成一套完整的情绪表达。相比传统机器人冷冰冰的机械感这种拟人化设计让交互变得格外亲切。而最打动人的是它的开源属性从3D打印的STL零件文件、电机配置到完整的Python/JavaScript SDK全部开放。你可以改结构、换传感器、写自己的行为逻辑甚至给社区贡献新的性格。硬件拆解30厘米小身体里藏了什么Reachy Mini整机约30×20×15.5厘米重1.4公斤出头是标准的桌面尺寸。拆开外壳核心配置相当扎实电机系统底座1个定制Dynamixel XC330电机负责身体旋转6个XL330电机驱动斯图尔特平台的六根连杆2个XL330电机控制天线共9颗电机协同工作视觉120°广角摄像头1200万像素带自动对焦可实时输出视频流听觉4麦克风阵列支持声源定位能判断声音来自哪个方向内置5W扬声器大脑无线版内置树莓派Compute Module 44GB内存带IMU惯性传感器和Wi-Fi完全自主运行安全设计软件限位自动钳制、碰撞检测、过流/过温保护电池自带BMS管理芯片两颗关键细节头部俯仰和横滚限制在±40°身体旋转±160°头部与身体的偏航差不能超过65°——这些安全限制由SDK自动强制执行即使你写错坐标机器人也会自动收回到安全姿态不会扭断脖子。此外支持重力补偿模式电机保持通电但松弛你可以用手掰动它的头教它动作这就是演示教学的基础。三步装好自己的桌面机器人克隆、装依赖、连接上手流程比想象中简单核心就三步。第一步拉取代码并安装SDK。打开终端克隆项目仓库git clone https://gitcode.com/GitHub_Trending/re/reachy_mini cd reachy_mini pip install -e .建议用uv代替pip安装速度能快10~100倍项目会自动检测找不到就回退到pip。装完记得建一个Python虚拟环境避免包冲突。第二步选择你的连接方式。项目提供三个版本按需挑选版本连接方式适用人群Reachy Mini无线版机身自带树莓派Wi-Fi开箱即连想拥有全自主机器人的人Reachy Mini Lite有线版USB直连电脑用台式机算力驱动开发者、预算有限的玩家模拟器版无需硬件MuJoCo物理引擎零成本入门、先学后买无线版首次使用需下载Reachy Mini Control桌面应用按引导把机器人连上你家Wi-FiLite版插上USB即可模拟器版直接跑一条命令就弹出3D窗口。第三步启动守护进程。Reachy Mini采用客户端-服务器架构守护进程Daemon负责和电机、传感器打交道你的代码通过SDK连接它。Lite和模拟器版在终端运行reachy-mini-daemon --sim加--sim就是模拟器无线版开机即自动运行。浏览器打开http://localhost:8000/docs能看到完整的API文档看到它就算就绪了。第一行代码让机器人跟你打招呼装好环境后用Python写个十几行的脚本就能让机器人动起来。先来个最经典的天线摇摆问候from reachy_mini import ReachyMini 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(antennas[0, 0], duration0.5) # 归位这段代码做了一件很拟人的事像人左右歪头一样让两根天线交替摆动。duration0.5表示每次动作花0.5秒平滑完成看起来自然不生硬。接着让机器人抬头看你——这是项目文档里的经典示例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)的意思是头抬高10毫米、侧倾15度。degreesTrue和mmTrue让单位一目了然——角度用度、距离用毫米不用猜弧度。你甚至可以让它看向三维空间里的某个点mini.look_at_world(x0.3, y0.2, z0.5)这句话的含义是让机器人的视线对准面前30厘米、偏右20厘米、高50厘米的那个位置它会自动反解出九个电机各自该转多少。动作插值支持linear线性、minjerk最小加加速度默认、ease_in_out、cartoon四种风格——换一种插值同一个动作的气质就完全不一样。进阶玩法让它看、听、说、追机器人的价值不止在动更在感知。SDK把这些能力封装得相当顺手。看一行代码拿到摄像头画面返回的就是numpy数组可直接丢给OpenCVframe mini.media.get_frame() # 返回 (高, 宽, 3) 的 uint8 数组听4麦克风阵列不仅能录音还能算声源方向doa, is_speech mini.media.get_DoA() # 返回声源角度和是否检测到人声追开启人脸追踪机器人会盯住最近的人脸并让头跟着转瞄准鼻子位置mini.start_head_tracking() face mini.get_tracked_face() # 返回 detected, x, y, roll说把音频样本推给扬声器播放配合语音合成就能让它开口说话还能录下你用手掰出来的动作序列并回放——start_recording()开始录、stop_recording()结束、play_move()回放一套演示教学复现闭环就完成了。开源机器人AI集成给机器人装上大脑Reachy Mini的目标用户是AI开发者所以AI集成是它的主场。官方提供了一条完整的应用化路径用CLI工具生成应用骨架直接发布到Hugging Face Spaces任何人点开链接就能通过浏览器控制你的机器人——底层用WebRTC传输视频、音频和指令对方不需要装任何软件。目前官方商店里已经有不少现成玩法对话应用集成LLM实现自然语音对话语音检测大模型语音合成三件套手势跟踪实时追踪你的手机器人跟着你的手势动电台应用让机器人陪你听广播想自己搞定制AI管线也完全可行。比如你有个自研的OpenCV检测器或Whisper语音识别只需要初始化时加一个参数media_backendno_mediaSDK就会释放摄像头和麦克风硬件把控制权交给你自己的代码。另外daemon暴露了完整的REST API和WebSocket接口/api/state/full、/api/state/ws/full想用非Python语言写控制器、做仪表盘甚至搭MCP服务器都有现成通道。新手最容易踩的5个坑结合社区反馈我把高频问题整理成一份避坑清单按顺序排查能解决90%的问题。先更新再折腾遇到任何怪问题第一反应是更新软件并重启机器人关机等5秒再开机。这个老土的办法能解决相当多已知问题。电机发红闪灯多半是供电或短路。检查从脚部到头部那条电源线和电机三芯线是否破损、是否插紧。注意USB口供电不足Lite版必须插7V电源才能驱动电机。电机没反应但不报错大概率是电机处于松弛状态没上电。检查电机模式如果是Disabled先调用enable_motors()再wake_up()。麦克风静音/录出来全是零先怀疑排线插反了——黑色排线有字的一面要朝上。排线没插反还不行再查固件版本是否达到2.1.3。天线狂抖天线转到竖直0°时会因齿轮间隙陷入倒立摆式震荡这是物理特性不是故障。把天线偏移个10°左右让重力帮忙压住即可新版固件已默认处理。另外提醒两个小知识装完零件盒里剩几颗螺丝和线材是正常的官方故意多给备件reachy-mini.local这个地址在公司、酒店Wi-Fi下可能解析不了客户端隔离所致换成手机热点就通了。灵感库拿到手之后能做什么有了一台会动会看会听的桌面机器人玩法边界取决于想象力。这里抛几个方向供参考编程教育助手让机器人用肢体动作演算法——排序时手忙脚乱地比划理解递归时歪头思考孩子学编程的兴致会完全不同远程临场伙伴无线版自带摄像头和扬声器集成视频通话后远方的家人可以通过这台小机器人陪你工作动作让通话更生动艺术表演装置9个自由度可录可放的动作系统配合音乐编排一支桌面舞蹈加上灯光就是迷你舞台人机交互研究平台声源定位、人脸追踪、重力补偿演示教学这些现成能力让它成为社交机器人研究和运动规划算法的理想实验台没有硬件也能玩先上模拟器这里特别提醒预算或硬件还没到位的朋友项目内置了基于MuJoCo的完整模拟器物理引擎和真实硬件行为一致。装依赖时多带一个[mujoco]后缀pip install reachy-mini[mujoco]然后运行reachy-mini-daemon --sim一个3D窗口就会出现你的机器人鼠标拖拽即可旋转视角。还有--scene minimal参数能给模拟环境加上桌子和苹果、牛角包等小道具方便测试拿取类逻辑。模拟器里的SDK代码和真机完全通用——你写好的脚本将来无缝迁移到实体机。社区与下一步Reachy Mini的背后是Pollen Robotics团队和活跃的开源社区Discord上聚集了数千名开发者分享作品、互相答疑。路线图上有几个值得期待的方向iOS/Android手机端应用手机上控制机器人逛应用商店、AI协作编程空间用自然语言实时聊出一个应用、社区Pimp my Reachy Mini改壳运动等。项目采用Apache 2.0开源协议硬件设计文件采用CC BY-SA-NC协议。到这里你已经掌握了开源情感机器人Reachy Mini从组装、安装、首段代码到AI集成的完整路径。下一步建议先跑通上面的天线摇摆示例然后打开项目里的examples/目录挑一个顺眼的例子人脸追踪、声源定位、录音回放都值得一试再试着把对话应用装上让机器人真正开口。从让一根天线动起来到给它装上会聊天的大脑——你的第一台情感机器人就差这一行代码了。【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 开源情感机器人Reachy Mini快速上手：从零组装到AI对话的桌面机器人开发全攻略
开源情感机器人Reachy Mini快速上手从零组装到AI对话的桌面机器人开发全攻略【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini想象这样一个场景你加班到深夜桌面上那台巴掌大的机器人转头看向你两根天线轻轻竖起像宠物听到主人回家一样打了个招呼。这不是科幻电影而是开源情感机器人Reachy Mini的日常。今天这篇文章就是一份面向零基础新手的桌面机器人开发全攻略——不堆术语、不绕弯子带你把这台会卖萌的机器人从零件盒一路玩到能接AI大模型。为什么说它是会表达情绪的机器人先说结论Reachy Mini不是那种只会原地转圈的玩具而是一台真正为人机交互设计的开源情感机器人。它的灵魂在于那颗6自由度斯图尔特平台头部——三根伸缩连杆托起整个脑袋能实现抬头、歪头、点头、转动等接近人类的细腻动作加上身体旋转和两根独立转动的天线一共9个自由度。真正有意思的是那两根天线。它们不只是装饰而是机器人的耳朵和心情晴雨表开心时竖起疑惑时左右摇摆困了会垂下来。配合自带的唤醒犯困等音效Reachy Mini能在几行代码内完成一套完整的情绪表达。相比传统机器人冷冰冰的机械感这种拟人化设计让交互变得格外亲切。而最打动人的是它的开源属性从3D打印的STL零件文件、电机配置到完整的Python/JavaScript SDK全部开放。你可以改结构、换传感器、写自己的行为逻辑甚至给社区贡献新的性格。硬件拆解30厘米小身体里藏了什么Reachy Mini整机约30×20×15.5厘米重1.4公斤出头是标准的桌面尺寸。拆开外壳核心配置相当扎实电机系统底座1个定制Dynamixel XC330电机负责身体旋转6个XL330电机驱动斯图尔特平台的六根连杆2个XL330电机控制天线共9颗电机协同工作视觉120°广角摄像头1200万像素带自动对焦可实时输出视频流听觉4麦克风阵列支持声源定位能判断声音来自哪个方向内置5W扬声器大脑无线版内置树莓派Compute Module 44GB内存带IMU惯性传感器和Wi-Fi完全自主运行安全设计软件限位自动钳制、碰撞检测、过流/过温保护电池自带BMS管理芯片两颗关键细节头部俯仰和横滚限制在±40°身体旋转±160°头部与身体的偏航差不能超过65°——这些安全限制由SDK自动强制执行即使你写错坐标机器人也会自动收回到安全姿态不会扭断脖子。此外支持重力补偿模式电机保持通电但松弛你可以用手掰动它的头教它动作这就是演示教学的基础。三步装好自己的桌面机器人克隆、装依赖、连接上手流程比想象中简单核心就三步。第一步拉取代码并安装SDK。打开终端克隆项目仓库git clone https://gitcode.com/GitHub_Trending/re/reachy_mini cd reachy_mini pip install -e .建议用uv代替pip安装速度能快10~100倍项目会自动检测找不到就回退到pip。装完记得建一个Python虚拟环境避免包冲突。第二步选择你的连接方式。项目提供三个版本按需挑选版本连接方式适用人群Reachy Mini无线版机身自带树莓派Wi-Fi开箱即连想拥有全自主机器人的人Reachy Mini Lite有线版USB直连电脑用台式机算力驱动开发者、预算有限的玩家模拟器版无需硬件MuJoCo物理引擎零成本入门、先学后买无线版首次使用需下载Reachy Mini Control桌面应用按引导把机器人连上你家Wi-FiLite版插上USB即可模拟器版直接跑一条命令就弹出3D窗口。第三步启动守护进程。Reachy Mini采用客户端-服务器架构守护进程Daemon负责和电机、传感器打交道你的代码通过SDK连接它。Lite和模拟器版在终端运行reachy-mini-daemon --sim加--sim就是模拟器无线版开机即自动运行。浏览器打开http://localhost:8000/docs能看到完整的API文档看到它就算就绪了。第一行代码让机器人跟你打招呼装好环境后用Python写个十几行的脚本就能让机器人动起来。先来个最经典的天线摇摆问候from reachy_mini import ReachyMini 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(antennas[0, 0], duration0.5) # 归位这段代码做了一件很拟人的事像人左右歪头一样让两根天线交替摆动。duration0.5表示每次动作花0.5秒平滑完成看起来自然不生硬。接着让机器人抬头看你——这是项目文档里的经典示例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)的意思是头抬高10毫米、侧倾15度。degreesTrue和mmTrue让单位一目了然——角度用度、距离用毫米不用猜弧度。你甚至可以让它看向三维空间里的某个点mini.look_at_world(x0.3, y0.2, z0.5)这句话的含义是让机器人的视线对准面前30厘米、偏右20厘米、高50厘米的那个位置它会自动反解出九个电机各自该转多少。动作插值支持linear线性、minjerk最小加加速度默认、ease_in_out、cartoon四种风格——换一种插值同一个动作的气质就完全不一样。进阶玩法让它看、听、说、追机器人的价值不止在动更在感知。SDK把这些能力封装得相当顺手。看一行代码拿到摄像头画面返回的就是numpy数组可直接丢给OpenCVframe mini.media.get_frame() # 返回 (高, 宽, 3) 的 uint8 数组听4麦克风阵列不仅能录音还能算声源方向doa, is_speech mini.media.get_DoA() # 返回声源角度和是否检测到人声追开启人脸追踪机器人会盯住最近的人脸并让头跟着转瞄准鼻子位置mini.start_head_tracking() face mini.get_tracked_face() # 返回 detected, x, y, roll说把音频样本推给扬声器播放配合语音合成就能让它开口说话还能录下你用手掰出来的动作序列并回放——start_recording()开始录、stop_recording()结束、play_move()回放一套演示教学复现闭环就完成了。开源机器人AI集成给机器人装上大脑Reachy Mini的目标用户是AI开发者所以AI集成是它的主场。官方提供了一条完整的应用化路径用CLI工具生成应用骨架直接发布到Hugging Face Spaces任何人点开链接就能通过浏览器控制你的机器人——底层用WebRTC传输视频、音频和指令对方不需要装任何软件。目前官方商店里已经有不少现成玩法对话应用集成LLM实现自然语音对话语音检测大模型语音合成三件套手势跟踪实时追踪你的手机器人跟着你的手势动电台应用让机器人陪你听广播想自己搞定制AI管线也完全可行。比如你有个自研的OpenCV检测器或Whisper语音识别只需要初始化时加一个参数media_backendno_mediaSDK就会释放摄像头和麦克风硬件把控制权交给你自己的代码。另外daemon暴露了完整的REST API和WebSocket接口/api/state/full、/api/state/ws/full想用非Python语言写控制器、做仪表盘甚至搭MCP服务器都有现成通道。新手最容易踩的5个坑结合社区反馈我把高频问题整理成一份避坑清单按顺序排查能解决90%的问题。先更新再折腾遇到任何怪问题第一反应是更新软件并重启机器人关机等5秒再开机。这个老土的办法能解决相当多已知问题。电机发红闪灯多半是供电或短路。检查从脚部到头部那条电源线和电机三芯线是否破损、是否插紧。注意USB口供电不足Lite版必须插7V电源才能驱动电机。电机没反应但不报错大概率是电机处于松弛状态没上电。检查电机模式如果是Disabled先调用enable_motors()再wake_up()。麦克风静音/录出来全是零先怀疑排线插反了——黑色排线有字的一面要朝上。排线没插反还不行再查固件版本是否达到2.1.3。天线狂抖天线转到竖直0°时会因齿轮间隙陷入倒立摆式震荡这是物理特性不是故障。把天线偏移个10°左右让重力帮忙压住即可新版固件已默认处理。另外提醒两个小知识装完零件盒里剩几颗螺丝和线材是正常的官方故意多给备件reachy-mini.local这个地址在公司、酒店Wi-Fi下可能解析不了客户端隔离所致换成手机热点就通了。灵感库拿到手之后能做什么有了一台会动会看会听的桌面机器人玩法边界取决于想象力。这里抛几个方向供参考编程教育助手让机器人用肢体动作演算法——排序时手忙脚乱地比划理解递归时歪头思考孩子学编程的兴致会完全不同远程临场伙伴无线版自带摄像头和扬声器集成视频通话后远方的家人可以通过这台小机器人陪你工作动作让通话更生动艺术表演装置9个自由度可录可放的动作系统配合音乐编排一支桌面舞蹈加上灯光就是迷你舞台人机交互研究平台声源定位、人脸追踪、重力补偿演示教学这些现成能力让它成为社交机器人研究和运动规划算法的理想实验台没有硬件也能玩先上模拟器这里特别提醒预算或硬件还没到位的朋友项目内置了基于MuJoCo的完整模拟器物理引擎和真实硬件行为一致。装依赖时多带一个[mujoco]后缀pip install reachy-mini[mujoco]然后运行reachy-mini-daemon --sim一个3D窗口就会出现你的机器人鼠标拖拽即可旋转视角。还有--scene minimal参数能给模拟环境加上桌子和苹果、牛角包等小道具方便测试拿取类逻辑。模拟器里的SDK代码和真机完全通用——你写好的脚本将来无缝迁移到实体机。社区与下一步Reachy Mini的背后是Pollen Robotics团队和活跃的开源社区Discord上聚集了数千名开发者分享作品、互相答疑。路线图上有几个值得期待的方向iOS/Android手机端应用手机上控制机器人逛应用商店、AI协作编程空间用自然语言实时聊出一个应用、社区Pimp my Reachy Mini改壳运动等。项目采用Apache 2.0开源协议硬件设计文件采用CC BY-SA-NC协议。到这里你已经掌握了开源情感机器人Reachy Mini从组装、安装、首段代码到AI集成的完整路径。下一步建议先跑通上面的天线摇摆示例然后打开项目里的examples/目录挑一个顺眼的例子人脸追踪、声源定位、录音回放都值得一试再试着把对话应用装上让机器人真正开口。从让一根天线动起来到给它装上会聊天的大脑——你的第一台情感机器人就差这一行代码了。【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考