홈어시스턴트 LLM 사용을 위한 시작 가이드 (ESP32-S3-BOX)

 

 

준비물 체크리스트

• ESP32-S3-BOX 계열 장치 1대 (USB-C 전원/케이블 포함)
• Home Assistant가 동작하는 서버 (최신 버전 권장)
• Nabu Casa(클라우드) 계정
• OpenAI 또는 Google Generative AI API 키
• 데스크톱(펌웨어 플래시용; Chromium 계열 권장)

전체 흐름

1. ESP32-S3-BOX에 음성 펌웨어 설치
2. Home Assistant에서 Voice Assistants(Assist) 추가
3. Nabu Casa(Cloud) 활성화 → STT/TTS 설정
4. OpenAI 또는 Google LLM 통합 추가
5. ESP32-S3-BOX와 Home Assistant 연결
6. 음성 → LLM → 음성 스트리밍 테스트

단계별 가이드

1단계 — 장비 준비

ESP32-S3-BOX / BOX-3 / BOX-Lite 모델 중 하나를 구입하세요. USB-C 케이블과 전원 어댑터도 필요합니다.

2단계 — ESP32-S3-BOX에 펌웨어 설치

데스크톱 브라우저(크롬 권장)에서 공식 문서의 설치 페이지를 열고 Web-Flasher로 펌웨어를 플래싱합니다. 설치 후 장치를 Wi-Fi에 연결하고 Home Assistant와 페어링합니다.

3단계 — Assist(Voice Assistant) 추가

1. Home Assistant UI → 설정 → Voice Assistants 이동
2. Add assistant 클릭 후 이름, 언어, Conversation agent, STT, TTS 설정
3. STT/TTS는 Cloud(구독 필요)를 권장

4단계 — Nabu Casa(Cloud) 활성화

Home Assistant UI에서 Cloud 메뉴를 열고 구독을 활성화한 뒤, Speech-to-text와 Text-to-speech를 켜주세요.

5단계 — LLM 통합(OpenAI/Google) 추가

1. 설정 → Devices & Services → Add Integration
2. “OpenAI” 또는 “Google Generative AI” 선택
3. API 키 입력 → Conversation agent에 연결

6단계 — ESP32-S3-BOX 연결

장치가 Home Assistant에 자동 등록됩니다. Assist Satellite 장치로 표시되는지 확인하세요.

7단계 — 테스트

ESP32-S3-BOX 버튼을 누르고 “오늘 날씨 알려줘”와 같이 말하면 LLM이 응답을 생성하고, TTS가 단어 단위로 스트리밍 재생합니다.

테스트 예시 문장

• “거실 불 켜 줘”
• “내일 오전 7시에 알람 설정해줘”
• “최근 내가 켠 조명 목록 보여줘”

자주 발생하는 문제

• 장치 미인식: USB 케이블/포트 교체 후 재시도
• STT/TTS 미작동: Cloud 구독 상태 및 Assist 설정 확인
• 응답 지연: 네트워크 상태 확인, 더 빠른 LLM 모델 선택
• 잘못된 자동화: LLM은 오답 가능 → 중요한 제어는 검증 필수

 

요약
가장 적은 노력으로 음성 → LLM → 음성 스트리밍을 체감하려면 아래 조합이 실용적입니다.

• 장비: ESP32-S3-BOX (또는 BOX-3 / BOX-Lite) × 1대
• 서비스: Home Assistant Cloud (Nabu Casa) — STT/TTS/스트리밍 지원
• LLM 연동: OpenAI / Google Generative AI / OpenRouter 등
• 결과: 버튼(또는 웨이크워드)으로 말하면 LLM이 처리하고, TTS가 단어 단위 스트리밍으로 바로 말해줌

 

마무리

ESP32-S3-BOX + Home Assistant Cloud + OpenAI/Google 통합 조합은 설정이 간단하고 품질이 뛰어나, 초보자가 LLM 음성 인터페이스를 경험하기에 가장 적합한 방법입니다.

 

 

 

출처: 공식 문서 링크