A compiled binary of Blender-as-a-Python-Module (bpy) for use in AWS Lambda with cycles

pip install bpy_nibbler==0.1



🎥 A compiled binary of Blender-as-a-Python-Module (bpy) for use in AWS Lambda

PyPI version


pip install bpy_lambda

Works great with Zappa!


bpy_lambda is a simple wrapper around the bpy. You can read more about bpy usage in the Blender Documentation.

from bpy_lambda import bpy

# bpy can be used normally!
bpy.ops.mesh.primitive_cube_add(location=(0, 0, 0))
cube = bpy.context.scene.objects.active
cube.scale = (1, 2, 3)

bpy_lambda will only work in a Lambda environment (perhaps some linux distros as well, if you have a similar set of library versions to AWS Lambda).

For local development, it will be useful to install bpy normally with the instructions on the Blender website. (Unfortunately, this requires building from source).

With a local version of bpy installed, you can use this code to switch seamlessly between your local environment and Lambda:

    import bpy
except ImportError:
    from bpy_lambda import bpy

A Note about Cycles

The Cycles rendering engine is not included in this version of bpy because of the dependencies it needs to bring in. It's possible that support will be added in bpy_lambda for Cycles in the future if there is interest, but for now you will see an exception when you import bpy noting that Cycles is not found.

Contribution / Building from Source

The Dockerfile is the easiest way to create a version of bpy that works on Lambda. Building this docker image will download the necessary libraries and compile a minimal version of Blender that works in a Lambda environment.

This dockerfile will produce a build artifact in /bpy_lambda. Copy all the files in this folder, add the __init__.py from the bpy_lambda Github repo into this directory, and you have a full version of bpy_lambda.