Skip to main content

Frequently Asked Questions

Which AI provider should I start with?​

Use whichever provider you already have an account or API key for. If you plan to use the Canvas Assistant or canvas-editing tools, pick a model with strong tool calling support. If you want a completely free, offline setup, install Ollama or LocalAI to run models locally on your own computer.

Does SmartHopper send my Rhino geometry or Grasshopper files anywhere?​

Only the data you explicitly send in an AI component or assistant conversation is transmitted to the AI provider you selected. Nothing is sent in the background — see Security & Privacy.

Can the AI accidentally overwrite or break my definition?​

No. Every action that changes your canvas goes through the canvas change review dialog, where you can inspect and check or uncheck individual changes before anything is applied. Once applied, every edit is a standard Grasshopper undo record (Ctrl+Z).

How do I check how many tokens or how much cost a component used?​

Every AI-powered component has a Metrics (M) output that emits per-branch JSON usage data. Wire it into Deconstruct SmartHopper Metrics (SmartHopper → A. AI) to inspect input tokens, output tokens, completion time, model, and estimated cost, or Combine SmartHopper Metrics to sum usage across branches — see Metrics components.

How do I choose a specific model for one component?​

Right-click the component → Select AI Provider to pick its provider, and wire a Settings component (or a plain text Panel with the model name) into its Settings (S) input. Use the AI Models component (SmartHopper → A. AI) to see all model names a provider offers.

Can I point Ollama or LocalAI to another machine on my network?​

Yes. Open SmartHopper → Settings, switch to the Ollama or LocalAI tab, and set the server URL to your machine's address.

Is SmartHopper free?​

SmartHopper itself is free, open-source software licensed under the LGPL v3. When you use cloud AI providers, you pay that provider directly for your API usage. Running local models with Ollama or LocalAI is completely free.

What are GhJSON and GhPatch?​

GhJSON (.ghjson) is an open, human-readable JSON format for Grasshopper definitions, and GhPatch (.ghpatch) is its companion format for diffs and partial edits. Learn how they work in Work with GhJSON.

Where should I ask questions or report a bug?​