四步把 Reachy Mini 应用搭建并部署到 Hugging Face【免费下载链接】reachy_miniReachy Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_miniReachy 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 路由让用户调参。用不到的话保持 NoneWeb 服务不启动对机器人侧内存更友好。选择媒体后端媒体后端默认自动检测。确定要低延迟推流时把类属性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 Minis SDK项目地址: https://gitcode.com/GitHub_Trending/re/reachy_mini创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考