Welcome to the Python API documentation for Blender, the free and open source 3D creation suite. This site can be used offline: Download the full documentation (zipped HTML files)

You can access Blender’s data with the Python API in the same way as the animation system or user interface; this implies that any setting that can be changed via a button can also be changed with …

The purpose of this document is to explain how Python and Blender fit together, covering some of the functionality that may not be obvious from reading the API references and example scripts.

Python scripts are a versatile way to extend Blender functionality. Most areas of Blender can be scripted, including animation, rendering, import and export, object creation and automating repetitive tasks.

Blender has many interlinking data types which have an auto-generated reference API which often has the information you need to write a script, but can be difficult to use.

You can use external editors or IDEs with Blender’s Python API and execute scripts within the IDE (step over code, inspect variables as the script runs). Editors or IDEs can auto-complete Blender modules …

This document is to give an understanding of how Python and Blender fit together, covering some of the functionality that isn’t obvious from reading the API reference and example scripts.

Blender as a Python Module ¶ Blender supports being built as a Python module, allowing import bpy to be added to any Python script, providing access to Blender’s features.

3 days ago · The Python Console offers a quick way to test code snippets and explore Blender’s API. It executes whatever you type on its >>> prompt and has command history and auto-complete.

For Blender Python development we have chosen to follow Python suggested style guide to avoid mixing styles among our own scripts and make it easier to use Python scripts from other projects.