Reachy Stories

Reachy Stories

让孩子和 Reachy Mini 机器人一起编睡前故事：机器人问三个问题，孩子用语音回答，机器人写出故事并朗读。适合家庭和机器人开发者。

由 pollen-robotics 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：Reachy Stories 让孩子和 Reachy Mini 机器人一起编一个睡前故事。机器人问三个简短的问题，分别关于英雄、地点和一件魔法物品。孩子用语音回答，机器人随后写出一个按目标时长计时的完整故事并朗读出来。繁重的计算在 ZeroGPU 后端上运行。

适合谁：适合拥有 Reachy Mini 的家庭和教育者，也适合想研究语音驱动机器人应用的开发者。

Title: 谁会用这个应用
Industry | Who uses it | How they use it | Example
家庭生活 | 家长 | 和孩子一起编睡前故事 | 孩子说出一个英雄、一个地点和一件魔法物品
教育 | 教师 | 用机器人讲故事者做听力活动 | 和一小组孩子一起完成一个故事
机器人 | 开发者 | 研究一个会听会说的机器人应用 | 阅读机器人链路是怎么通过 WebRTC 搭建的

如果你没有 Reachy Mini 机器人，可以跳过它，因为朗读是通过机器人播放的，而不是浏览器。

用在哪里：你用浏览器来启动，用机器人来听故事。

• 网页浏览器：Hugging Face 上这个 Space 的页面，你在这里登录并选择你的机器人
• Reachy Mini 机器人：它的麦克风听孩子说话，它的扬声器播放故事
• Windows、macOS 或 Linux：用 Python 3.12 运行的本地副本

Title: 这个应用适合做什么
Use case | Who | What they get back
共同创作睡前故事 | 孩子和家长 | 一个由机器人朗读的完整故事
看图编故事 | 家庭 | Gemma 根据机器人摄像头拍的照片写出的故事
在机器人链路上开发 | 开发者 | 一个通过 WebRTC 连接机器人的可运行示例

如何设置：托管的 Space 只需要一个机器人和一个账户。本地副本需要更多东西。

• 一台 Reachy Mini 机器人
• 一个 Hugging Face 账户，用于登录步骤
• Python 3.12 和 pip
• Node 和 npm，只有当你修改 ts 文件夹下的浏览器代码时才需要

1. 安装 huggingface_hub 包。
2. 把这个 Space 的文件下载到一个文件夹。
3. 进入这个文件夹。
4. 安装 Gradio 6.15.2。
5. 安装 requirements.txt 里的包。
6. 用 Python 启动应用。

pip install -U huggingface_hub
hf download pollen-robotics/reachy-stories --repo-type space --local-dir reachy-stories
cd reachy-stories
pip install gradio==6.15.2
pip install -r requirements.txt
python app.py

如果你修改了浏览器代码，要重新构建，让 static 文件夹里的预构建文件保持最新。

cd ts && npm install && npm run build   # outputs to ../static/

如何使用：在线打开这个 Space，或者用上面的命令启动你的副本。用 Hugging Face 登录，选择你的机器人，让机器人问它的三个问题。孩子大声回答，然后听故事。

Title: 仓库的各个部分
Tool | What it does
app.py | 为每个机器人打开一个会话的后端
central_consumer.py | 接收机器人的麦克风音频，并把声音送回它的扬声器
gpu_worker.py | 把 GPU 工作作为独立的调用来运行
ts | 负责登录和选择机器人的浏览器代码，构建到 static 文件夹里

示例：孩子告诉机器人，英雄是一只勇敢的狐狸，地点是下雪的森林，魔法物品是一盏灯笼。机器人围绕这三样东西写出一个故事，并通过它的扬声器朗读出来。

新手与专家：如果你刚接触，先从三个问题开始，答案尽量简短。孩子听到的一切都来自机器人，所以让机器人离得近一些。

如果你熟悉这个领域，每个会话有一个工作线程，按三个阶段运行脚本：采访、生成和朗读。GPU 任务以独立调用的方式运行：Gemma 先取出每个口头回答，再写出整个故事。Kokoro 把朗读分成有界的块来合成，所以长达几分钟的朗读也不会一直占着 GPU。朗读时机器人会晃头，收到浏览器的消息时会拨动天线。

孩子用语音回答三个问题
Gemma 提取每个回答
Gemma 写出完整故事
Kokoro 分块朗读
机器人说话并动起来

注意事项：音频发往机器人，浏览器只负责登录。

• 声音：浏览器里不播放任何东西
• 登录：浏览器会把你的 Hugging Face 令牌、机器人的 id 和一个连接请求发送给后端
• 摄像头：Gemma 还可以根据机器人摄像头拍的图片写故事
• 语音：Kokoro 以 24 kHz 发声
• License: apache-2
• Cost to run: 一台 Reachy Mini 机器人、一个 Hugging Face 账户和 ZeroGPU 时间，没有提到其他付费服务
• Data it reaches: 孩子通过机器人麦克风说出的回答、任何摄像头图片，以及你的 Hugging Face 令牌
• Not for: 在浏览器里播放故事，因为音频发往机器人的扬声器

Hugging Face 上的数据（2026年11月13日）

• 点赞：1
• 构建方式：gradio
• 许可证：apache-2.0

链接

• Space：https://huggingface.co/spaces/pollen-robotics/reachy-stories
• 文件：https://huggingface.co/spaces/pollen-robotics/reachy-stories/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。