Skip to content
denikrytPublic

About

A Python-like language for building Blender Geometry Nodes with code.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

347 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NodeForge

NodeForge screenshot

Disclaimer: NodeForge is a vibe-coded project.

NodeForge is a Blender add-on for describing Geometry Nodes logic in a Python-like language. Executable statements create ordinary nodes directly in the current base Geometry Nodes tree. User-defined functions compile to reusable nested Geometry Nodes groups with typed inputs and outputs.

Installation

NodeForge requires Blender 5.2 or newer.

  1. In Blender, open Edit → Preferences → Get Extensions.
  2. Under Repositories, choose Add Remote Repository and enter https://denikryt.github.io/NodeForge/index.json.
  3. Find NodeForge, click Install, and enable the add-on.

Installing through this repository lets you receive NodeForge updates in Blender.

To install directly from a ZIP instead, download the latest archive from GitHub Releases, then use Get Extensions → Install from Disk... and enable NodeForge. Installations from disk are updated by installing a newer ZIP manually.

If you used the earlier ZIP add-on, disable it before enabling the Extension. Your Packages and Local files remain in Blender's user-data directories.

Quick start

  1. Select a mesh object and open the Geometry Node Editor.
  2. Click New to create a Geometry Nodes modifier and node tree for the object.
  3. Press N and open the NodeForge tab in the sidebar.
  4. Open a Text Editor, click New, and enter this .nf script:
def make_cube(size: Float["Size"] = 2.0) -> Geometry:
    return cube(size)
  1. Return to the NodeForge sidebar and select the new text in Text Script.
  2. Click Compile Script. NodeForge creates a make_cube node-group datablock.
  3. Connect the Group Node's Value output to the existing Group Output geometry input.

See the Get Started guide for the complete beginner workflow.

The language at a glance

A module can mix function definitions, imports and ordinary executable statements:

def move_x(
    geometry: Geometry,
    x_shift: Float["X Shift"] = 0.0
) -> Geometry["Geometry"]:
    
    return transform(
            geometry, 
            translation=vector(x_shift, 0, 0)
            )

def cube_pair(
    left: Float["Left"] = -1.0,
    right: Float["Right"] = 1.0
) -> Geometry['Cube Pair']:
    
    left_cube = move_x(cube(1.0), left)
    right_cube = move_x(cube(1.0), right)

    pair = join([left_cube, right_cube])
    
    return pair

pair = cube_pair()

sub_pair = node(
    "GeometryNodeSubdivisionSurface",
    inputs={"Mesh": pair, "Level": 2},
    output="Mesh",
    typ=Geometry,
)

center = cube(0.5)
combined = join([sub_pair, center])

node(...) is the universal low-level form for Blender nodes without a dedicated NodeForge wrapper. It creates an ordinary Blender node, which can be combined with typed function calls and other expressions.

NodeForge scripts can call reusable functions and can be extended through installable third-party packages. This allows project-specific operations and larger procedural components to become part of the language used by other scripts.

Additional libraries

The Extension includes NodeForge Math for math operations and NodeForge L-System for procedural L-system generation. Both libraries are installed automatically when you enable NodeForge.

Install or update other libraries from NodeForge → Packages → Install ZIP.

Installed package APIs are imported through the package namespace (see the Package Guide):

from packages import math

def sine(x: Float) -> Float:
    return math.sin(x)

Reusable .nf files from the Local library, including folders added from disk with Add Folder..., can be imported and called from other scripts:

from local import erosion
# erosion.nf exposes declarations, for example:
result = erosion.apply(geometry)

Coverage

The syntax follows Python as closely as the Geometry Nodes model allows. The built-in function library covers only part of Geometry Nodes. When a dedicated NodeForge function is not available, node(...) can create the Blender node directly.

See the Geometry Nodes coverage page for the current feature matrix and the Core DSL Built-ins reference for the complete node(...) syntax.

How the compiler works

Internally, NodeForge parses the source, resolves its types and operations, builds a semantic intermediate representation, and lowers that representation into Blender nodes. The compiler owns the translation from source-level logic to the final GeometryNodeTree, keeping the language-facing part of the system separate from Blender graph construction.

NodeForge source
    ↓
Python AST
    ↓
semantic analysis and NFType checking
    ↓
typed Semantic IR
    ↓
Blender lowering and materialization
    ↓
existing base GeometryNodeTree + nested function GeometryNodeTrees

Learn more in the documentation:

https://denikryt.github.io/NodeForge/docs/

Support the developer:

https://www.patreon.com/c/nachitima

About

A Python-like language for building Blender Geometry Nodes with code.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages