nodebpy

Build node trees in Blender more elegantly with Python code. Geometry Nodes, Shader Nodes and Compositor nodes are all fully supported, with type hints and IDE auto-completion throughout.

pip install nodebpy

A text-based version of nodes should bring the convenience of writing code with IDE auto-completion, type hinting, with overall compactness and readability, while staying as close as possible to what building a node tree via the GUI feels like.

from nodebpy import geometry as g

with g.tree("AnotherTree", collapse=True) as tree:
    rotation = (
        g.RandomValue.vector(min=-1, seed=2)
        >> g.AlignRotationToVector()
        >> g.RotateRotation(rotate_by=g.AxisAngleToRotation(angle=0.3))
    )

    _ = (
        tree.inputs.integer("Count", 10)
        >> g.Points(position=g.RandomValue.vector(min=-1))
        >> g.InstanceOnPoints(instance=g.Cube(), rotation=rotation)
        >> g.SetPosition(
            position=g.Position() * 2.0 + (0, 0.2, 0.3),
            offset=(0, 0, 0.1),
        )
        >> g.RealizeInstances()
        >> g.InstanceOnPoints(g.Cube(), instance=...)
        >> tree.outputs.geometry("Instances")
    )

Every node is a typed class named after the node it creates — 'Random Value' becomes g.RandomValue() — and node subtypes are class methods: g.RandomValue.vector().
Trees are built inside a with g.tree(...): context; instantiating a node class adds it to the current tree, and the tree's interface is declared with tree.inputs.* / tree.outputs.*.
Nodes are linked with the >> operator, which picks the most compatible socket pair automatically (much like Node Wrangler's Alt + Right Click drag) — or address sockets explicitly through the .i.* / .o.* accessors.
Python's arithmetic, comparison and boolean operators create the matching Math / VectorMath / Compare / BooleanMath nodes: g.Value(1.0) * 2 + (0, 0, 1).
Existing node trees — including ones wired up by hand in the GUI — can be exported back to nodebpy source with to_python().

Documentation

Guides and the full node reference live at bradyajohnston.github.io/nodebpy:

Writing node trees — adding, linking and organising nodes
Math operators — arithmetic, comparison and boolean expressions as nodes
Node API design — sockets, accessors, enum options and class methods
Custom node groups and asset node groups — reusable groups as Python classes
Nodes to code — turn existing trees back into nodebpy code
Using nodebpy in your add-on — installation, bundling and the Blender-tracking versioning scheme
Comparisons — how the API relates to geometry-script, geonodes, NodeToPython and TreeClipper

Like databpy, this project started as an internal tool inside molecularnodes before being broken out into its own robustly typed and tested package.

Contributing

Development setup, running the tests and regenerating the node classes (most of src/nodebpy/nodes/ is auto-generated by the gen/ package) are covered in CONTRIBUTING.md.

Metadata

Release files for nodebpy 520.15.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nodebpy 520.15.0
File	Size	Uploaded
nodebpy-520.15.0.tar.gz	332.1 kB	Aug 27, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for nodebpy 520.15.0
File	Interpreter	ABI	Platform	Reset
nodebpy-520.15.0-py3-none-any.whl 372.5 kB Aug 27, 2026	Python 3	none	any	Details

Total release size: 704.6 kB

Release files / nodebpy-520.15.0.tar.gz

Download URL	nodebpy-520.15.0.tar.gz
Size	332.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`a3567ed53f465ba07adb5d7b975300cac3d0a9e2828bfd51e838978d5fbb3b94`
BLAKE2b-256 checksum How to use checksums	`c199da4a8202e4146e74925814310866eb77e519d18448691206465b6d197050`
Upload date	Aug 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/BradyAJohnston/nodebpy
Publishing commit: github.com/BradyAJohnston/nodebpy/tree/9cb2fd4bac8c1e6ac6e0e29307a55559a8fb80d7

Workflow

Publishing configuration: github.com/BradyAJohnston/nodebpy/blob/9cb2fd4bac8c1e6ac6e0e29307a55559a8fb80d7/.github/workflows/pypi.yml
Publishing logs: github.com/BradyAJohnston/nodebpy/actions/runs/33096211727/attempts/1

Artifact

Subject: nodebpy-520.15.0.tar.gz
SHA-256 checksum: a3567ed53f465ba07adb5d7b975300cac3d0a9e2828bfd51e838978d5fbb3b94 Verifying attestations

Release files / nodebpy-520.15.0-py3-none-any.whl

Download URL	nodebpy-520.15.0-py3-none-any.whl
Size	372.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4bc6a0d22c66d49dc9880b002cb5226b3a17a1ecd02fe670a2433b4a8a4d4f95`
BLAKE2b-256 checksum How to use checksums	`aebcb5afd34662143602723b9f1be3a5f5009a11029f05ffa8b107cb50134125`
Upload date	Aug 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/BradyAJohnston/nodebpy
Publishing commit: github.com/BradyAJohnston/nodebpy/tree/9cb2fd4bac8c1e6ac6e0e29307a55559a8fb80d7

Workflow

Publishing configuration: github.com/BradyAJohnston/nodebpy/blob/9cb2fd4bac8c1e6ac6e0e29307a55559a8fb80d7/.github/workflows/pypi.yml
Publishing logs: github.com/BradyAJohnston/nodebpy/actions/runs/33096211727/attempts/1

Artifact

Subject: nodebpy-520.15.0-py3-none-any.whl
SHA-256 checksum: 4bc6a0d22c66d49dc9880b002cb5226b3a17a1ecd02fe670a2433b4a8a4d4f95 Verifying attestations