Skip to main content

SmartHopper Documentation

Welcome to the SmartHopper manual. SmartHopper is the open-source AI plugin for Grasshopper 3D (Rhino 8) that brings language, vision, audio, and external knowledge models directly into your parametric design workflow. For a high-level overview of the project, visit smarthopper.xyz.

How this documentation is organized​

SectionWhat you'll find
User Guide (you are here)Installation, setting up AI providers, using the canvas assistant, step-by-step guides for common tasks, settings, and troubleshooting.
Component LibraryEvery Grasshopper component included with SmartHopper, organized by ribbon panel (A. AI through J. Script).
AI Tools LibraryAll 80+ tools that the canvas assistant and external MCP clients can run on your behalf.
Developer GuideArchitecture, project structure, and how to extend SmartHopper with custom AI providers, tools, context providers, and components.
VideosRecorded walkthroughs of key workflows, each paired with a written guide.

New to SmartHopper? Start here​

  1. Install SmartHopper — install from the Rhino Package Manager, Food4Rhino, or GitHub Releases.
  2. Set up an AI provider — connect OpenAI, Anthropic, Google Gemini, MistralAI, DeepSeek, or OpenRouter, or run locally for free with Ollama or LocalAI.
  3. Choose your default provider and model — set a global default or override it per component.
  4. Run your first AI workflow — wire your first Input → Output components and open the canvas assistant.

Common workflows​

Working with the assistant and canvas​

Working with components, data, and external tools​

Need help?​