syxanash/maxheadbox

解決的問題

Max Headbox 提供了一種在 Raspberry Pi 上建立完全本地化、語音觸發的 AI 助手的方法。它無需依賴雲端 AI 服務商，確保隱私與離線功能，同時讓 AI 能與裝置上的實體硬體互動並控制。

工作原理

此系統結合使用本地工具進行語音處理與 LLM 推論：

• 語音啟動：使用 Vosk 進行喚醒詞偵測，並以 faster-whisper 將語音轉換為文字。
• 大腦：透過 Ollama 在本地執行 LLM（例如使用 gemma3:1b 和 gemma4:e2b 等模型）。
• 執行：使用 Node.js/Express 建構的前端處理代理邏輯與工具編排，Python 後端則負責管理 Raspberry Pi 的硬體互動。
• 工具：使用者可定義自訂 JavaScript 模組，讓代理執行特定動作，並可為敏感任務啟用「危險」旗標，以要求使用者手動確認。

適用對象

專為希望使用 Raspberry Pi 5 建構實體 AI 桌上玩具或本地家庭自動化中心的愛好者與創作者設計。

主要亮點

• 100% 本地化：完全在裝置上運作，無需雲端依賴。
• 語音驅動：整合的喚醒詞與語音轉錄流程。
• 可擴展工具：簡單的 JS 系統，方便新增自訂自動化功能。
• 安全防護：對標記為危險的工具內建確認流程。
• 視覺反饋：包含動畫角色 UI，用以顯示代理的狀態（思考中、休眠中等）。