Grasshopper Generator

Generate Rhino 7 Grasshopper (.ghx) XML files from natural language descriptions or images. Build parametric definitions with native GH components, GhPython scripts, and wiring. Supports concept design: twisted towers, curved facades, Voronoi patterns, diagrids, parametric surfaces, mesh operations, and custom Python geometry. Triggers: grasshopper, generate ghx, parametric definition, GH file, grasshopper definition, 参数化, 生成gh文件, when user wants a .ghx file.

Generate Rhino 7 Grasshopper (.ghx) files programmatically.

Workflow

1. Analyze Input

Image → Identify form (tower/dome/surface/facade), key features (twist/array/voronoi/diagrid), proportions. Text → Parse the same from description.

2. Design the Graph

Sliders → Geometry → Transforms → Booleans → Output

Component priority:

1. Native GH components (see references/component_guids.json for 152 known GUIDs)
2. GhPython Script for complex custom logic
3. Third-party plugins only when explicitly requested

Common patterns:

Form	Key Components
Twisted tower	Rectangle → Rotate → Extrude → Series
Curved facade	Curve → Divide → Orient → Surface
Voronoi	Populate 2D → Voronoi → Boundary Surfaces
Diagrid	Hexagonal → Scale → Loft
Dome	Circle → Rotate → Sweep1
Custom logic	GhPython Script

3. Generate .ghx

import sys; sys.path.insert(0, 'SKILL_DIR/scripts')
from ghx_generator import GHXGenerator

gen = GHXGenerator("Definition Name", "Description")
r = gen.add_slider("Radius", 20, 1, 100, x=50, y=50)
c = gen.add_component("Circle", inputs=["Base Plane", "Radius"], outputs=["Circle"], x=300, y=50)
gen.connect(r, "output", c, "Radius")
gen.save("output.ghx")

4. GhPython Fallback

For complex geometry not achievable with native components:

py = gen.add_python("Custom", code, inputs=["x", "y"], outputs=["a"], x=300, y=200)

GhPython has full Rhino.Geometry API. Input variables available by name. Assign a = result for output.

5. Deliver

Save .ghx and send to user. Note adjustable parameters (sliders), definition purpose, and any plugin dependencies.

File Locations

• Generator: scripts/ghx_generator.py — full API with add_slider, add_component, add_python, connect, save
• GUID database: references/component_guids.json — 152 authentic component GUIDs extracted from real .gh files
• Reference template: references/template_voronoi.ghx — real Grasshopper file for structural reference

Notes

• Output is .ghx (XML), fully compatible with Rhino 7
• All GUIDs extracted from real Grasshopper installations
• For components not in the database, GhPython Script handles everything
• Supports wiring via connect(source_ref, source_param, target_ref, target_param)