Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.speckle.systems/llms.txt

Use this file to discover all available pages before exploring further.

This guide is for IT administrators only. If you are a regular user, see our Rhino installation guide instead.
Install separately for each version: Repeat these steps for each application version you want to use with Speckle.
Rhino and Grasshopper connectors are bundled together. Installing the Rhino connector also installs Grasshopper support.
Connector versions < 3.17.2 require the Speckle Desktop Services background service. Learn more about Desktop Services. For versions ≥ 3.17.2; the desktop service is not required.

​
Install for a single user

  1. Extract the downloaded ZIP file.
  2. Copy all contents except .gh files from .\Speckle.Connectors.Rhino{VERSION}\ to %AppData%\McNeel\Rhinoceros\{VERSION}.0\Plug-ins\Speckle.Connectors.Rhino{VERSION} (2153799A-0CEC-40DE-BC3A-01E5055222FF)\
    • Replace {VERSION} with your Rhino version (example: 8)
    • Create the directory if it doesn’t exist

​
Register the plugin

Rhino requires registry keys to recognize the plugin. This step requires administrator access.
  1. If it doesn’t exist already, create the registry key HKEY_CURRENT_USER\Software\McNeel\Rhinoceros\{VERSION}.0\Plug-Ins\2153799A-0CEC-40DE-BC3A-01E5055222FF
  2. Create a new REG_SZ value named Name
    • Set the value to Speckle.Connectors.Rhino{VERSION}
  3. Create a new REG_SZ value named FileName
    • Set the value data to the full path of the .rhp file you copied
    • Example: C:\Users\YourUsername\AppData\Roaming\McNeel\Rhinoceros\8.0\Plug-ins\Speckle.Connectors.Rhino8 (2153799A-0CEC-40DE-BC3A-01E5055222FF)\Speckle.Connectors.Rhino8.rhp

​
Install for all users

Use the following changes from the single user installation:
  • Program files: Use %ProgramData% instead of %AppData% in all file paths
  • Registry location: Use HKEY_LOCAL_MACHINE instead of HKEY_CURRENT_USER
  • Update the FileName registry value to match your %ProgramData% installation path

​
Install Grasshopper sample files (optional)

The Rhino 8 connector includes sample Grasshopper scripts. These samples work with all supported Rhino versions.
  1. Copy all .gh files from .\Speckle.Connectors.Rhino8\ to %AppData%\Grasshopper\Libraries\Speckle Sample Files\
    • Create the directory if it doesn’t exist
    • Only Rhino 8 includes sample files
Don’t copy sample files to the plugin folder: Place .gh files only in the Grasshopper Libraries folder, not with the connector files.

​
Disable update notifications

See connector-configuration documentation for disabling update notifications

​
Uninstall the connector

  1. Delete the Speckle.Connectors.Rhino{VERSION} folder from your installation location.
  2. Delete the registry keys at HKEY_CURRENT_USER\Software\McNeel\Rhinoceros\{VERSION}.0\Plug-Ins\2153799A-0CEC-40DE-BC3A-01E5055222FF
  3. Optionally, delete the Grasshopper sample files from %AppData%\Grasshopper\Libraries\Speckle Sample Files\
To remove all Speckle products, also delete the %AppData%\Speckle\ folder.

Back to manual installation overview

Return to connector selection
Last modified on April 27, 2026