Blender as a python module
Blender as a python module with easy-install
Meant for installation into a virtualenv or wherever, for unit testing of Blender extensions being authored, or developement of a Blender 3d-enabled Python application.
Depends upon the
bpy-build module to make sure the Blender
bpy module environment is correct.
For more information, please see:
Prebuilt wheels are provided for popular Platforms (MacOS, Windows, and Ubuntu). Prebuilds include "normal" installation (
bpy), CUDA (
bpy-cuda) and Optix (
bpy-optix). Choosing the correct version depends on your use-case and hardware but in general
bpy should be just fine for non-rendering automation tasks while
bpy-optix has the best performance but requires a NVIDIA RTX Card and up to date drivers.
Installing a prebuilt on these platforms is simple.
pip install bpy && bpy_post_install
Building the Blender API for your own platform can be difficult, however this repo should make it easy enough for you to create your own builds by hand.
You can build from a source distribution using
Performing a build from
sdist requires at least the prerequisites for building Blender. See the wiki for the list of prerequisite applications.
py -3.7-64 -m pip install --upgrade pip wheel future-fstrings
python3.7 -m pip install --upgrade pip wheel future-fstrings
py -3.7-64 -m pip install bpy --no-binary :all:
python3.7 -m pip install bpy --no-binary :all:
Build from repo
You can also build after cloning the repository, this is helpful during development.
python3 -m pip install --upgrade pip wheel future-fstrings git clone https://github.com/TylerGubala/blenderpy.git
If you have a specific version of
bpy you want, you have to change the
VERSION string at the beginning of the
bpy_<optional extra>_setup.py file.
To build, run the below command.
py bpy_setup.py sdist bdist_wheel
python3 bpy_setup.py sdist bdist_wheel
The resultant wheel in the dist folder can be installed using pip.
Post any errors you have as an issue.
Q. I am getting
failed to find 'bpy_types' module
A. Please see issue #13
Q. I am getting
ImportError: DLL load failed: The specified module could not be found
A. Please see issue #15
Q. How do I import addons?
A. Addons (Blender internal and third party) can be imported using the code referenced here.
Q. How can I use Blender in
A. Blender runtime usage and compatibility with
multiprocessing is limited, see the documentation.
Q. What about my operating system of choice?
A. MacOS support is on its way. After that is Ubuntu.
Q. What about my Python version of choice?
A. Some builds you will have to make yourself if you have a specific version of the API you want. Likewise, if you are contrained to a specific Python version (especially those that aren't shipped by python.org) then you may have to try and build yourself.
Q. What about my bitness of choice?
A. 32-bit support officially ended with
2.80. See the announcement
I have not tested this for platforms other than Windows Python 3.6.x at the moment. More to come soon.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size bpy-2.82.1-cp37-cp37m-win_amd64.whl (105.7 MB)||File type Wheel||Python version cp37||Upload date||Hashes View|
|Filename, size bpy-2.82.1.tar.gz (19.9 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for bpy-2.82.1-cp37-cp37m-win_amd64.whl