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 manylinux
). Prebuilds are complete builds with audio, CUDA, and Optix functionality (except for MacOS, which is missing those three), like you would expect with installing the complete application.
Both building the Python package from sources and installing the wheel
files require the bare minimum dependencies listed on the Blender 3D wiki for building Blender. Get these first before opening a new issue.
Installing from pypi
:
pip install bpy && bpy_post_install
Installing from wheel
file (see Releases page):
pip install <PATH_TO_WHEEL_FILE> && bpy_post_install
A unique uninstallation script is required to ensure that all traces of bpy
are removed from the hard drive, because Blender expects .dll
and .so
libraries to be in places that are not part of the Python packaging system.
bpy_pre_uninstall && pip uninstall bpy
See more about building bpy
on the wiki page.
A. Please see issue #13
A. Please see issue #15
A. Addons (Blender internal and third party) can be imported using the code referenced here.
A. Blender runtime usage and compatibility with multiprocessing
is limited, see the documentation.
A. Please file a new issue if you are having trouble installing on your operating system 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.
A. 32-bit support officially ended with 2.80
. See the announcement
Some unique hardware and software configurations may not work, and there is no extant list of things that don't work in the Python standalone module.