Skip to main content

Create synthetic data with Blender.

Project description

zpy: Synthetic data in Blender.


Discord Twitter Youtube PyPI Docs

Synthetic raspberry pi


Collecting, labeling, and cleaning data for computer vision is a pain. Jump into the future and create your own data instead! Synthetic data is faster to develop with, effectively infinite, and gives you full control to prevent bias and privacy issues from creeping in. We created zpy to make synthetic data easy, by simplifying the scene creation process and providing an easy way to generate synthetic data at scale.


Install: Using Pip

You can install zpy with pip:

pip install zpy-zumo

Note that Blender has it's own python, seperate from your system/venv/conda python. You will have to install it into both.

Install: Blender Addon

Once you have installed the zpy module into Blender's python, download the latest zip (you want the one called zpy_addon-v*.zip). Then open up Blender. Navigate to Edit -> Preferences -> Add-ons. You should be able to install and enable the addon from there.

Enabling the addon

Install: Linux: Using Install Script

$ /bin/bash -c "$(curl -fsSL"

Set these environment variables for specific versions:

export BLENDER_VERSION="2.92"
export BLENDER_VERSION_FULL="2.92.0"
export ZPY_VERSION="v1.0.0"


More documentation can be found here





We provide a simple CLI, you can find documentation here.


We welcome community contributions! Search through the current issues or open your own.


This release of zpy is under the GPLv3 license, a free copyleft license used by Blender. TLDR: Its free, use it!


If you use zpy in your research, we would appreciate the citation!

  title={zpy: Synthetic data for Blender.},
  author={Ponte, H. and Ponte, N. and Karatas, K},
  journal={GitHub. Note:},

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

zpy-zumo-0.9.14.tar.gz (105.9 kB view hashes)

Uploaded Source

Built Distribution

zpy_zumo-0.9.14-py3-none-any.whl (119.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