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 모듈)를 트리거할 수 있습니다.
  • Safety: 특정 도구에 대해 "dangerous" 플래그를 지원하여, 사용자가 ""YES"" 또는 ""NO""라고 말로 직접 확인해야 합니다.

Who it’s for

커스텀 도구를 통해 확장 가능한, 개인정보가 보호되는 기기 내 AI 데스크톱 장난감 또는 홈 오토메이션 에이전트를 원하는 하드웨어 애호가 및 Raspberry Pi 사용자.

Highlights

  • 100% Local: 클라우드 의존성 없이 완전히 기기 내에서 작동합니다.

  • Custom Tooling: src/tools/ 디렉토리에 JavaScript 모듈을 생성하여 새로운 기능을 쉽게 추가할 수 있습니다.

  • Hardware Integration: Raspberry Pi 5 및 호환 가능한 스크린/쿨러와 함께 작동하도록 설계되었습니다.

  • Safety Confirmation: 고위험 작업에 대해 내장된 확인 프로세스가 있습니다.

  • Visual Feedback: 에이전트의 상태를 표시하기 위한 애니메이션 캐릭터 UI가 포함되어 있습니다.