Skip to content

architects-toolkit/SmartHopper

Repository files navigation

SmartHopper - AI-Powered Tools and Assistant for Grasshopper3D

Version Status .NET CI Ready to use License Ask DeepWiki

SmartHopper

Design with AI directly on your Grasshopper canvas — chat, code, organize, and build smarter definitions faster.


SmartHopper brings a context‑aware AI assistant and a suite of AI‑powered components into Grasshopper3D.

  • 💬 Canvas assistant An on‑canvas AI chat truly aware of your components and connected to the McNeel forum for real answers.

  • 📝 Script generator Get help creating, editing and fixing Script components in Python, IronPython, C#, and VB.NET.

  • 🔧 AI‑powered components Use Grasshopper in a way that was impossible before AI — generate text, generate and sort lists based on prompt, create images, convert files to Markdown, and more.

  • 🤝 Multiple compatible providers (check the full provider feature matrix for details)

  • Open Source — and it will always be.

💻 Installation

Install, enable a provider, and set up an API key.

System requirements:

  • Rhino 8.0 or newer on Windows or macOS
  • Distributed through the Rhino Package Manager
  • You need to have a provider API key to use most of SmartHopper features

Quickstart ▶

View the video on Vimeo

🚀 How to use

Canvas assistant (AI chat)

Start a chat, ask for help, search the McNeel forum, or talk about life.

Canvas Assistant ▶

View the video on Vimeo

Generate and Edit Script Components

Create powerful scripts in seconds. Let AI write, review, and refine your code following your instructions.

Generate and Edit Script Components ▶

View the video on Vimeo

AI-powered components

Do things that were impossible before.

AI Components ▶

View the video on Vimeo

Choose a default provider, or specify a provider for each component.

Select AI provider ▶

View the video on Vimeo

More examples and recipes coming soon on the website and docs.

Developer details (AI tools, providers, data types, status) can be found in DEV.md.

🤝 Contributing

Every great innovation starts with a single contribution. Whether you're a designer, developer, or AI enthusiast, your unique perspective can help shape the future of computational design tools.

Please see our Contributing Guidelines for details on how to contribute to this project.

📝 Changelog

See Releases for a list of changes and updates.

⚖️ License

This project is licensed under the GNU Lesser General Public License v3 (LGPL) - see the LICENSE file for details.

™️ Trademark and Logo Usage Policy

The SmartHopper name and logo are the property of the SmartHopper / architects-toolkit maintainers. The LGPL v3 license under which the source code is distributed does not grant rights in the SmartHopper name or logo.

We allow use of the SmartHopper name and logo in the following contexts:

  • In blog posts, articles, tutorials, talks, or reviews that discuss or promote SmartHopper, provided the usage is accurate, fair, and does not imply endorsement by the SmartHopper maintainers.
  • In educational materials, courses, or presentations that accurately represent the project.
  • When referring to the unmodified, official SmartHopper plug-in as installed from the Rhino Package Manager.

Please refrain from using the SmartHopper name and logo:

  • In promotional materials for paid services or commercial products that bundle, redistribute, or extend SmartHopper, without prior written permission.
  • In a manner that may cause confusion about the origin of a product or imply endorsement.
  • On forks, derivative works, or paid offerings derived from the SmartHopper source code — please choose a distinct name and logo for your fork, as is common open-source trademark practice.

If you have any questions or wish to seek permission for other uses, please open an issue on this repository or contact the maintainers via smarthopper.xyz.

Thank you for your understanding and cooperation.


Started in Barcelona — spread worldwide • smarthopper.xyz

About

SmartHopper is an open-source project that implements third-party AI APIs to provide advanced features for Grasshopper3D.

Topics

Resources

License

Contributing

Stars

26 stars

Watchers

0 watching

Forks

Contributors

Languages