joey-zhou/xiaozhi-esp32-server-java

어떤 프로젝트인가요?

핵심 기능

• 01MySQL과 Redis를 공유하면서 독립적으로 확장할 수 있는 관리 및 대화 프로세스 분리
• 02음성 복제와 스트리밍 상호작용을 포함한 로컬 및 클라우드 음성 인식·합성
• 03OpenAI, Zhipu, Ollama, Dify, Coze 등 LLM 제공업체 연동
• 04스마트홈 제어를 위한 MCP 도구 프로토콜 지원 및 function calling
• 05PDF, Office 문서와 이미지용 RAG 지식 베이스
• 06여러 가족 구성원을 위한 장기 기억 및 화자 인식

활용 사례

• 가정이나 사무실의 ESP32 기기에서 자체 호스팅 음성 어시스턴트 백엔드 운영
• OTA 업그레이드와 모니터링을 통해 Xiaozhi 호환 기기 여러 대 관리
• MCP 또는 function call로 스마트홈 기기를 제어하는 음성 어시스턴트 구축
• 음성 인식·합성 및 LLM 제공업체를 바꿔 가며 ESP32 하드웨어에서 AI 음성 제품 프로토타이핑

빠른 시작

1. 1

   폴더를 만들고 해당 폴더로 이동합니다

   mkdir xiaozhi && cd xiaozhi
2. 2

   docker-compose.yml 파일을 다운로드합니다

   curl -O https://raw.githubusercontent.com/joey-zhou/xiaozhi-esp32-server-java/main/docker-compose.yml
3. 3

   컨테이너를 시작합니다

   docker compose up -d
4. 4

   컨테이너 상태가 정상으로 표시되면 http://localhost:8084를 열고 admin / 123456으로 로그인한 다음 LLM API 키를 설정합니다

사용 전 알아둘 점

• !시스템에서 대화하려면 직접 LLM API 키를 준비해야 합니다. 키는 제공되지 않습니다.
• !일부 기능은 오픈 소스가 아니며 상용 버전에서만 사용할 수 있습니다.

토픽

자주 묻는 질문

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

Xiaozhi ESP32 음성 기기를 위한 Java 서버 및 관리 플랫폼으로, 기기 모니터링과 음성·페르소나 관리, 대화 로그 기능을 제공합니다. Xiaozhi ESP32 Server Java는 Xiaozhi ESP32 펌웨어와 호환되는 ESP32 기반 음성 하드웨어용 Java 백엔드입니다. 사용자, 기기, 역할, OTA 업그레이드를 관리하는 웹 관리자 콘솔과 WebSocket 및 MQTT 오디오 스트림, AI 대화 파이프라인을 처리하는 별도의 대화 서비스를 제공합니다.

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

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

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

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

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

가정이나 사무실의 ESP32 기기에서 자체 호스팅 음성 어시스턴트 백엔드 운영 OTA 업그레이드와 모니터링을 통해 Xiaozhi 호환 기기 여러 대 관리 MCP 또는 function call로 스마트홈 기기를 제어하는 음성 어시스턴트 구축 음성 인식·합성 및 LLM 제공업체를 바꿔 가며 ESP32 하드웨어에서 AI 음성 제품 프로토타이핑

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

폴더를 만들고 해당 폴더로 이동합니다: mkdir xiaozhi && cd xiaozhi docker-compose.yml 파일을 다운로드합니다: curl -O https://raw.githubusercontent.com/joey-zhou/xiaozhi-esp32-server-java/main/docker-compose.yml 컨테이너를 시작합니다: docker compose up -d 컨테이너 상태가 정상으로 표시되면 http://localhost:8084를 열고 admin / 123456으로 로그인한 다음 LLM API 키를 설정합니다

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

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