ISO module at Imperial

ShapeCraft: an LLM Multi-agent Pipeline for Synthesizing 3D Shape Programs

Subsequent development will be in shapecode repository.

Getting started

Install dependencies in a python (recommanded 3.10.16) environment:

• pip install -r requirements for all dependencies

Files of interest

in src:

Running experiments:

• exp_1_loop.py: Single Run with Python + Blender
• exp_full.py: Full Pipeline with Python + Blender
• exp_scad_single.py: Single Run with OpenSCAD
• exp_scad_full.py: Full Pipeline with OpenSCAD

Visualization:

• vis_single.py: examining single run method results folder (can work with full pipeline too, just click into them)

Evaluation:

• eval_clip.py: aggregate and plot clip similarities
• eval_vlm.py: aggregate and plot vlm evaluations
• eval_for_table.py: aggregate results and print as pretty tables
• eval_utils.py: count OBJ faces and vertex
• evalexp_iterations.py: check for improvements over iterations

Auxiliary:

• agents.py: llm agents code
• chat.py: api
• combine_and_run.py: combine generated script with our suffix and run to render and export

root:

• code_suffix.py: suffix appended to each generated python script to be executed within blender
• render_stl.py: import OpenSCAD generated stl file, normalize and render export in blender