xinnan-tech/xiaozhi-esp32-server

어떤 프로젝트인가요?

핵심 기능

• 01ESP32 기기를 위한 MQTT+UDP 게이트웨이와 WebSocket 연결을 지원합니다.
• 02다양한 클라우드 및 로컬 제공자를 통해 스트리밍 ASR, TTS, 음성 활동 감지를 지원합니다.
• 03화자 등록과 화자 식별을 지원하며, 식별 결과를 LLM에 전달합니다.
• 04IoT, MCP 클라이언트/서버, 사용자 지정 함수 프로토콜을 통한 도구 호출을 지원합니다.
• 05Docker 또는 소스 코드 배포를 지원하며, 사용자, 기기, 에이전트 관리용 웹 콘솔을 제공합니다.

활용 사례

• 직접 구축한 xiaozhi-esp32 음성 비서용 비공개 백엔드 운영.
• ESP32 기기를 OpenAI 호환 API 또는 중국 내 LLM API에 연결.
• 서버에서 가전제품을 제어하거나 기기로 MCP 명령 전송.
• 사양이 낮은 하드웨어에서 지식 베이스 검색 기능을 갖춘 음성 에이전트 프로토타이핑.

빠른 시작

1. 1

   README 표에서 배포 모드(minimal 또는 full module)를 선택합니다

2. 2

   선택한 모드에 맞는 Docker 또는 소스 배포 가이드를 따릅니다

사용 전 알아둘 점

• !README에 따르면 프로젝트가 아직 완성되지 않았고 보안 테스트도 통과하지 않았으므로 프로덕션 환경에서 사용해서는 안 됩니다.
• !ESP32 하드웨어 기기에서 작동하도록 설계되어 있으며, 호환되는 하드웨어를 보유한 경우에만 유용합니다.
• !음성, LLM, TTS를 위해 타사 API 서비스를 사용하며, 일부 서비스는 유료 키가 필요합니다.
• !FunASR 같은 로컬 모델을 실행하려면 2코어와 RAM 4GB가 필요하며, full module 설정에는 4코어와 RAM 8GB가 필요합니다.

토픽

자주 묻는 질문

xiaozhi-esp32-server은(는) 무엇인가요?

xiaozhi-esp32 ESP32 음성 기기를 위한 Python/Java/Vue 백엔드 서버로, MQTT+UDP, WebSocket, MCP, 화자 인식, 지식 베이스를 지원합니다. xiaozhi-esp32-server는 xiaozhi-esp32 오픈소스 스마트 하드웨어 프로젝트를 위한 자체 호스팅 백엔드입니다. Python, Java, Vue로 xiaozhi 통신 프로토콜을 구현해 ESP32 음성 기기를 호스팅 서비스 대신 직접 운영하는 서버에 연결할 수 있습니다.

xiaozhi-esp32-server은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

xiaozhi-esp32-server은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

xiaozhi-esp32-server은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. xiaozhi-esp32-server의 마지막 커밋은 2026년 10월 20일입니다.

xiaozhi-esp32-server은(는) 어디에 사용할 수 있나요?

직접 구축한 xiaozhi-esp32 음성 비서용 비공개 백엔드 운영. ESP32 기기를 OpenAI 호환 API 또는 중국 내 LLM API에 연결. 서버에서 가전제품을 제어하거나 기기로 MCP 명령 전송. 사양이 낮은 하드웨어에서 지식 베이스 검색 기능을 갖춘 음성 에이전트 프로토타이핑.

xiaozhi-esp32-server는 어떻게 설치하나요?

README 표에서 배포 모드(minimal 또는 full module)를 선택합니다 선택한 모드에 맞는 Docker 또는 소스 배포 가이드를 따릅니다

xiaozhi-esp32-server은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/xinnan-tech/xiaozhi-esp32-server