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
| Section | What 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 Library | Every Grasshopper component included with SmartHopper, organized by ribbon panel (A. AI through J. Script). |
| AI Tools Library | All 80+ tools that the canvas assistant and external MCP clients can run on your behalf. |
| Developer Guide | Architecture, project structure, and how to extend SmartHopper with custom AI providers, tools, context providers, and components. |
| Videos | Recorded walkthroughs of key workflows, each paired with a written guide. |
New to SmartHopper? Start here
- Install SmartHopper — install from the Rhino Package Manager, Food4Rhino, or GitHub Releases.
- Set up an AI provider — connect OpenAI, Anthropic, Google Gemini, MistralAI, DeepSeek, or OpenRouter, or run locally for free with Ollama or LocalAI.
- Choose your default provider and model — set a global default or override it per component.
- Run your first AI workflow — wire your first Input → Output components and open the canvas assistant.
Common workflows
Working with the assistant and canvas
- Chat with the Canvas Assistant and review proposed canvas edits
- Let AI build, wire, and tidy your canvas
- Generate, edit, and review Python or C# scripts
- Work with GhJSON and GhPatch files
Working with components, data, and external tools
- Browse the Component Library — Input and Output components
- Search the McNeel and Ladybug forums
- Convert PDFs, Office files, and web pages to Markdown
- Connect Claude Desktop, Cursor, or VS Code over MCP
Need help?
- Check Troubleshooting and the FAQ for quick answers to common setup questions.
- Ask questions and share workflows in the SmartHopper category on the McNeel Discourse forum.
- Report bugs or request features on GitHub Issues.