Skip to main content

Find Blender sources in version control, create build scripts

Project description


Python build script for Blender as a python module

It needs to be its own repository to satisfy the install_requires of blenderpy


While it is possible to install this module standalone, you will probably get better results installing blenderpy via pip install bpy rather than installing pip install bpy-build, as pip install bpy will attempt to take care of making sure the bpy installation is good.

Option 1 - Get prebuilt bdist_wheel from pypi


  1. A supported python installation with pip installed


py -m pip install bpy-build

Option 2 - Build from sources using pypi


  1. Windows users must have Visual Studio 2013 or later and C++ build tools installed to build from sources
  2. ALL users must have an SVN command-line provider to build from sources (see (this is a requirement as it is how we determine the correct release tag to grab, if any)
  3. All users must py -m pip install cmake in their python environment to build from sources (currently adding it as a setup_requires does not install it properly); after build it may be uninstalled with py -m pip uninstall cmake
  4. Users of Python versions below 3.6 must have future-fstrings installed pip install -U future-fstrings
  5. Users of Python versions 3.4 and below will probably need to update setuptools pip install -U setuptools
  6. Up-to-date wheel


py -m pip install bpy-build --no-binary

How it works

  1. Create overriding classes CMakeExtension & BuildCMake, which inheirit from the setuptools classes; bpy is a python extension (.pyd) and an instance of CMakeExtension, BuildCMake is the command that is run when installing the extension from pip (or running
  2. Using GitPython, clone Blender sources from
  3. If on Windows, detect the installed version of Visual Studio and 64bit vs 32bit, and download the appropriate svn library based on that
  4. Using cmake, configure blender as a python module; configure this build solution in the build_temp directory of the bpy package
  5. Using cmake, build the configured solution
  6. Place the built binaries in the built extension parent directory (important!)
  7. Relocate the / directory (i.e: /2.79) into the directory containing the executable from which this installation was spawned (where 'python.exe' is)
  8. Clean up using the remaining functionality from the superclasses build_ext and Extension
  9. bpy.pyd/ .so should now be installed into the site-packages

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bpy-build-1.1.0.tar.gz (8.0 kB view hashes)

Uploaded Source

Built Distribution

bpy_build-1.1.0-py3-none-any.whl (21.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page