rytilahti/python-miio

これは何？

主な機能

• 01IPアドレスとトークンを使い、ローカルネットワーク経由でmiIOおよびMIoT機器を操作できます。
• 02汎用MIoT連携により、機器のspecファイルから状態、設定項目、アクションを確認できます。
• 03Xiaomiのロボット掃除機、空気清浄機、扇風機、加湿器、ランプ、プラグなど、多くの機器に専用モジュールを用意しています。
• 04miiocliコマンドで、機器情報や状態の確認、設定変更、アクションの実行ができます。
• 05cloudコマンドを使い、Xiaomiのクラウドアカウントから機器のトークンを取得できます。
• 06ハードウェアなしでテストできるmiIOおよびMIoTシミュレーターを同梱しています。

ユースケース

• PythonプログラムからXiaomi機器をスクリプト化または自動化する。
• Xiaomi家電向けのカスタムスマートホーム連携やダッシュボードを構築する。
• 実機を持たずにmiIOまたはMIoTクライアントをテストする。
• ターミナルから機器の状態を確認し、設定を変更する。

クイックスタート

1. 1

   PyPIからライブラリをインストールします

   pip install python-miio
2. 2

   デバイスのIPアドレスとトークンを取得します（例：cloudコマンドを使用）

   miiocli cloud
3. 3

   デバイスに問い合わせて、モデルと制御コマンドを確認します

   miiocli device --ip <ip> --token <token> info

使う前に知っておきたいこと

• !最新のMIoTデバイスをサポートするには、バージョン0.6.0のリリースまではgit版またはプレリリース版が必要です。
• !デバイスを制御するには、各デバイスのIPアドレスとトークンが必要です。
• !これは有志によるコミュニティプロジェクトであり、デバイスメーカーとは提携していません。
• !コピーレフトライセンスであるGPL-3.0の下でライセンスされています。

トピック

よくある質問

python-miio とは？

miIO／MIoTプロトコルでXiaomiのスマートホーム機器を操作するPythonライブラリとmiiocliコマンドラインツール。 python-miioは、Xiaomiのスマートホーム機器を操作するためのPythonライブラリと、付属のコマンドラインツールmiiocliです。XiaomiのmiIOおよびMIoTプロトコルに対応しているため、IPアドレスとトークンが分かれば、ローカルネットワーク経由で機器の情報を取得したり操作したりできます。

python-miio は無料で使えますか？ライセンスは？

python-miio は GPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

python-miio は今もメンテナンスされていますか？

半年以内に更新あり。python-miio の最終コミットは 2026年7月25日 です。

python-miio は何に使えますか？

PythonプログラムからXiaomi機器をスクリプト化または自動化する。 Xiaomi家電向けのカスタムスマートホーム連携やダッシュボードを構築する。 実機を持たずにmiIOまたはMIoTクライアントをテストする。 ターミナルから機器の状態を確認し、設定を変更する。

python-miio のインストール方法は？

PyPIからライブラリをインストールします: pip install python-miio デバイスのIPアドレスとトークンを取得します（例：cloudコマンドを使用）: miiocli cloud デバイスに問い合わせて、モデルと制御コマンドを確認します: miiocli device --ip <ip> --token <token> info

python-miio はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/rytilahti/python-miio