NaomiProject/Naomi

Naomi – 开源、始终监听的语音助手

是什么 – Naomi 是一个基于 Python 的平台，可在低性能硬件（Raspberry Pi 或任意 Linux 机器）上运行一个持续监听、语音控制的应用程序。它 fork 了旧的 Jasper 项目，并增加了模块化插件系统，使你可以通过简单的 Python 模块编写自己的“技能”（例如：查询网络、发布社交媒体内容、控制智能家居设备）。

核心功能

• 始终监听 – 麦克风输入持续捕获；唤醒词（或简单的声音阈值）触发命令解析。
• 可扩展的技能框架 – 开发者添加暴露 handle(text, mic, profile) 函数的 Python 模块；Naomi 将语音短语路由到相应的技能。
• 硬件无关 – 可在 Raspberry Pi 或任何带有支持麦克风的 Linux 机器上运行。
• 完全开源（MIT） – 所有代码、文档和示例技能均公开，鼓励自定义构建。

典型使用场景

• 家庭自动化：「Naomi，打开客厅灯。」
• 信息查询：「Naomi，今天天气怎么样？」
• 社交媒体发布：「Naomi，发一条‘Hello world!’的推文。」
• 个人提醒、计时器和日历查询。

快速上手

1. 安装 – 从官网下载最新版本或克隆仓库，然后运行 pip install -r requirements.txt（需 Python 3.5+）。
2. 配置 – 编辑 profile.yml（麦克风设备、唤醒词、你希望使用的服务的 API 密钥）。
3. 运行 – 执行 bin/naomi 启动守护进程；它将开始监听。
4. 添加技能 – 将新的 Python 模块放入 skills/ 目录，并遵循网站上记录的简单技能 API。

文档与支持 – 完整的开发者文档托管在 https://projectnaomi.com/dev/docs，还有一个 Discord 社区可用于故障排查和创意交流。

贡献指南 – 欢迎提交 Pull Request。请参阅 CONTRIBUTING.md 了解编码风格、测试要求以及添加新技能的流程。

许可证 – MIT（宽松，适合商业使用）。

---

Naomi 继承了 Jasper 语音助手项目的精神，为始终在线的语音接口提供了一个现代、社区驱动的坚实基础。