home / docs / grasshopper setup

Posted on Tue, Mar 28, 2017 | 2 min read

This tutorial guides you through installing Speckle for Grasshopper. It has been tested on Rhino 5 and Rhino 6 WIP.

Step 0: What’s in the box

The releases contain both the Speckle Grasshopper Clients as well as the Speckle User Data Utils (more to come).

Step 1: Download the latest version.

Head over to Github.


If you want to grab a specific version, feel free. Nevertheless, it usually best to download the latest version (ie highest release number).

This tutorial was written early. So there’s just the 0.0.2 release. Go ahead and click on the folder. Inside you will find a zip file. Click on it and then select “download” from the top right button. git

Step 2: Installation

Close Rhino and Grasshopper if you have them running by any chance.

Unzip the downloaded zip and copy and paste the two folders in the Grasshopper components folder: %appdata%\Roaming\Grasshopper\Libraries.

PS: Always delete previous speckle versions.

Make sure that all dll and gha files are not in the root folder (\Libraries). They should be all nicely cuddling each other in their own folders.

Like this:


Not like this, ok? Different plugins use different dependency versions and this is one sure way to get errors.


Step 3: Create Your First Account

Fire Rhino and Grasshopper up. The Speckle Components should appear in their own tab, called Speckle. Wow! Smooth sailing so far.


When you will first drag a Speckle Sender or Speckle Receiver component to the canvas, a dialog will ask you to create an account (or use an existing one).

Since I’m assuming you are a new user, let’s go ahead and make a new one:


  • Server Url: use https://server.speckle.works or, if you deployed your own, your ip/url address.
  • Email: your email address.
  • Password: your password.
  • Confirm: confirm your password.

Click register, and voila! You should be up and running. Next time you will create a Sender or Receiver, you will be able to select from a previously used account.


I’ve been testing quite a bit, as such there’s a few of them in there. Okay, that’s it.

Having trouble? Found a bug? Have a question? Join the discussion below our join our slack channel.