Skip to main content
Use any published Runchat workflow as a Grasshopper component. The plugin ships with Runchat for Rhino, so if you’ve already installed that, you have this too.

​
Getting Started:

​
1. Install Runchat for Rhino

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

​
2. Download the examples

Head to the Examples page to download example grasshopper definitions and learn from their matching Runchats. Or if you just want to download the grasshopper files to get started you can grab them here:
Download a ZIP file of all examples here: GH Examples ZIP
Once you’ve unzipped the examples folder, open the 01_BasicDemo.gh in Grasshopper. You will need to create a Runchat API key to connect Grasshopper to your Runchat account.
  • Right-click the runchat node in the grasshopper definition and click “Get API Key”, or head to runchat.com and create an account or sign in
  • Verify your account by following the link sent to your email address
  • Whilst logged into your account:
    • Proceed to runchat.com/dashboard
    • Copy your key to your clipboard. If you need another one, you can create one from the account menu.
Back in Grasshopper, open the 01_BasicDemo.gh file. Right-click the Runchat component and paste your API key in the text field that says “Set API Key”. Press enter to save the key. Your Runchat account is now linked and you can run the examples!
The API key is stored as a local environment variable and is not saved with your Grasshopper definition.

​
4. Watch the tutorial series to build your own workflows

​
5. Using the Runchat Agent in Grasshopper (Beta)

You can use the chat 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 the Grasshopper component reference (utility components, right-click options, troubleshooting), see Components → Runchat.

​
Next steps