OHF-Voice/linux-voice-assistant

解決的問題

此專案可將任何 Linux 裝置轉變為 Home Assistant 的智慧語音衛星。您無需依賴雲端服務，即可透過自訂喇叭與家庭自動化系統對話，且能在本地檢測喚醒詞，始終處於聆聽狀態，而無需將音訊傳送至雲端。

工作原理

在完整的 Linux 系統（支援 PulseAudio 或 PipeWire 音訊）上執行，並透過 ESPHome 協定連接至 Home Assistant。當您說出喚醒詞（如「Okay Nabu」）時，OpenWakeWord 或 MicroWakeWord 模型會在裝置上檢測到該詞，隨後音訊將被串流至 Home Assistant 的 Assist 流水線，用於語音轉文字、意圖處理和文字轉語音。它也支援定時器、廣播和持續對話功能。配備 DSP 芯片（如 Satellite1 或 Respeaker）的麥克風陣列可處理遠場音訊，具備降噪與回音消除能力。

適用對象

希望在家中建構自己的語音控制智慧喇叭，尤其是使用 Home Assistant 且傾向於使用 Linux 裝置而非僅限微控制器的衛星裝置的使用者。也適合希望微調喚醒詞、整合按鈕/LED 或實驗 PipeWire 的愛好者。

主要亮點

• 使用 OpenWakeWord 或 MicroWakeWord 實現裝置本地喚醒詞檢測，支援多個喚醒詞與多種語言
• 與 Home Assistant 的 Assist 流水線無縫整合，包含廣播、開始/繼續對話與定時器功能
• 可在常見硬體上運行：x64 或 ARM64，1GHz CPU 與 512MB RAM；可運行於 Raspberry Pi Zero 2W 或 Pi 3 上
• 內建 WebSocket API，可用於連接按鈕、LED 等周邊裝置
• 提供 Docker 鏡像、Home Assistant 插件或可直接刷寫的 Raspberry Pi 鏡像