Installing

The Docker image kubruntu features a fully functional installation of Kubric and all its dependencies. This approach for using Kubric is by far the easiest, and the one we recommend. Assuming a working Docker installation the image can be downloaded simply by:

docker pull kubricdockerhub/kubruntu

This completes the “installation”, and any Kubric worker file can now be run as:

docker run --rm --interactive \
    --user $(id -u):$(id -g) \
    --volume "$PWD:/kubric" \
    kubricdockerhub/kubruntu \
    python3 examples/helloworld.py

Note

The flag --user $(id -u):$(id -g) ensures commands executed within the container use the host user information in creating new files. The flag --volume "HOST_DIR:CONTAINER_DIR" mounts the current directory into the /kubric container directory; this is a convenient way to pass files (like worker.py) into the container and also get the output files back. The flags --interactive allocates a pseudo-tty including STDIN for interactivity and finally --rm deletes the container (but not the image) after completion (optional to avoid clutter).

Warning

Kubric scripts can also be run directly through the CLI of Blender, which makes use of the included Python version that Blender ships with (instead of the system Python). This may fail for some dependencies which have to be built (e.g. OpenEXR), even if the corresponding system-packages are installed because the Blender-internal pip fails to find the correct paths. Please refer to the instructions for macOS and Debian.

Warning

You can also install Kubric directly on your host system (virtualenv). To achieve this, you need to first manually install bpy and the other dependencies. Be warned though: this process can be VERY difficult and frustrating. Please refer to these instructions.