Aller au contenu

Geometry Script : un addon Blender qui donne à Claude une API pour les node trees

Votre prochaine création commence par une phrase. — crédits offerts à l’inscription Donner vie à mon idée

Les node trees de Blender sont puissants, mais ils deviennent vite difficiles à lire et à réorganiser quand ils grossissent. Geometry Script, un addon open source, propose une autre voie : décrire les nœuds par du code Python plutôt que de les câbler à la main. L'auteur du dépôt indique que l'outil, créé il y a plusieurs années, s'avère particulièrement adapté aux agents de code comme Claude, qui peuvent alors manipuler les Geometry Nodes et les Shader Nodes via une API plutôt que par l'interface graphique.

Il faut préciser d'emblée ce que cette approche n'est pas : aucune évaluation indépendante de l'efficacité réelle de l'outil n'est fournie par la source, qui est la documentation du dépôt GitHub. Les observations rapportées ci-dessous viennent de l'auteur, pas d'un test tiers.

Le principe : chaque nœud devient une fonction Python

Geometry Script est une API Python permettant de créer des Geometry Nodes de Blender par code. Son point central : chaque nœud de la version de Blender installée est exposé comme une fonction Python typée, générée directement depuis Blender. L'éditeur peut ainsi compléter les noms de nœuds, les entrées, les sorties et les valeurs d'énumération.

Les scripts produits sont convertis en node trees Geometry Nodes classiques, ensuite modifiables dans Blender. On ne quitte donc pas l'écosystème : le code sert de moyen de construction, le graphe reste le résultat éditable.

L'outil ne se limite pas aux Geometry Nodes. Les shaders, matériaux, mondes et groupes de compositing peuvent aussi être scriptés via les modules dédiés (shader et compositor).

Pourquoi un agent de code y gagne

L'argument de l'auteur est simple : les node trees deviennent ingérables à grande taille, et le code facilite leur édition et leur réorganisation. Pour un agent de code, l'intérêt est plus structurel. Une API typée expose des noms de fonctions, des entrées et des sorties explicites, ce qui réduit l'ambiguïté par rapport à une manipulation d'interface. L'agent peut générer, relire et modifier du texte, là où l'interface graphique demande des actions visuelles difficiles à décrire et à vérifier.

Le dépôt va plus loin en se présentant aussi comme un marketplace de plugins Claude Code, avec une skill dédiée à la construction de node trees. Cette skill exécute les scripts via le serveur MCP de Blender s'il est connecté, sinon dans un Blender en arrière-plan. C'est le point le plus directement lié à Claude : l'agent n'a pas besoin de piloter l'interface, il produit du code que l'addon transforme en graphe.

Installation : deux chemins

L'extension nécessite Blender 5.2 ou une version plus récente. Deux méthodes sont documentées :

  • Installation par lien : glisser le lien correspondant à la version de Blender, autoriser l'accès en ligne et ajouter le dépôt.
  • Installation manuelle : télécharger un ZIP, puis passer par Preferences > Get Extensions > Install from Disk.

Pour la skill Claude Code, une nuance de version compte : sur les versions de Claude Code antérieures à 2.1.275, il faut d'abord ajouter le marketplace. Au-delà, le flux est plus direct.

Autre point technique à connaître : les modules de nœuds ne sont pas versionnés. Ils sont générés depuis Blender au chargement de l'addon, ou manuellement. Un script de build permet de produire un paquet installable pour une version spécifique de Blender et de lancer un test de fumée.

Ce qu'il faut garder en tête

La source ne détaille pas les limites pratiques, les performances ou les cas d'échec de l'API. Elle ne garantit pas non plus la compatibilité avec les futures versions de Blender ou de Claude Code. Il s'agit d'une documentation de dépôt, pas d'une évaluation tierce, et l'affirmation sur l'efficacité accrue des agents de code reste celle de l'auteur.

Pour un créateur 3D francophone, l'outil a surtout un intérêt de méthode : il rend les graphes procéduraux accessibles à une écriture textuelle, donc plus faciles à versionner, à relire et à confier à un assistant. Cela ne remplace pas la compréhension des nœuds ; cela déplace une partie du travail vers le code.

Comparaison rapide des deux modes de travail

CritèreNode tree à la mainVia Geometry Script
SaisieInterface graphiqueCode Python typé
Lisibilité sur grand grapheLimitée selon l'auteurAméliorée par le code
Adapté à un agent de codePeuOui, via API et skill
RésultatNode treeNode tree éditable
PrérequisBlenderBlender 5.2+, addon

À retenir

  • Geometry Script transforme chaque nœud en fonction Python typée, générée depuis Blender.
  • Les scripts deviennent des Geometry Nodes modifiables dans Blender.
  • Shaders, matériaux, mondes et compositing sont aussi couverts.
  • Une skill Claude Code existe, avec serveur MCP ou Blender en arrière-plan.
  • Blender 5.2+ requis ; modules générés au chargement, non versionnés.
  • Aucun test indépendant d'efficacité n'est fourni : prudence sur les promesses.

Source

Show HN: A Blender addon that makes Claude twice as efficient at using nodes