Skip to main content

Providers: SmartHopper.ProviderSdk & SmartHopper.Providers.*

SmartHopper.ProviderSdk​

The contract assembly every provider implements against: IAIProvider, the AIProvider template base, IAIProviderFactory, IAIProviderSettings, SettingDescriptors, hosting interfaces, and the shared logging API. Providers depend only on this SDK plus SmartHopper.Infrastructure contracts — never on Grasshopper.

SmartHopper.ProviderSdk.Tests runs without a strong-name key (-p:SignAssembly=false).

Provider plugins​

One project per service — discovered at runtime, cryptographically verified, then registered:

ProjectServiceAuth
SmartHopper.Providers.OpenAIOpenAIAPI key
SmartHopper.Providers.AnthropicAnthropicAPI key
SmartHopper.Providers.GeminiGoogle GeminiAPI key
SmartHopper.Providers.MistralAIMistralAIAPI key
SmartHopper.Providers.DeepSeekDeepSeekAPI key
SmartHopper.Providers.OpenRouterOpenRouterAPI key
SmartHopper.Providers.OllamaOllamaLocal endpoint
SmartHopper.Providers.LocalAILocalAILocal endpoint

Anatomy of a provider​

SmartHopper.Providers.Example/
├── ExampleProvider.cs — name, endpoints, PreCall/Call/PostCall overrides
├── ExampleProviderModels.cs — model list + capability registry
├── ExampleProviderSettings.cs — SettingDescriptors (API key, endpoint, options)
└── ExampleProviderFactory.cs — how ProviderManager instantiates it

Provider-owned concerns: API request/response formats, auth headers, streaming adaptation, tool-call wrapping, batch APIs, model capability declarations.

User-facing setup walkthroughs: AI Providers. Developer guide: AI Providers dev docs.