syxanash/maxheadbox

해결하는 문제

Max Headbox는 Raspberry Pi에 완전히 로컬로 작동하는 음성 인식형 AI 어시스턴트를 만들 수 있는 방법을 제공합니다. 클라우드 기반 AI 제공업체에 의존할 필요 없이, 개인정보 보호와 오프라인 기능을 보장하면서도 디바이스의 물리적 하드웨어와 상호작용하고 제어할 수 있게 해줍니다.

작동 방식

이 시스템은 음성 처리와 LLM 추론에 로컬 도구를 조합하여 사용합니다:

• 음성 활성화: 웨이크워드 감지에는 Vosk를, 음성 텍스트 변환에는 faster-whisper를 사용합니다.
• 뇌: Ollama를 통해 로컬에서 LLM을 실행합니다 (예: gemma3:1b 및 gemma4:e2b와 같은 모델 사용).
• 실행: Node.js/Express로 구축된 프론트엔드가 에이전트 로직과 도구 오케스트레이션을 처리하고, Python 백엔드가 Raspberry Pi의 하드웨어 상호작용을 관리합니다.
• 도구: 사용자는 커스텀 자바스크립트 모듈을 정의하여 에이전트가 특정 작업을 수행할 수 있도록 하며, 민감한 작업의 경우 사용자 수동 확인을 요구하는 "위험" 플래그를 제공합니다.

대상 사용자

Raspberry Pi 5를 사용하여 물리적인 AI 데스크 토이 또는 로컬 홈 오토메이션 허브를 만들고 싶은 취미가 있는 사용자 및 제작자에게 적합합니다.

주요 특징

• 100% 로컬: 클라우드 종속 없이 완전히 디바이스 내에서 작동합니다.
• 음성 기반: 통합된 웨이크워드 및 음성 인식 파이프라인을 제공합니다.
• 확장 가능한 도구: 커스텀 자동화 기능을 추가할 수 있는 간단한 JS 기반 시스템입니다.
• 안전 장치: 위험으로 표시된 도구에 대해 내장된 확인 흐름을 제공합니다.
• 시각 피드백: 에이전트의 상태(생각 중, 대기 중 등)를 나타내는 애니메이션 캐릭터 UI를 포함합니다.