Home

Pynodes is a module as well as an addon for blender to create all kinds of nodes in node editor with python scripts.

---

About the birth of this module

Although this module is derived from geonodes, But the implementation logic and usage are completely different.

For geonodes, only geometry nodes are supported, while pynodes supports almost all of blender’s node trees, including geometry nodes and material nodes.

Prerequisities

Before using pynodes, you must first know:

• How to use Blender Node editor

• Python language

• How to run Python script in Blender

Bacis Concepts

Nodes are created by a series of chain calls in a python function decrorated by pynodes.core.tree which represents a node group in blender.

• Operations on nodes are based on the output port(data socket), not on the node itself.

• A decorated Python function (@tree) corresponds to a tree of nodes. Calling the function means creating a group node in the current node tree.

• Data in a data flow has strict type checking, what methods are available for the data socket, and what is provided by its type.

• Good IDE support，e.g. VS Code. All exposed methods have built-in documentation, including images of the nodes involved, optional enumeration parameters, and links to official documentation.

---

Content

• Quick Start
  • Install Addon
  • Setup VSCode
  • A Quick Example

• Gallery
  • Geometry Nodes
  • Shader Nodes
  • Simulation Nodes

• Available Socket Types

• API Reference
  • pynodes
    • Submodules
      • pynodes.addon
      • pynodes.colors
      • pynodes.core
      • pynodes.datasocks
      • pynodes.geosocks
      • pynodes.nodes
      • pynodes.scene
    • Package Contents
      • Functions
      • Data
      • API