Skip to main content
Run AI workflows from inside Rhino. Render screenshots, generate 3D models, and have the agent write Python that runs in your active document. The same install also enables Runchat in Grasshopper.

Getting Started:

Install Runchat for Rhino

  • In rhino, run PackageManager
  • Search for Runchat and Install it
  • Restart Rhino

Launch Runchat and Sign In

Run the Runchat command in Rhino to open a web browser that is connected to Rhino. Log in to your Runchat account and then click on a workflow from your dashboard or create a new one to open the editor

Rhino Tools

When Runchat runs inside Rhino, a Rhino chip appears at the top-right of the editor. Click Import view beside it, or open the chip’s menu for the other import and send actions.

Use Rhino screenshots in your workflows

Click Import view to capture your current active Rhino view and load it as a node in Runchat. If an image node is selected, the menu item reads Replace selected image with view and swaps the new screenshot into that node. For the full rendering workflow, see Render from a Rhino screenshot.

Import 3D models directly to Rhino

First, generate a 3D model in Runchat. Then select the node, open the Rhino chip and choose Send selected GLB (or Send selected Splat for Gaussian splats). This downloads the model and materials and loads them in your Rhino viewport at 0,0,0. For more on 3D model selection, see Generate 3D models from images.

Send curves between Rhino and Runchat as SVG

Select curves in Rhino, open the Rhino chip and choose Import objects as SVG. The geometry arrives as a vector node in Runchat that you can iterate on with a Code node or use as input in a workflow. To send back the other way, select an SVG node in Runchat and choose Send selected SVG from the chip. The curves land in Rhino with their colours preserved. This is great for bringing AI-generated floor plan variations into Rhino as editable linework.

Generate and run Rhino Python scripts

To generate Python scripts, describe what you want to the agent in the composer at the bottom of the editor. For simple scripts, the default model will be fine. For more advanced scripts, open the agent menu (the chat title) and choose a model that performs well in coding benchmarks (e.g. Anthropic models) from Model: . The agent works best with incremental implementation: start with a small feature and iterate from there. The agent creates a script on the Runchat canvas when it’s finished. It might also make some UI for setting parameters in the script. Click Run in Rhino on the script node’s toolbar to run it in Rhino. If you need changes, continue the chat and paste screenshots from Rhino as required. Python is the default. Ask the agent for C# if you prefer it: it writes a Rhino C# script node instead, which needs Rhino 8 or later and Runchat plugin 0.3.77 or later.

Turn scripts into toolbar buttons

Ask the agent to make a script or a small app into a CAD tool: a button on your Runchat toolbar that you can publish and share with your team. See Rhino Tools.

Using the Runchat Agent in Grasshopper (Beta)

You can also use the agent in the Runchat Rhino plugin window to interact with your active Grasshopper document. The agent can:
  • Read the canvas and explain what the definition does
  • Read the inputs and outputs of individual components
  • Search for components and add them to the canvas
  • Connect and disconnect components to build definitions
You can use the agent for:
  • Asking questions about your grasshopper definition
  • Building simple definitions from scratch
  • Converting Rhino scripts to grasshopper definitions
For full setup and the API key flow, see Runchat for Grasshopper.
Make the Runchat plugin window a narrow portrait to maximise space for Grasshopper + Rhino + Runchat.

Next steps