bpy

library5.1.2pypypiunverified

The official Blender Python module (bpy) allows you to run Blender's 3D modeling, animation, rendering, and scripting capabilities directly from Python, bypassing the GUI. Version 5.1.1 is the latest release, supporting Python 3.13 only. Updates are tied to Blender releases (roughly every 3-4 months).

data

pip install bpy

package ↗homepage ↗

INSTALL

IMPORT

SIG · BPY

bpy

datapythonv5.1.2

Install

14.8s avg

Import

—

Disk

967MB

Pass rate

2/ 10

Env Coverage2 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v5.0.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

py 3.11

✕ build_error

✓ 14.2s

py 3.12

✕ build_error

py 3.13

✕ build_error

✓ 15.5s

py 3.9

✕ build_error

967MB installed

● package 967MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

bpy

✓ import bpy

✗ from bpy import *

Avoid wildcard imports; bpy is a large module and can cause namespace pollution.

Minimal example: imports bpy, clears scene, adds Suzanne the monkey, and prints the object name.

import bpy # Clear the default scene bpy.ops.object.select_all(action='SELECT') bpy.ops.object.delete(use_global=False) # Add a monkey primitive bpy.ops.mesh.primitive_monkey_add() # Access the active object obj = bpy.context.object print('Object:', obj.name) # Render an image (requires a camera and light, omitted for brevity) # bpy.ops.render.render(write_still=True)

Debug

Known issues

gotchabpy is only compatible with Python 3.13.x. Installing on other Python versions will fail or cause import errors.

fix

Use Python 3.13 exactly. Check with `python --version`.

affects: 5.x

breakingThe bpy pip package is not the same as the Blender-internal bpy. Breaking changes may occur between Blender releases.

fix

Always match the bpy version to your Blender version if using Blender's bundled Python. For standalone use, check release notes.

affects: all

gotchabpy cannot run headlessly on all platforms without a display server. On Linux, you may need `DISPLAY=:0` or use `bpy.app.background = True` (but this may not work without a virtual display).

fix

Use a virtual display like Xvfb: `xvfb-run python script.py` or set `DISPLAY=:99`.

affects: all

deprecatedOld API calls like `bpy.ops.object.add()` with deprecated parameters may cause errors in newer versions.

fix

Check Blender API docs for updated operators. Use `bpy.ops.mesh.primitive_monkey_add()` instead of legacy calls.

affects: >=5.0

Upgrade

Version history

5.1.2latest on PyPI · released May 19, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

19 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/bpy/ ↗

homepagehttps://www.blender.org ↗