bpyバージョンとPythonバージョンの対応に気を付けましょう。
はじめに
Blender Pythonモジュールのbpyをローカル環境にpip installしようとしたところ、上手くインストールできませんでした。
$ pip install bpy ERROR: Could not find a version that satisfies the requirement bpy (from versions: none) ERROR: No matching distribution found for bpy
このときの環境：
# Python version $ python --version Python 3.9.16
インストールできなかった原因を踏まえ、bpyをpip installする方法を整理します。
The English translation of this post is here.
bpyをpip installする
次の手順で見ていきます。
- Pythonバージョンを確認する
- bpyをpip installする
1. Pythonバージョンを確認する
まず注意しなければならないのは、bpyはバージョン毎に対応しているPythonバージョンがかなり狭い、ということです。
各bpyバージョンと、それがインストール可能なPythonバージョンをbpyのPyPIページからまとめます。
| bpyバージョン | インストール可能なPythonバージョン |
|---|---|
| 4.1.0 ~ 4.3.0 | Python ==3.11.* |
| 3.4.0 ~ 4.0.0 | Python ==3.10.* |
| 2.28 ~ bpy 2.91a0 | Python >=3.7, <3.8 |
自分のPythonバージョンに合ったbpyをバージョン指定でインストールするか、Pythonを対応しているバージョンに変えてbpyをインストールする必要があります。
2. bpyをpip installする
自分の環境がPython 3.11系の場合、最新bpy(執筆時点:2025/03 でver. 4.3.0)のインストールがそのまま可能です。
# Python 3.11系で最新bpyをインストール
pip install bpy
Python 3.10系の場合は、3.4.0 ~ 4.0.0の範囲のどれかのbpyバージョンを指定してpip installできます。
# Python 3.10系でbpy4.0.0をインストール pip install bpy==4.0.0
Python 3.9系と3.8系の場合、どのbpyバージョンも対応していません。
大人しくサポートされているPythonバージョンに切り替えましょう。
Python 3.7系なら、bpy 2.82, 2.82.1, 2.91a0(プレリリース)バージョンがインストールできます。
pip install bpy==2.82.1
おわりに
bpyをpip installする方法をまとめました。
bpyバージョンごとに対応しているPythonバージョンが決まっている、というのが落とし穴でした。
以上、どなたかの参考になれば幸いです。
[関連記事]
