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，用于指示代理的状态（思考中、休眠中等）。