Speckle currently supports versions: . The connector works on only.

Setup

The Rhino and Grasshopper connectors are bundled, so if you installed one, you don’t need to install the other.
Grasshopper is currently in beta. There may be bugs while the connector is still in development.
1

Install the connector

Install your connector
2

Open the Grasshopper connector

  1. Open Grasshopper, and select the Speckle tab in the ribbon.
  2. If you’ve already signed in from any Speckle connector, skip the next step.
Grasshopper toolbar
3

Connect your Speckle account

  1. If you’ve already signed in from any Speckle connector, skip this step.
  2. Add the Sign-In node to the canvas, and click Sign in.
  3. Complete the sign in process in your web browser.
You only need to sign in to an account once, from any Speckle connector. To switch accounts in Grasshopper, you can select the correct account by right-clicking the Speckle Model URL node.

Publishing a Model

Full documentation of all Grasshopper nodes and sample scripts are installed with your connector. Navigate to File > Special Folders > Components Folder > Speckle Sample Files in Grasshopper to find them.
1

Create a Collection with objects

  1. Add a Create Collection node from the Collections category to the canvas.
  2. Connect the geometry you want to publish to the input of the Create Collection node.
2

Get your Speckle model link

  1. Add a Speckle Model URL node to the canvas.
  2. Choose a project:
    • Click on the Project button to select a project from the dropdown
    • or use the search bar to find another project.
  3. Choose a model:
    • Click on the Model button to select a model from the dropdown
    • or use the search bar to find another model.
3

Publish your model

  1. Add a Publish node to the canvas and connect your inputs:
  • Add your Create Collection output to the Collection input.
  • Add your Speckle Model URL output to the Model Link input.
  1. Click Publish. Your model is now published to Speckle and is available to the rest of your team.
Grasshopper publish

Loading a Model

Full documentation of all Grasshopper nodes and sample scripts are installed with your connector. Navigate to File > Special Folders > Components Folder > Speckle Sample Files in Grasshopper to find them.
1

Get your Speckle model link

  1. Add a Speckle Model URL node to the canvas.
  2. Choose a project:
    • Click on the Project button to select a project from the dropdown
    • or use the search bar to find another project.
  3. Choose a model:
    • Click on the Model button to select a model from the dropdown
    • or use the search bar to find another model.
  4. Choose a version:
    • Latest version is loaded by default.
    • To load a specific version, click on the Version button and select.
2

Load your model

  1. Add a Load node to the canvas and connect your input:
    • Add your Speckle Model URL output to the Model Link input.
  2. Click Load. Your selected model version is now loaded in Grasshopper.
3

Get your model objects

  1. Add a Query objects node to the canvas and connect your input:
    • Add your Load output to the collection input.
  2. You can now work with your loaded objects in Grasshopper.
Grasshopper load