yihong0618/xiaogpt

어떤 프로젝트인가요?

핵심 기능

• 01Xiaomi AI Speaker의 음성 질문을 ChatGPT나 다른 LLM으로 전달합니다.
• 02모델의 답변을 스피커의 TTS 또는 서드파티 TTS 엔진으로 재생합니다.
• 03스트리밍 응답과 연속 대화 모드를 지원합니다.
• 04CLI 플래그나 YAML/JSON 설정 파일로 구성할 수 있습니다.
• 05배포용 Docker 이미지를 제공합니다.

활용 사례

• 집에서 사용하는 Xiaomi 스피커에 대화형 AI 어시스턴트를 추가합니다.
• 음성 인터페이스를 통해 다양한 LLM 백엔드를 시험해 봅니다.
• 선호하는 TTS 제공업체를 사용해 스피커의 음성 출력을 설정합니다.

빠른 시작

1. 1

   PyPI에서 xiaogpt를 설치합니다

   pip install -U --force-reinstall xiaogpt[locked]
2. 2

   MiService로 스피커의 DID를 확인합니다(MI_USER와 MI_PASS를 먼저 설정하세요)

   miservice list
3. 3

   OpenAI API 키를 설정합니다

   export OPENAI_API_KEY=${your_api_key}
4. 4

   스피커 모델과 ChatGPT API를 지정해 xiaogpt를 실행합니다

   xiaogpt --hardware LX06 --use_chatgpt_api

사용 전 알아둘 점

• !Xiaomi AI Speaker와 Xiaomi 계정이 필요합니다.
• !ChatGPT 또는 다른 모델을 사용하려면 일반적으로 유료인 LLM API 키가 필요합니다.
• !Python 3.12~3.14가 필요합니다.

토픽

자주 묻는 질문

xiaogpt은(는) 무엇인가요?

Xiaomi AI Speaker를 ChatGPT 및 다른 LLM의 음성 인터페이스로 바꿔, 호출어 뒤에 말한 질문을 모델로 보내고 답변을 음성으로 들려줍니다. xiaogpt는 Xiaomi AI Speaker를 대규모 언어 모델에 연결하는 Python 도구입니다. 스피커에 "帮我" 같은 호출어를 말한 뒤 질문하면 설정된 모델로 전송되고, 답변은 스피커의 텍스트 음성 변환 기능으로 재생됩니다.

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

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

xiaogpt은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. xiaogpt의 마지막 커밋은 2026년 10월 7일입니다.

xiaogpt은(는) 어디에 사용할 수 있나요?

집에서 사용하는 Xiaomi 스피커에 대화형 AI 어시스턴트를 추가합니다. 음성 인터페이스를 통해 다양한 LLM 백엔드를 시험해 봅니다. 선호하는 TTS 제공업체를 사용해 스피커의 음성 출력을 설정합니다.

xiaogpt는 어떻게 설치하나요?

PyPI에서 xiaogpt를 설치합니다: pip install -U --force-reinstall xiaogpt[locked] MiService로 스피커의 DID를 확인합니다(MI_USER와 MI_PASS를 먼저 설정하세요): miservice list OpenAI API 키를 설정합니다: export OPENAI_API_KEY=${your_api_key} 스피커 모델과 ChatGPT API를 지정해 xiaogpt를 실행합니다: xiaogpt --hardware LX06 --use_chatgpt_api

xiaogpt은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/yihong0618/xiaogpt