Meridian.Models 1.0.0

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package Meridian.Models --version 1.0.0
                    


                    

                
NuGet\Install-Package Meridian.Models -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Meridian.Models" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Meridian.Models" Version="1.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Meridian.Models" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Meridian.Models --version 1.0.0
                    


                    

                
#r "nuget: Meridian.Models, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Meridian.Models@1.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Meridian.Models&version=1.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Meridian.Models&version=1.0.0
                    


                            Install as a Cake Tool

Meridian.Models

Independent open-source project; not affiliated with or endorsed by Microsoft.

Multi-provider chat, embedding, and image model clients for .NET — one strongly-typed ModelOptions configuration, the same IChatClient/IEmbeddingGenerator/IImageGenerator surface from Microsoft.Extensions.AI regardless of which provider is behind it, with opt-in fallback, retry, and OpenTelemetry.

Part of Meridian — an opinionated .NET 10 AI framework built on the Microsoft Agent Framework, reachable from modern .NET apps directly and from COM-based applications (VB6, Visual FoxPro, Delphi, VBA) through a COM Callable Wrapper.

Supported providers

Provider Chat Embeddings Images Notes
Azure OpenAI ✅ ✅ ✅ API key or Azure AD (UseAzureAD)
OpenAI ✅ ✅ ✅
Anthropic (Claude) ✅ — — OpenAI-compatible endpoint; pair with another provider for embeddings
Google Gemini ✅ ✅ — OpenAI-compatible endpoint
Perplexity (sonar) ✅ — — OpenAI-compatible endpoint
Azure AI Inference (Foundry) ✅ ✅ —

Switch providers — or add an ordered list of fallback providers — by changing ModelOptions; no code elsewhere in your application changes.

Install

dotnet add package Meridian.Models

Example

using Meridian.Models.Providers;

services.AddSingleton(new ModelOptions {
    DefaultProvider = ModelProvider.OpenAI,
    FallbackProviders = { ModelProvider.Anthropic },
    OpenAI = { ApiKey = "sk-..." },
    Anthropic = { ApiKey = "sk-ant-..." },
    Pipeline = { EnableRetry = true, EnableOpenTelemetry = true }
});

services.AddSingleton<IChatClient>(sp => {
    var options = sp.GetRequiredService<ModelOptions>();
    var (chat, _) = ModelClientBuilder.BuildChatWithFallback(options);
    return ModelClientBuilder.ApplyChatPipeline(chat, options, sp);
});

Most applications won't call ModelClientBuilder directly — reference Meridian.Hosting instead, and configure everything through services.AddMeridian(options => options.AddModel(...)), which wires this up for you alongside embeddings, retrieval, agents, and memory.

What each piece does

Type Role
ModelOptions Per-provider connection/model settings, default + fallback provider selection, opt-in pipeline (logging, caching, retry, OpenTelemetry)
ModelClientBuilder Builds the IChatClient for the configured default provider, with automatic fallback through FallbackProviders in order
IModelClientResolver / ModelClientResolver Resolves a specific named provider's clients on demand (used internally by embeddings/images/agents to pick a provider independent of the chat default)
FallbackChatClient The IChatClient decorator that implements the try-next-provider-on-failure behavior
RetryChatClient The IChatClient decorator implementing Pipeline.EnableRetry's exponential backoff

Full documentation

See the Meridian repository for the complete framework — hybrid RAG, long-term agent memory, image generation, and the COM bridge for VB6/Visual FoxPro/Delphi/VBA.

License

MIT © Angel Hernandez

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Meridian.Models:

Package Downloads
Meridian.Knowledge

Embeddings, a pluggable semantic store, and retrieval (RAG) built on top of Meridian.Models.
Meridian.Agents

Agent construction, tools, memory and sequential/parallel workflows, built on the Microsoft Agent Framework (MAF).
Meridian.Hosting

The services.AddMeridian(...) front door: wires Models, Knowledge, Agents and Observability into an IServiceCollection with one opinionated, fluent builder.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0 103 10/13/2026