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