Skip to content
Back to search

geometry-script

MarketplaceWorks with Claude CodeGitHub

Geometry Script for Blender: a Python API for node trees, and a skill for building them.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/carson-katri/geometry-script with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/carson-katri/geometry-script'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/carson-katri--geometry-script/badge.svg)](/listings/carson-katri--geometry-script)

HTML

<a href="/listings/carson-katri--geometry-script"><img src="/api/listings/carson-katri--geometry-script/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Geometry Script is a Blender extension and requires Blender 5.2 or newer.

Drag the box for your Blender version into Blender to install it:

<p> <a href="https://github.com/carson-katri/geometry-script/releases/download/nightly/geometry_script-1.0.0-blender-5.2.zip?repository=./index.json&amp;blender_version_min=5.2.0&amp;blender_version_max=5.3.0"><picture><source media="(prefers-color-scheme: dark)" srcset="book/src/images/install/blender-5.2-dark.svg"><img alt="Geometry Script for Blender 5.2" src="book/src/images/install/blender-5.2-light.svg" width="200" height="72"></picture></a> <a href="https://github.com/carson-katri/geometry-script/releases/download/nightly/geometry_script-1.0.0-blender-5.3.zip?repository=./index.json&amp;blender_version_min=5.3.0&amp;blender_version_max=5.4.0"><picture><source media="(prefers-color-scheme: dark)" srcset="book/src/images/install/blender-5.3-dark.svg"><img alt="Geometry Script for Blender 5.3" src="book/src/images/install/blender-5.3-light.svg" width="200" height="72"></picture></a> <a href="https://github.com/carson-katri/geometry-script/releases/download/nightly/geometry_script-1.0.0-blender-5.4.zip?repository=./index.json&amp;blender_version_min=5.4.0&amp;blender_version_max=5.5.0"><picture><source media="(prefers-color-scheme: dark)" srcset="book/src/images/install/blender-5.4-dark.svg"><img alt="Geometry Script for Blender 5.4" src="book/src/images/install/blender-5.4-light.svg" width="200" height="72"></picture></a> </p>

Blender asks to allow online access if it's off, then to add the Geometry Script repository, then confirms the install. The [`nightly` release](https://github.com/carson-katri/geometry-script/releases/tag/nightly) always lists the links for every Blender version with a build.

To install manually instead:

1. Download the ZIP matching your Blender version from the [`nightly` release](https://github.com/carson-katri/geometry-script/releases/tag/nightly), e.g. `geometry_script-1.0.0-blender-5.2.zip` 2. Open *Blender* > *Preferences* > *Get Extensions* 3. Open the dropdown at the top right, choose *Install from Disk...* and select the downloaded ZIP file

Claude Code skill

The repository is also a [Claude Code](https://claude.com/claude-code) plugin marketplace with a skill for building node trees with Geometry Script. Install it with:

/plugin install geometry-script --marketplace carson-katri/geometry-script

On Claude Code versions before 2.1.275, add the marketplace first:

/plugin marketplace add carson-katri/geometry-script
/plugin install geometry-script@geometry-script

The skill runs scripts through Blender's MCP server when it's connected, or in background Blender otherwise. Run `/plugin marketplace update geometry-script` to get the latest version, or turn on auto-update for the marketplace in `/plugin`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "geometry-script",
  3. "description": "Geometry Script for Blender: a Python API for node trees, and a skill for building them.",
  4. "owner": { "name": "Carson Katri" },
  5. "plugins": [
  6. {
  7. "name": "geometry-script",
  8. "source": ".",
  9. "description": "Skill for building Blender node trees with Geometry Script."
  10. }
  11. ]
  12. }
README.md · README · 110 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ![Geometry Script wordmark](book/src/images/wordmark.png)
  2. A scripting API for Blender's Geometry Nodes, shaders and compositor:
  3. <table>
  4. <tbody>
  5. <tr>
  6. <td>
  7. ```python
  8. from geometry_script import *
  9. @tree("Repeat Grid")
  10. def repeat_grid(geometry: Geometry, width: int = 3, height: int = 3):
  11. mesh = grid(
  12. size_x=width, size_y=height,
  13. vertices_x=width, vertices_y=height,
  14. ).mesh
  15. points = mesh_to_points(mesh=mesh).points
  16. return instance_on_points(points=points, instance=geometry).instances
  17. ```
  18. </td>
  19. <td>
  20. ![Generated node tree](book/src/images/example_generated_tree.png)
  21. </td>
  22. </tr>
  23. </tbody>
  24. </table>
  25. ## Installation
  26. Geometry Script is a Blender extension and requires Blender 5.2 or newer.
  27. Drag the box for your Blender version into Blender to install it:
  28. <p>
  29. <a href="https://github.com/carson-katri/geometry-script/releases/download/nightly/geometry_script-1.0.0-blender-5.2.zip?repository=./index.json&amp;blender_version_min=5.2.0&amp;blender_version_max=5.3.0"><picture><source media="(prefers-color-scheme: dark)" srcset="book/src/images/install/blender-5.2-dark.svg"><img alt="Geometry Script for Blender 5.2" src="book/src/images/install/blender-5.2-light.svg" width="200" height="72"></picture></a>
  30. <a href="https://github.com/carson-katri/geometry-script/releases/download/nightly/geometry_script-1.0.0-blender-5.3.zip?repository=./index.json&amp;blender_version_min=5.3.0&amp;blender_version_max=5.4.0"><picture><source media="(prefers-color-scheme: dark)" srcset="book/src/images/install/blender-5.3-dark.svg"><img alt="Geometry Script for Blender 5.3" src="book/src/images/install/blender-5.3-light.svg" width="200" height="72"></picture></a>
  31. <a href="https://github.com/carson-katri/geometry-script/releases/download/nightly/geometry_script-1.0.0-blender-5.4.zip?repository=./index.json&amp;blender_version_min=5.4.0&amp;blender_version_max=5.5.0"><picture><source media="(prefers-color-scheme: dark)" srcset="book/src/images/install/blender-5.4-dark.svg"><img alt="Geometry Script for Blender 5.4" src="book/src/images/install/blender-5.4-light.svg" width="200" height="72"></picture></a>
  32. </p>
  33. Blender asks to allow online access if it's off, then to add the Geometry Script repository, then confirms the install. The [`nightly` release](https://github.com/carson-katri/geometry-script/releases/tag/nightly) always lists the links for every Blender version with a build.
  34. To install manually instead:
  35. 1. Download the ZIP matching your Blender version from the [`nightly` release](https://github.com/carson-katri/geometry-script/releases/tag/nightly), e.g. `geometry_script-1.0.0-blender-5.2.zip`
  36. 2. Open *Blender* > *Preferences* > *Get Extensions*
  37. 3. Open the dropdown at the top right, choose *Install from Disk...* and select the downloaded ZIP file
  38. ### Claude Code skill
  39. The repository is also a [Claude Code](https://claude.com/claude-code) plugin marketplace with a skill for building node trees with Geometry Script. Install it with:
  40. ```
  41. /plugin install geometry-script --marketplace carson-katri/geometry-script
  42. ```
  43. On Claude Code versions before 2.1.275, add the marketplace first:
  44. ```
  45. /plugin marketplace add carson-katri/geometry-script
  46. /plugin install geometry-script@geometry-script
  47. ```
  48. The skill runs scripts through Blender's MCP server when it's connected, or in background Blender otherwise. Run `/plugin marketplace update geometry-script` to get the latest version, or turn on auto-update for the marketplace in `/plugin`.
  49. ## What is Geometry Script?
  50. *Geometry Script* is a robust yet easy to use Python API for creating Geometry Nodes with code.
  51. At a certain point, Geometry Node trees become unmanagably large. Creating node trees in Python enables quicker editing and reorganization of large, complex trees.
  52. *Geometry Script* has all of the performance and capabilities of Geometry Nodes, but in a more managable format. The scripts are converted directly to Geometry Node trees making them easy to tweak for others unfamiliar with scripting.
  53. Every node in your Blender version is available as a typed Python function, generated from Blender itself, so your editor can complete node names, inputs, outputs and enum values.
  54. Shader node groups, materials, worlds and compositor node groups can be scripted the same way, with `geometry_script.shader` and `geometry_script.compositor`:
  55. ```python
  56. from geometry_script.shader import *
  57. @material("Gold")
  58. def gold():
  59. return principled_bsdf(base_color=(1.0, 0.77, 0.34, 1.0), metallic=1.0, roughness=0.2).bsdf
  60. ```
  61. ## [Documentation](https://carson-katri.github.io/geometry-script/)
  62. Read the documentation for more information on installation, syntax, and tutorials.
  63. ## Contributing
  64. Use [`uv`](https://docs.astral.sh/uv/) to get `fake-bpy-module` and some pyright settings.
  65. ```sh
  66. uv sync
  67. ```
  68. The node modules (`api/nodes.py`, `api/shader_nodes.py` and `api/compositor_nodes.py`) are generated from Blender and aren't checked in. Loading the add-on from a checkout generates them with that Blender, or you can generate them yourself, e.g. for editor completions:
  69. ```sh
  70. blender -b --factory-startup --python code_generator/node_functions_generator.py
  71. ```
  72. To build an installable package for a specific Blender version, which generates the node modules with that Blender and runs the smoke test:
  73. ```sh
  74. python tools/build.py --blender /path/to/blender # writes dist/geometry_script-<version>-blender-<major>.<minor>.zip
  75. ```
  76. Then you can [follow Blender's steps](https://developer.blender.org/docs/handbook/extensions/addon_dev_setup/#setting-up-project) to setup a symlink for a local repository.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.