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 語音助理專案的精神，為持續在線的語音介面提供一個現代、社群驅動的堅實基礎。