blender-geometry-script

A scripting API for Blender's Geometry Nodes:

add-on blender bpy geometry-nodes python scripting

Go to file

Arrel 08c3cd5d67 Fix Repeat Grid example: improve parameter naming, add proper spacing calculation - Rename parameters from width/height to columns/rows for clarity - Implement proper bounding box calculation for geometry spacing - Fix grid vertex calculation (use N+1 vertices for N cells) - Add explanatory comments for grid sizing logic - Fix method chaining for mesh_to_points		2025-07-07 10:32:49 -04:00
.github/workflows	Fix actions	2022-12-09 16:03:40 -05:00
api	replace dictionary used to count node input links with collections.Counter	2023-11-17 13:49:19 -05:00
book	Add repeat zone support	2023-11-15 12:55:31 -05:00
docs	Keep docs and typeshed folders so files can be created	2022-12-02 19:23:10 -05:00
examples	Fix Repeat Grid example: improve parameter naming, add proper spacing calculation	2025-07-07 10:32:49 -04:00
typeshed	Keep docs and typeshed folders so files can be created	2022-12-02 19:23:10 -05:00
.gitignore	Keep docs and typeshed folders so files can be created	2022-12-02 19:23:10 -05:00
LICENSE	…
README.md	Update for Blender 3.5 release	2023-04-01 16:33:48 -04:00
__init__.py	Bump version to 0.1.2	2022-12-02 19:23:48 -05:00
absolute_path.py	…
external.py	…
preferences.py	fix a spelling mistake	2024-10-27 07:20:11 -04:00

README.md

A scripting API for Blender's Geometry Nodes:

from geometry_script import *

@tree("Repeat Grid")
def repeat_grid(geometry: Geometry, width: Int, height: Int):
    g = grid(
        size_x=width, size_y=height,
        vertices_x=width, vertices_y=height
    ).mesh.mesh_to_points()
    return g.instance_on_points(instance=geometry)

Installation

Download the source code
Open Blender > Preferences > Add-ons
Choose Install... and select the downloaded ZIP file

Or you can get it from the Blender Market.

What is Geometry Script?

Geometry Script is a robust yet easy to use Python API for creating Geometry Nodes with code.

At a certain point, Geometry Node trees become unmanagably large. Creating node trees in Python enables quicker editing and reorganization of large, complex trees.

Geometry Script has all of the performance and capabilities of Geometry Nodes, but in a more managable format. The scripts are converted directly to Geometry Node trees making them easy to tweak for others unfamiliar with scripting.

Documentation

Read the documentation for more information on installation, syntax, and tutorials.