Skip to main content

Installation

SmartHopper runs on Windows and macOS with Rhino 8.0 or newer. Three installation methods are available — the Rhino Package Manager is recommended.

Compatibility

SmartHopper targets Rhino 8 / Grasshopper 1 on both Windows and macOS. Rhino 7 is not supported by current releases.

  1. Open Rhino 8.

    Open Rhino 8

  2. Open the Package Manager. Type PackageManager in the Rhino command line, or go to Tools → Package Manager.

    Open Package Manager

  3. Search for "SmartHopper" and click Install. Check Include pre-releases if you want the latest experimental features.

    Install SmartHopper

  4. Restart Rhino and open Grasshopper — SmartHopper components appear under the SmartHopper category, and a SmartHopper entry appears in the Grasshopper menu bar.

Method 2 — Food4Rhino​

  1. Go to the SmartHopper page on Food4Rhino and log in.

    Food4Rhino page

  2. Scroll down and click Install. This opens the Rhino Package Manager and installs the plugin.

    Install from Food4Rhino

Method 3 — Manual installation (development builds)​

Use this for pre-release builds published on GitHub.

  1. Download the latest ZIP for your platform from GitHub Releases.

    GitHub releases

  2. Extract the ZIP into your Grasshopper components folder. Find it quickly from Grasshopper via File → Special Folders → Components Folder (usually %APPDATA%\Grasshopper\Libraries on Windows).

    Extract files

  3. Unblock the files:

    • Windows: files downloaded from the internet may be blocked. Right-click each file → Properties → check Unblock → OK.
    • macOS: if Gatekeeper blocks the plugin, run xattr -dr com.apple.quarantine on the components folder.

    Unblock files

  4. Restart Rhino.

Next steps​

Troubleshooting​

If SmartHopper does not appear in Grasshopper after install, see Troubleshooting — most cases are blocked files or a Rhino version mismatch.