Skip to main content

Troubleshooting

Common issues and how to fix them.

SmartHopper doesn't appear in Grasshopper​

  1. Rhino version — SmartHopper requires Rhino 8+. Check Help → About.
  2. Blocked files (Windows) — manually downloaded DLLs may be blocked: right-click each file in the components folder → Properties → Unblock.
  3. Gatekeeper (macOS) — run xattr -dr com.apple.quarantine on the components folder.
  4. Components folder — verify files landed in Grasshopper → File → Special Folders → Components Folder.
  5. Restart Rhino after any change.

A provider doesn't show up / is disabled​

  • Trust prompt declined — re-enable it under Settings → Security (trusted providers list).
  • Integrity check failed — run SmartHopper → Verify Providers; a tampered/invalid provider is refused in Strict mode (switch to Soft if you trust the file).
  • Just copied a new provider — use SmartHopper → Refresh Providers.

API calls fail​

SymptomLikely cause
401/auth errorsWrong/expired API key — re-enter it in the provider tab.
429/quota errorsNo credit — check the provider's billing console.
TimeoutsIncrease Timeout via AI Settings; check network/proxy.
"capability" errorsThe model lacks what you need (vision, tools, image gen) — check with AIModels.
Payload too largeBig file/web/canvas inputs — use GhGet filters, summarize first, or pick a bigger-context model.

Assistant isn't using tools / gives plain answers​

The model doesn't support (reliable) tool calling — pick a tool-capable model in Settings → Assistant. Local models vary; check capabilities first.

Component stays orange / red with a warning bubble​

Hover the bubble — it's the runtime message. Common ones: community-provider warning (expected if you use community providers), missing input, provider not configured.

Where are the logs?​

Log files roll per-day in the Grasshopper profile folder and are kept per your retention setting. Enable Live output (Settings) to echo them to the Rhino command line. In debug builds, SmartHopper → Diagnostics opens the log folder directly.

Still stuck? Ask on the McNeel forum or file a GitHub issue — attach a log excerpt with secrets removed.