explaingit

eesjgong/graph-cad

Analysis updated 2026-05-18

147PythonAudience · researcherComplexity · 5/5Setup · hard

TLDR

A research system that turns a plain-English description of a 3D object into working Blender code through an intermediate structured graph.

Mindmap

mindmap
  root((Graph-CAD))
    What it does
      Text to CAD generation
      Decomposition graph
      Executable Blender code
    Tech Stack
      Python
      Blender
      Qwen3
    Use Cases
      Generate CAD from text
      Reduce cascading errors
      Train with curriculum learning
    Audience
      Researchers
      ML engineers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate executable Blender code for a 3D object from a plain-English text description

USE CASE 2

Study a graph-mediated approach to reducing cascading errors in long CAD code generation

USE CASE 3

Train or fine-tune a Text-to-CAD model using the progressive curriculum learning technique

USE CASE 4

Use the BlendGeo dataset of instruction, graph, and code pairs for CAD generation research

What is it built with?

PythonBlenderQwen3

How does it compare?

eesjgong/graph-cad2dogsandanerd/clawragmurphylmf/unish
Stars147147145
LanguagePythonPythonPython
Setup difficultyhardmoderatehard
Complexity5/54/55/5
Audienceresearcherdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires downloading multi-gigabyte model weights, a base LLM, and Blender, plus GPU compute for inference.

License terms are not stated in the provided README excerpt.

In plain English

Graph-CAD is a research project that lets you describe a 3D object in plain English and get back working Blender code that builds it, a process called Text-to-CAD. Instead of jumping straight from your words to executable code (which tends to produce cascading errors in complex models), Graph-CAD first builds an intermediate "decomposition graph", a structured map of the object's parts and how they fit together geometrically, and then converts that map into code in two more steps. The pipeline works in three stages. First, a model reads your text instruction and predicts a hierarchical graph that breaks the object down into sub-components, capturing spatial relationships like alignment and attachment. Second, a planning model converts that graph into an ordered sequence of CAD actions. Third, a code generation model turns those actions into executable Blender Python code you can actually run. To make the system more robust on complicated assemblies, the project uses a training technique called progressive curriculum learning, which automatically creates increasingly difficult training examples near the edge of what the model can handle, pushing its capability boundary outward over time. The project also introduces BlendGeo, a 12,000-example dataset pairing text instructions with decomposition graphs, action sequences, and runnable Blender code. The paper was accepted at ICLR 2026. Pre-trained model weights are available on ModelScope. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Explain how Graph-CAD's three-stage pipeline turns a text instruction into Blender code
Prompt 2
Walk me through setting up Graph-CAD, including downloading the model weights and Blender
Prompt 3
Explain what progressive curriculum learning does in this project's training process
Prompt 4
Describe what the BlendGeo dataset contains and how it's used to train the model

Frequently asked questions

What is graph-cad?

A research system that turns a plain-English description of a 3D object into working Blender code through an intermediate structured graph.

What language is graph-cad written in?

Mainly Python. The stack also includes Python, Blender, Qwen3.

What license does graph-cad use?

License terms are not stated in the provided README excerpt.

How hard is graph-cad to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is graph-cad for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.