Skip to main content

AI Providers

SmartHopper works with the providers you already use — or none at all. Cloud providers need an API key; Ollama and LocalAI run free and private on your own machine.

Supported providers​

ProviderTypeNeeds
OpenAICloudAPI key
AnthropicCloudAPI key
Google GeminiCloudAPI key
MistralAICloudAPI key
DeepSeekCloudAPI key
OpenRouterCloudAPI key (multi-model gateway)
OllamaLocalLocal server, no key
LocalAILocalLocal server, no key

The general setup flow​

Every provider follows the same pattern:

  1. Get credentials — an API key from the provider's console, or a running local server for Ollama/LocalAI.
  2. Open SmartHopper → Settings in Grasshopper.
  3. Click the provider's tile on the General tab and paste the key or set the endpoint.
  4. Pick your defaults — set the default provider on the General tab, and optionally a default model per provider.
  5. Start using it — components set to Default provider use your choice; any AI component can override it via right-click → Select AI Provider.

Setting up a provider in SmartHopper Settings

Security note

API keys are encrypted using your OS secure store (DPAPI on Windows, Keychain on macOS) and stored only on your machine. Never share your keys.

Watch it

The Select an AI Provider video shows this flow on the canvas.

Choosing a provider and model​

Each provider has different strengths across reasoning, tool calling, vision, image generation, speech, context window size, and batch processing. Drop the AI Models component (SmartHopper → A. AI) onto your canvas to list the models available from any provider, or ask the assistant "Which models on my providers support image generation?" (it uses the providers_list and providers_models tools automatically).