ESP32 스마트 기기용 지능형 음성 대화 백엔드 서비스
중간맛 분석
JavaScript 기반의 풀스택 시스템으로, Python·Java·Vue를 조합하여 구현되었습니다. MQTT+UDP, WebSocket, HTTP 프로토콜을 지원하며, MCP 접입점, 성문 인식, 지식 기반 검색을 포함합니다. 최소 구성은 한 줄 명령어로 시작 가능하며, 풀 모듈 설치 시 다중 사용자·다중 에이전트 관리 대시보드까지 제공합니다. 응답 속도가 약 2.5초 빨라진 버전 0.5.2 이상 권장됩니다.
이런 레포예요
이럴 때 쓰면 좋아요
- IoT 스마트 스피커·로봇에 음성 대화 기능 탑재
- 지능형 가정 자동화 시스템에서 음성 명령 처리
- 의료·교육 현장에서 다중 사용자 음성 에이전트 구축
- 기존 ESP32 프로젝트에 자체 백엔드 서비스 연동
핵심 기능
대안 대비 차별점
기존 Bailing 기반으로 스트림식 처리로 응답 속도를 2.5초 단축했으며, 성문 인식·지식 기반·다중 에이전트 관리·표준 MCP 프로토콜 지원으로 엔터프라이즈급 확장성을 갖춘 오픈소스 스마트 기기 백엔드 플랫폼입니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- ESP32 하드웨어 기기
- Docker 또는 Python 3.8+
- Node.js 14+
- LLM API 키(OpenAI 호환 인터페이스)
- 선택사항: MQTT 브로커
- 선택사항: 로컬 ASR용 2코어 4GB RAM
바로 시작하기
1단계: 저장소를 복제합니다.
git clone https://github.com/xinnan-tech/xiaozhi-esp32-server.git
cd xiaozhi-esp32-server
2단계: Docker를 사용하여 최소 구성으로 실행합니다(권장).
docker run -d \
-p 8000:8000 \
-p 8001:8001 \
-p 8002:8002 \
-e MQTT_HOST=localhost \
-e LLM_API_KEY=your_api_key \
xinnan-tech/xiaozhi-esp32-server:latest
3단계: 또는 소스 코드로 설정합니다. 먼저 Python 및 Node.js 의존성을 설치합니다.
cd main/xiaozhi-server
pip install -r requirements.txt
cd ../../main/digital-human
npm install
4단계: 환경 변수 파일(.env)을 설정합니다. docs/Deployment.md 또는 docs/Deployment_all.md에 따라 LLM API 키, ASR, TTS 설정을 입력합니다.
5단계: 서버를 시작합니다.
cd main/xiaozhi-server
python server.py
6단계: ESP32 기기를 네트워크에 연결하고 대시보드(http://localhost:8000)에서 설정합니다.
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try xinnan-tech/xiaozhi-esp32-server
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2025년 생성
「백엔드·DB」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/xinnan-tech/xiaozhi-esp32-server)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기