Be mindful of the compatibility between bpy versions and Python versions.
Introduction
I attempted to install the Blender Python module bpy in my local environment using pip, but the installation failed.
$ pip install bpy ERROR: Could not find a version that satisfies the requirement bpy (from versions: none) ERROR: No matching distribution found for bpy
Environment at the time:
# Python version $ python --version Python 3.9.16
Considering the cause of the installation failure, this post summarized how to install bpy using pip.
Note: This article was translated from my original post.
Installing bpy via pip
We will go through the following steps:
- Check the Python version
- Install
bpyviapip
1. Check the Python version
The first thing to note is that each bpy version has a narrow range of compatible Python versions.
Below is a summary of the bpy versions and their corresponding installable Python versions, based on bpy's PyPI page.
| bpy Version | Python Version |
|---|---|
| 4.1.0 ~ 4.3.0 | Python ==3.11.* |
| 3.4.0 ~ 4.0.0 | Python ==3.10.* |
| 2.28 ~ 2.91a0 | Python >=3.7, <3.8 |
You need to either specify the correct bpy version that matches your Python version or switch to a compatible Python version before installing bpy.
2. Install bpy via pip
If your environment is running Python 3.11, you can install the latest bpy version (as of March 2025, bpy 4.3.0).
# Install the latest `bpy` for Python 3.11
pip install bpy
For Python 3.10, you can specify a bpy version in the range of 3.4.0 ~ 4.0.0.
# Install `bpy` 4.0.0 for Python 3.10 pip install bpy==4.0.0
For Python 3.9 and 3.8, no bpy versions are compatible.
Switching to a supported Python version is recommended.
For Python 3.7, you can install bpy versions 2.82, 2.82.1, or 2.91a0 (pre-release).
pip install bpy==2.82.1
Conclusion
This article summarizes how to install bpy using pip.
The main pitfall is that each bpy version is strictly tied to specific Python versions.
I hope this post helps someone!
[Related Articles]
