从零打造你的第一个情感机器人Reachy Mini 开源机器人实战手记【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_miniReachy Mini 是一个开源、可表达情感的桌面机器人项目它把会点头、会摇天线、能听懂你说话的机器人伙伴变成了任何人都能亲手组装和编程的现实。项目提供完整的 Python SDK、模拟器、示例代码与 AI 集成方案从新手到进阶开发者都能在几小时内让它活起来。这篇文章我想以第一人称带你完整走一遍从拆箱到开口说话的全过程。一个会来劲的桌面小家伙凭什么第一次看到 Reachy Mini 的演示视频我愣了好几秒。视频里那个白色的小机器人没有机械臂、没有轮子只有一个圆圆的脑袋和两根天线却会在说话时轻轻歪头、在开心时把天线竖起来。它不像机器更像一只在认真听你讲话的宠物。这让我忍不住想一个没有腿、没有手的机器人凭什么能传递情绪答案是它的脖子。Reachy Mini 的头部不是普通的两轴转台而是一个6 自由度的斯图尔特平台——就是那种飞行模拟器里用的并联机构。六个小型电机推动六根连杆让头部能完成俯仰、侧倾、偏航甚至微妙的平移。配合头顶两根独立控制的天线它能在点头之外做出歪头思考、左右张望、天线一高一低表示疑惑这类拟人化的小动作。传统机器人给人冷冰冰的感觉往往不是因为功能不够而是因为动作太硬。而 Reachy Mini 的运动系统从一开始就为表达而设计它的 SDK 里甚至内置了说话时轻轻摇摆头部的功能让 TTS 语音播报时机器人不再呆站着。这些细节就是它有灵魂的原因。拆开盒子8 个电机与一套脖子的奥秘把 Reachy Mini 拆开硬件其实非常克制头部 6 个电机驱动斯图尔特平台躯干 1 个电机负责身体转向再加 1 个电机控制天线组总共 8 个高精度电机协同工作。所有 3D 打印文件、电路图纸、固件源码全部开源这意味着你不仅能组装还能随手改。它的感官也很齐全一颗 120° 广角摄像头负责看4 麦克风阵列支持声源定位——它能判断声音从哪个方向来然后转头看向说话的人内置扬声器负责说还能通过音频接口播放任意声音。整机分两个版本无线版自带树莓派 CM4 和电池插电即自主运行Lite 版通过 USB 连电脑适合开发者调试。无论哪个版本控制核心都是一个叫Daemon的后台服务它负责跟电机、传感器打交道对外暴露 REST API 和 WebSocket 接口而你的 Python 代码只需要通过 SDK 连上这个服务即可。十分钟让一个机器人对你点头如果你和我一样没有实体硬件别急——项目提供了基于 MuJoCo 的完整模拟器所有 API 与真实硬件完全一致。打开终端启动模拟 daemonreachy-mini-daemon --sim这一行命令会在你的电脑上启动一个虚拟机器人它会监听 8000 端口等待你的指令。是不是很像给一个游戏服务器开了个房间只不过这个玩家是机器人。接下来安装 SDKgit clone https://gitcode.com/GitHub_Trending/re/reachy_mini cd reachy_mini pip install -e .安装完成后打开浏览器访问http://localhost:8000/docs如果能看到 API 文档页面说明你的虚拟机器人已经就绪。整个过程大约十分钟真正的硬件版也只是把连接方式从--sim换成 USB 或 Wi-Fi 而已。亲手写第一行代码摇天线、抬头看你连接就绪后第一次驾驶机器人的体验非常奇妙。项目官方 quickstart 里有一个最经典的例子让机器人摇动天线向你打招呼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)goto_target的意思是在指定时间内平滑地走到某个目标姿态antennas[0.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表示头部微微抬高 10 毫米roll15表示侧倾 15 度——运行这一秒你会真切感到那个圆脑袋在注视你。这种体验很难用文字传达我建议你亲手跑一次。如果你想让动作更活项目还提供了set_target高频直控接口可以在 100Hz 下实时计算正弦波让头部和天线像呼吸一样自然摆动import time, numpy as np with ReachyMini(media_backendno_media) as mini: while True: t time.time() pitch np.deg2rad(10 * np.sin(2 * np.pi * 0.5 * t)) mini.set_target( headcreate_head_pose(pitchpitch, degreesFalse, mmFalse), antennas[np.deg2rad(20 * np.sin(2 * np.pi * 0.5 * t))] * 2, ) time.sleep(0.01) # 100 Hz这段代码让机器人的头部和天线按正弦曲线轻轻晃动配合 10 毫秒的刷新间隔运动非常丝滑。把数学公式变成活生生的动作这就是机器人编程最迷人的地方。让它看见、听见、开口说话运动只是第一步。Reachy Mini 的media模块把摄像头和麦克风封装成了极简接口比如拍一张照片with ReachyMini() as mini: frame mini.media.get_frame() # 拿到一帧画面 cv2.imwrite(reachy_mini_picture.jpg, frame)get_frame()返回摄像头的一帧图像配合 OpenCV 就能做实时视觉处理。录音也差不多mini.media.start_recording() # ... 循环获取音频样本 ... mini.media.stop_recording()真正让我惊喜的是 TTS 示例它调用 Hugging Face 上的多语言语音克隆服务生成音频然后让机器人播放同时自动开启头部摇摆——机器人说话时脑袋会跟着节奏轻轻晃动活脱脱一个在认真讲话的小演讲家。声源定位示例则让机器人能听到声音从哪来、转向声源。当它真的看向你说话的方向时那种被注视的感觉是任何屏幕上的虚拟形象都给不了的。给机器人装上AI 大脑Reachy Mini 的野心不止于会动更在于会思考。它的生态里有一个基于 Hugging Face Spaces 的应用商店对话应用让机器人接上大语言模型自然聊天手部追踪应用让机器人实时跟随你的手部动作还有电台、教育等各类应用一键安装即用。开发自己的 AI 应用也异常顺畅SDK 同时提供 Python 和 JavaScript 版本后者通过 WebRTC 让浏览器直接驱动机器人写好的应用分享出去别人打开网页就能操控你的机器人零安装。你可以把视觉模型、语音模型、大语言模型统统接进去让它真正成为你的 AI 实体化身。我还注意到项目为 AI 编程助手准备了AGENTS.md指南——把我想创建一个 Reachy Mini 应用这句话粘贴给 Claude Code 或 Copilot智能体就能读懂 SDK 规范直接帮你生成代码。用 AI 编程做机器人这大概是 2026 年最省力的玩法了。没有硬件模拟器同样能玩如果你暂时没有实体机器人完全不必劝退。模拟器支持全部核心 API运动、视觉、音频、甚至重力补偿模式都能体验。你可以在模拟环境里调试好整套行为逻辑等硬件到手直接无缝切换。先练手、后上手成本几乎为零。另外SDK 对安全性的考虑也很贴心头部俯仰和侧倾限制在 ±40 度、身体转向限制在 ±160 度一旦超过安全范围SDK 会自动把目标值钳制到最近的安全位置防止机器人自己撞伤自己。还有刚性模式、断电松弛模式、重力补偿模式三种电机状态后者让你可以徒手掰动它的头它会像被捏住后停住的小动物一样停在原地等你松手。关于常见疑问的几点解答问完全没有机器人基础能玩转吗能。项目提供了 Jupyter 教程笔记本从连接、移动到媒体播放一步步引导跟着敲就能跑通第一个 demo。问需要哪些软件环境Python 3.8 以上即可建议使用 uv 或 pip 创建虚拟环境运行媒体功能需要安装 GStreamer文档里有针对各操作系统的详细说明。问跑不动视觉模型怎么办分布式架构的好处就在这——SDK 可以在你性能强劲的电脑上运行 AI 逻辑Daemon 在树莓派上管硬件两者通过网络通信各司其职。别等了让第一个机器人动起来回头看看整个过程十分钟装好环境半小时跑通第一个动作一个下午让它学会说话和转头——Reachy Mini 最打动我的是它把机器人从遥不可及的神坛上拉了下来。你不需要焊接电路板不需要写底层驱动只需要会写几句 Python就能拥有一个会回应你的桌面伙伴。创造的过程往往比结果更有趣。从让天线摆动第一下开始到给它装上一个会说冷笑话的 AI 大脑每一步都是你自己的作品。项目仓库就在https://gitcode.com/GitHub_Trending/re/reachy_mini克隆下来运行模拟器写下属于你的第一行机器人代码。你的机器人之旅现在就可以开始。【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考