1 — Install
Install the extension with Pi. The postinstall step builds the Grasshopper
plugin and copies it into your Libraries/hopper-pi/ folder.
pi install npm:hopper-pi2 — Restart Rhino
- Restart Rhino and open Grasshopper.
- Place the Hopper Code Backend component (
GHZMQ) on the canvas — find it under Params → Util. - If the component shows offline, run
/hopper-backendto refresh the connection.
3 — Talk to Pi
Start Pi with the extension loaded. The gh_* and
rh_* tools register automatically — just describe what you want
to build.
# after the backend component is on the canvas and Pi is running,
# just describe what you want — e.g.:
"add a number slider from 0 to 10 and wire it into the X input of a point component"Try it
A few things worth asking the agent on a fresh canvas:
- “List the components on this canvas and any runtime errors.”
- “Capture the current viewport so you can see what I’m looking at.” (requires viewport-capture consent)
- “If my requirements are ambiguous, ask me a question or give me options to pick from.”
- “Run a Rhino command to select all curves, then query them with short IDs.”