Skip to main content

nodebpy

CodSpeed

nodebpy Blender 5.2 Blender 5.3
530 (main) Blender 5.2 Blender 5.3
520 (5.2) Blender 5.2 Blender 5.3

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, is_modifier=True) as tree:
    rot = (
        g.RandomValue.vector(min=-1, seed=2)
        >> g.AlignRotationToVector()
        >> g.RotateRotation(rotate_by=g.AxisAngleToRotation(angle=0.3))
    )
    pos = g.Position() * 2.0 + (0, 0.2, 0.3)

    (
        tree.inputs.integer("Count", 10)
        >> g.Points(position=g.RandomValue.vector(min=-1))
        >> g.InstanceOnPoints(instance=g.Cube(), rotation=rot)
        >> g.SetPosition(position=pos, 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().

Agent skill

nodebpy ships an Agent Skill that teaches AI coding agents to write, check and port node trees with it. Install it into any skills-aware agent (Claude Code, Codex, Cursor, Copilot, OpenCode and others) from the repository:

npx skills add BradyAJohnston/nodebpy

Claude Code can also take it as a plugin (/plugin marketplace add BradyAJohnston/nodebpy, then /plugin install nodebpy@nodebpy), and the installed package carries the same skill, matched to its version: nodebpy skill install copies it into ~/.claude/skills and nodebpy skill path prints where it is. nodebpy lookup search|show|socket is the lookup the skill uses to find classes, sockets and options.

Documentation

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

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 530.0.3

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 530.0.3
File Size Uploaded Provenance Actions
nodebpy-530.0.3.tar.gz 594.4 kB With provenance Details for nodebpy-530.0.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nodebpy 530.0.3
File Interpreter ABI Platform Actions
nodebpy-530.0.3-py3-none-any.whl Python 3 none any Details for nodebpy-530.0.3-py3-none-any.whl

Total release size: 1.3 MB

Release files / nodebpy-530.0.3.tar.gz

Download URL nodebpy-530.0.3.tar.gz
Size 594.4 kB
Tags Source
SHA-256 checksum
How to use checksums
52d9330c7503a9e7161b4c05b53ec39b5a5ede3d7ca1936cc0021606e48c23f4
BLAKE2b-256 checksum
How to use checksums
b7b127572f5f3364f53eed3f4e1ce775978299f9923afec7acb2893d3acbe567
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

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

Download URL nodebpy-530.0.3-py3-none-any.whl
Size 656.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
58a80f8bbebea56e13a95fab2e0d400c5c9382d3ca2a5f4d6e022bf0f29b64fb
BLAKE2b-256 checksum
How to use checksums
2575e2ebb7fea321664a00d05b953fe9362bb0956ce2d26df9bbd056af280daf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Security for nodebpy 530.0.3

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for nodebpy-530.0.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

530.0.3 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page