TL;DR

Brufik in One은 ESP32S3용 펌웨어와 VAD→ASR→LLM→TTS로 이어지는 음성 백엔드를 한 저장소에 묶은 모노레포입니다. 서버는 .env에 LLM_API_KEY를 넣고 start.sh로 기동하며 웹 콘솔은 포트 5050, 장치용 WebSocket은 ws://<host>:9000/asr_chat을 사용합니다. 펌웨어는 firmware/deskbot_config.h에서 네트워크·호스트·키를 설정한 뒤 ./flash_rom.sh all로 플래시하면 장치와 연동할 수 있습니다. ESP32S3 보드와 LLM API 접근권이 있고 하드웨어·서비스 통합 개발이 목표라면 바로 활용할 수 있는 실전 레퍼런스 성격입니다.

핵심 포인트

• 이 레포는 하드웨어 펌웨어와 음성 백엔드를 한곳에 묶은 모노레포로 분류됩니다. Brufik 하드웨어/펌웨어와 opendesk-service 백엔드를 함께 보관하며 ESP32S3 기반 장치와 WebSocket 통신을 엮는 구성을 포함합니다. 장치 쪽 펌웨어와 서버 쪽 서비스가 같은 저장소에 있어 하드웨어·서비스 동시 개발과 통합 테스트에 바로 사용할 수 있습니다.
• 서버(service) 쪽은 VAD → ASR → LLM → TTS 순의 음성 파이프라인을 구현하며 WebSocket 엔드포인트 /asr_chat와 웹 콘솔을 제공합니다. 실행은 service 디렉터리에서 .env에 LLM_API_KEY를 설정한 뒤 start.sh로 시작하며 웹 콘솔은 포트 5050, 장치용 WS는 ws://<host>:9000/asr_chat 경로를 사용합니다. 이 구조는 장치에서 전송한 오디오를 실시간으로 전처리하고 텍스트로 변환한 뒤 LLM을 호출해 음성 응답을 합성하는 엔드투엔드 플로우를 바로 시험할 수 있게 설계되어 있습니다.
• 하드웨어(hardware) 쪽은 ESP32S3 펌웨어 소스와 기계 설계 자산, PCB 재구성 파일, 플래시 스크립트를 포함합니다. 펌웨어 설정은 firmware/deskbot_config.h에서 WiFi 정보, WS 호스트, API 키 등을 편집하고 ./flash_rom.sh all을 실행하면 됩니다. 플래시 스크립트와 설정 파일을 통해 개발자 장비에서 바로 펌웨어를 빌드·배포할 수 있도록 준비되어 있습니다.
• 대상 사용자는 ESP32S3 하드웨어와 백엔드 통합이 필요한 하드웨어·임베디드 개발자 또는 음성 기반 데모를 빠르게 구성하려는 개발팀입니다. 사전조건으로는 ESP32S3 보드, LLM API 키, 기본적인 펌웨어 플래싱·서버 실행 지식이 필요하며 세부 사용법은 service/README.md와 hardware/README.md를 참고해야 합니다. 저장소의 현재 관심도는 54 stars와 17 forks로 나타나며 소규모 커뮤니티 검증 상태임을 판단하는 참고 지표가 됩니다.