base-node (.bn) v0.13.1

Blender node trees, written as text.

Geometry Nodes, shaders, the compositor and Grease Pencil as .bn files you can read, diff, review in git, paste into Blender and generate. The add-on turns the text into nodes while you type, and the nodes back into text. Open source (MIT or Apache-2.0), with a standard library, parsers in Python and Rust, and a web viewer.

chrono_hud.bn — free modules
metaball_symphony.bn
differential_growth.bn
reaction_diffusion.bn

Tutorials

One subject per tutorial, step by step: every step is a complete .bn file and the picture it renders. They need nothing but the add-on.

Lunar groundLunar ground8 steps Mini moonMini moon5 steps

All tutorials →

Install and use it in Blender

One-click install via Blender Remote Extension Repository:

https://marcgardent.github.io/base-node-language/extensions/index.json

In Blender: Edit > Preferences > Get Extensions > Repositories > + > Add Remote Repository, paste the URL above, and install Base Node.

Blender 5.2+ extension (id = "base_node"). The node tree is the only data: its .bn text is a temporary view of it.

Copy and paste graphs as text

Copy this, press Ctrl+Shift+V in a Geometry Node editor, then Add as Modifier: columns on a grid rise with a ripple from the centre (examples/ripples.bn).

use math (palette, sine01)

geometry graph ripples(count: Int = 40 in 2.., waves: Float = 2.5, height: Float = 0.6) -> Geometry {
  "Columns on a grid that rise with a ripple from the centre, coloured by their height"
  p = Position()
  rise = sine01(length(CombineXYZ(p.x, p.y)) * waves * 0.5) * height + 0.05
  column = Cube(size: (0.08, 0.08, 1.0)) |> TransformGeometry(translation: (0.0, 0.0, 0.5))
  return Grid(4.0, 4.0, count, count)
    |> MeshToPoints()
    |> InstanceOnPoints(instance: column, scale: CombineXYZ(1.0, 1.0, rise))
    |> RealizeInstances()
    |> StoreNamedAttribute(name: "color", value: palette(Position().z / height), data_type: FLOAT_COLOR)
}

The free standard library

Eleven modules ship with the add-on: 2D SDFs and curves, fillets, planar maps, patterns, math and noise, compositor masks, Nuke-style merges and grades, STMaps and QC charts. Their graphs, targets and pictures are on the Developers page, every graph in the Reference.

Other tools that write nodes as text

Nuke, Houdini, Substance Designer, MaterialX, ComfyUI, Unity, Godot, Unreal and TouchDesigner each store or script their node graphs in their own way. State of the Art — Autumn 2026 compares which ones read their text back, with sources.