Skip to main content

Quick Start

Go from a fresh install to your first AI component and assistant conversation in about five minutes.

Prefer video?

Watch the recorded walkthrough of this guide: SmartHopper Quickstart.

1. Configure an AI provider​

  1. In Grasshopper, open SmartHopper → Settings from the top menu bar.
  2. Click your provider's tile on the General tab (for example, OpenAI, Anthropic, or MistralAI) and paste your API key — or point Ollama / LocalAI to your local server URL.
  3. On the General tab, choose your provider under Default AI provider.

SmartHopper settings

Step-by-step setup guides for every supported provider live in AI Providers.

2. Run your first AI component​

SmartHopper components use a simple Input → Output pattern: an Input component packages your data, and an Output component calls the AI and returns a typed Grasshopper value.

  1. Drop Text to AI (SmartHopper → B. Input) and AI to Text (SmartHopper → C. Output) onto the canvas.
  2. Wire a Panel with your prompt into Text to AI, then wire its Input > output into AI to Text.
  3. Wire a Button or Boolean Toggle (True) into AI to Text's Run? (R) input.

A minimal Text to AI to AI to Text pipeline

The AI's answer comes out of the Text (T) output as a regular Grasshopper string, while token counts and timing are emitted on Metrics (M).

Override the provider on any component

Right-click AI to Text → Select AI Provider to pin that single component to a specific provider while leaving the rest of your file on the global default.

3. Chat with the Canvas Assistant​

Click the SmartHopper button on the Grasshopper canvas toolbar to open the conversational assistant. It can inspect the components on your canvas, answer Grasshopper questions, search the McNeel forum, write scripts, and propose canvas changes that you review before they apply.

Canvas button

Learn more in Canvas Assistant.

What to try next​