应用商店里有什么
Reachy Mini 的 App Store 由 Hugging Face Spaces 驱动,社区把做好的应用发布成一个个 Space,桌面端和机器人把它们拉下来直接运行。官方举的三个例子是 Conversation App,让机器人开口对话;Radio,用来播放电台;Hand Tracker,用手势带动头部跟随。这一页讲的是把现成应用装到自己的机器上跑起来,从找到它、装上去,到启动和停止。想亲手写应用,走的是用脚手架生成骨架、实现运行契约的另一条路。
从发现到停止:五个环节各自会看到什么
整条操作链是 Applications → Discover Apps → Install → Start → Stop,都在 Reachy Mini Control 里完成。下面按点的顺序说明每一步做什么、做完该出现什么、卡住了先查哪里。
- Applications:打开 Control 的 Applications 标签页,会看到本机已装应用的列表和商店入口。列表是空的说明这台机器还没装过应用,属于正常状态,直接进下一步即可。
- Discover Apps:点进去会列出来自 Hugging Face Spaces 的可安装应用卡片,可以按名字和分类翻找。卡片一直转圈或刷不出来,先确认机器能联网;国内访问 Hugging Face 受限时按官方 FAQ 给的镜像方式处理,别急着反复点刷新。
- Install:选一个应用点 Install,会看到下载和依赖安装进度,装完卡片进入已安装列表。进度卡住多半是网络或依赖拉不全,确认联网后重试;在 Reachy Mini Wireless 上所有应用共用同一个虚拟环境,依赖装不进时留意是不是和别的应用撞了版本。
- Start:点 Start(启动按钮)后应用开始运行,机器人按应用逻辑动作,界面上该应用显示为运行中、出现 Stop 按钮。点了没反应、或提示已在运行,先回列表看是不是已经有一个应用没停干净。
- Stop:点 Stop(停止按钮)让应用退出,界面回到未运行状态,机器人收住动作。Stop 之后再去跑自己的脚本才不会抢连接。
一个时刻只能跑一个应用
最容易踩的坑是应用运行期间会独占机器人。同一时刻只能运行一个应用,想开第二个得先把当前这个 Stop 掉。更关键的是,应用在跑的时候不能再同时跑自己的 Python 脚本去连机器人,两边都抢占硬件控制权,后发起的连接拿不到电机。卡在脚本连不上时,先回 Applications 页确认没有应用在后台运行,再重跑脚本,这通常比逐行查代码更快定位问题;确认停干净后仍连不上,再去查 daemon 和端口那一层。
一次启动到退出的完整生命周期
点下 Start 之后 daemon 在背后按固定顺序做几件事,理解它能帮你看懂日志里的现象:
| 阶段 | 发生什么 | 会看到什么 |
|---|---|---|
| 起进程 | daemon 起一个 Python 子进程 python -u -m your_app.main
|
应用出现在运行列表,日志开始滚动 |
| 注入连接 | 把已连接的 ReachyMini 实例和 stop_event 传给应用 |
应用不用自己连硬件,直接拿到可操作对象 |
| 停止 | daemon 向子进程发 SIGINT,应用优雅退出 | 正在做的动作收住,进程结束 |
| 退出后 | 机器人回到默认姿态 | 头摆正、天线回中位 |
正因为连接是 daemon 建好再交进来的,应用本身不负责管理硬件连接。在 Reachy Mini Wireless 上,应用跑在共享虚拟环境 /venvs/apps_venv/ 里,依赖由所有应用共用;Reachy Mini Lite 上则由桌面端拉起同样的进程。装应用时留意依赖冲突,环境异常时回到 Control 做对应档位的重置,重装前先确认已停掉所有应用。
把一个应用从验证到设为开机自启
拿到或写好一个应用后,官方给的验证链是从静态检查走到开机自启,按顺序每一步都有明确的预期结果:
-
reachy-mini-app-assistant check:校验应用结构和契约是否符合要求。会看到检查项逐条通过或报出具体哪一条不合格;报错就按提示补齐缺的字段再重跑,先别往后面走。 -
python -m my_app.main:脱离商店、直接本地跑主模块,确认应用逻辑本身没问题。会看到应用自己的输出;这一步没走 daemon 注入连接,连不上机器人是正常的,别当成应用写坏了。 - 经 daemon 起停:用
curl /api/apps/start-app/...让 daemon 按上面那套真实生命周期启动应用,再用对应的停止接口停掉。会看到机器人按应用逻辑动作,Stop 后回默认姿态。 -
--startup-app:把应用设为开机(Reachy Mini Wireless 上也能摸天线触发)自启。设好后重启一次验证,开机即自动进入应用,不用再手动点 Start。
应用自带的网页界面为什么刚打开是空的
应用想带一个网页界面时,在应用里设置 custom_app_url,daemon 会自动起一个 FastAPI 服务去托管 static/ 目录。Reachy Mini Lite 上访问 localhost:8042,Reachy Mini Wireless 上访问 reachy-mini.local:8042。刚 Start 就刷页面常见的是 404 或连不上,因为路由是在应用的 run() 启动之后才注册进服务的,页面要重试几次才会出现。知道这一点,就不会误以为应用没起来而去反复重装;若重试多次仍打不开,再确认应用确实在运行、8042 端口没被别的进程占着。
关于生态数字的两个日期
官方产品页在 2026-11-15 抓取时给出的是一组营销数字,只代表当时页面上的宣传口径,不作实时统计:
| 指标 | 官方产品页 2026-11-15 抓取 |
|---|---|
| apps | 530+ |
| moves | 400+ |
| makers | 14,000+ |
| posts | 1,500+ |
网上还流传「200+ 应用、近 10,000 台在野」这类说法,那是 2026-05 的二手口径,和上面 2026-11-15 的产品页数字来自不同时间点,不互相覆盖,也不要拿一个去否定另一个。看到任何这类生态数字,先认清它标的是哪一天的抓取或统计日期再引用。