syxanash/maxheadbox
Tiny truly local voice-activated LLM Agent that runs on a Raspberry Pi
What it solves
Max Headbox は、Raspberry Pi 上で完全にローカルかつ音声起動の AI アシスタントを作成する方法を提供します。クラウドベースの AI プロバイダーを必要とせず、プライバシーとオフライン機能を確保しながら、アシスタントが物理的なハードウェアと対話したり、デバイス上のタスクを自動化したりすることを可能にします。
How it works
このシステムは、音声処理と LLM 推論のために、ローカルツールの組み合わせを使用します：
- Voice Activation: Vosk を使用してウェイクワード検出を行い、
faster-whisperで音声をテキストに書き起こします。 - Intelligence: Ollama を介して LLM（Gemma など）をローカルで実行します。
- Agentic Logic: フロントエンドがエージェントのロジックを管理し、特定の操作を実行するために「ツール」（JavaScript モジュール）をトリガーできます。一部のツールは、Express.js と Python バックエンドを介して Raspberry Pi のハードウェアと対話します。
- Safety: 特定のツールに対して「dangerous」フラグをサポートしており、ユーザーに ""YES"" または ""NO"" と声で確認を求める必要があります。
Who it’s for
プライバシーを重視した、デバイス上で動作する AI デスクトイやホームオートメーションエージェントを求めており、カスタムツールで拡張可能な Raspberry Pi ユーザーやハードウェア愛好家向けです。
Highlights
- 100% Local: クラウドへの依存なしに、完全にデバイス上で動作します。
- Custom Tooling:
src/tools/ディレクトリに JavaScript モジュールを作成することで、簡単に新しい機能を追加できます。 - Hardware Integration: Raspberry Pi 5 と互換性のあるスクリーン/クーラー designed 向けに設計されています。
- Safety Confirmation: 高リスクな操作に対して、組み込みの確認フローがあります。
- Visual Feedback: エージェントの状態を示すための、アニメーションキャラクター UI が含まれています。