四步把 Reachy Mini 应用搭建并部署到 Hugging Face

四步把 Reachy Mini 应用搭建并部署到 Hugging Face

【免费下载链接】reachy_miniReachy Mini's SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini

Reachy Mini 是一款开源桌面机器人，它的 Python SDK 让你可以为它编写"应用"：驱动动作、播放声音、读取摄像头，甚至接入对话逻辑。写好的应用不必只留在你自己的电脑里，几条命令就能把它发布到 Hugging Face，让任何一台机器人拉取并运行。下面记录一条完整的动手路线：搭建、自检、发布，共四步。

这条路解决什么问题

问题出在环境，不在代码

做一个能让机器人动起来的小演示，代码往往是最快的部分，真正拖时间的是依赖怎么装、怎么装到机器人上、怎么交给别人用。

SDK 把这件事拆开了

reachy_mini 的应用机制把上面三件事各自收敛成一条命令，统一入口是python -m reachy_mini.apps。对用户来说，应用只是一个普通的 Python 包，发布后按名字被发现、安装和启动。所以这条路线适合两类人：想先看看应用能做什么的新手（先搭一个），以及想把本地跑通的东西交付出去的开发者。

三步搭起并跑通第一个应用

一键创建项目

运行创建子命令，不传参数时它会交互式地问你应用名和存放路径：

python -m reachy_mini.apps create my_first_app

应用名中的连字符会被自动换成下划线，类名也由它推导出来，不用手工对齐。模板有两个选择：默认的空应用，和从对话应用 fork 出来的 conversation 模板。注意一个限制：目标路径不能位于已有的 git 仓库内，否则会直接拒绝创建。

项目结构与跑通演示

生成后的目录里有几样东西：pyproject.toml管理依赖并注册入口点，README.md自带必需元数据，index.html和style.css是应用在商店里的展示页，与项目同名的目录里放着main.py和static/资源。

main.py里已经有一个继承ReachyMiniApp的类，run方法填了演示逻辑：头部做偏航摆动、两根天线交替摆动，还能播放一段提示音。跑起来后你能直观看到主循环在工作。应用靠pyproject.toml中reachy_mini_apps组下的入口点被管理器发现和启动，不需要额外的启动脚本。

发布前自检：一条命令查完

它检查什么

check 子命令按顺序验证：pyproject.toml的项目名与入口点是否一致、main.py中是否有继承ReachyMiniApp的类、README.md元数据是否有 title 和reachy_mini标签。最后一步最值钱：它会建一个临时虚拟环境，把你的应用 pip 装进去，确认入口点注册成功，再卸载并确认卸干净。

怎么读报告

python -m reachy_mini.apps check path/to/your_app

任何一项不通过都会停下并指出具体是哪个文件缺了什么，不用你逐项去猜。

一行命令上架 Hugging Face

前置条件

需要 Hugging Face 账户和 token；如果当前没登录，命令会提示你先登录。想分发出去的话，把 git 的用户名和邮箱配好更省事。

发布命令

python -m reachy_mini.apps publish path/to/your_app "首版"

项目里有本地 git 仓库时走 git push 流程；缺 git 凭证时自动改用 HF API 直接上传，不会卡住。默认创建公开 Space，加--private可改为私有；发布后想进官方应用列表，加--official提交审核申请即可。手快的话，create 命令也支持直接带--publish，搭完就发。

进阶：两个常用开关

自定义 Web 配置页

把类属性custom_app_url设成一个地址（例如 8042 端口），应用启动时会带起一个 Web 服务，static/目录就是配置页本体，还可以挂上 FastAPI 路由让用户调参。用不到的话保持 None，Web 服务不启动，对机器人侧内存更友好。

选择媒体后端

媒体后端默认自动检测。确定要低延迟推流时，把类属性request_media_backend设为 gstreamer；在无线版机器人上，若应用不处理视频，建议用 gstreamer_no_video 降低 CPU 占用。

常见问题

问：机器上没有 git 凭证，还能发布吗？可以。git 流程失败或缺凭证时，会回退到 HF API 上传，token 有效即可。

问：check 报入口点错误，查哪里？看pyproject.toml的 entry-points 是否指向main.py里的类，类名要和项目名对应（连字符转下划线、每个单词首字母大写）。

问：发布后为什么官方列表里没有？发布只是进了你自己的 Space。进入官方列表需要发布时加--official申请审核，通过后才会上架。

问：无线版和有线版机器人要分别适配吗？SDK 同时支持实机与仿真后端，同一个应用可以先在仿真里调通，再上真机；媒体后端按前面一节按需选择。

搭起来、查一遍、发出去，整个流程就是三条命令加几个类属性，真正耗时间的部分都集中在run方法里。更多场景可以看 示例应用集合、官方文档 和 开发技能笔记。

【免费下载链接】reachy_miniReachy Mini's SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini