AIRouter.Core 0.0.1

AIRouter

AIRouter is a library-first AI provider router for .NET 10. Use it directly from any .NET application, optionally expose an OpenAI-compatible /v1 API from your own ASP.NET Core host, or run the ready-made AiRouter.Server gateway/container.

Packages

There are exactly two public NuGet packages.

AIRouter.Core

Use AIRouter.Core in console apps, workers, Windows services, desktop apps, MCP servers, or any other .NET project. Core includes provider management, built-in OpenAI-compatible upstream providers, fallback and round-robin routing, Responses support, streaming, health/cooldown behavior, and in-memory provider/route stores.

<PackageReference Include="AIRouter.Core" Version="0.1.0" />

var services = new ServiceCollection();
services.AddAiRouter();

await using var serviceProvider = services.BuildServiceProvider();
var providers = serviceProvider.GetRequiredService<IProviderManager>();
var router = serviceProvider.GetRequiredService<IAiRouter>();

SQLite is not required. Applications can keep the default in-memory stores or replace IProviderStore and IRouteStore with their own persistence.

AIRouter.AspNetCore

Add AIRouter.AspNetCore when your application should expose the OpenAI-compatible API. It depends on AIRouter.Core and only adds ASP.NET Core hosting integration.

<PackageReference Include="AIRouter.AspNetCore" Version="0.1.0" />

builder.Services
    .AddAiRouter()
    .AddAiRouterAspNetCore();

var app = builder.Build();
app.MapAiRouterOpenAiEndpoints();

This maps:

• POST /v1/chat/completions
• POST /v1/responses
• GET /v1/models

See docs/library-usage.md for provider, route, custom-host, and streaming examples.

Optional standalone server

AiRouter.Server is optional. It composes Core, ASP.NET hosting, and internal SQLite persistence into a ready-made gateway. Applications embedding AIRouter should depend on the NuGet packages instead of the server project.

The release container is available from GHCR:

docker run --rm \
  -p 8080:8080 \
  -v ai-router-data:/data \
  ghcr.io/dhhieu113pro/ai-router:latest

The server exposes /health and the OpenAI-compatible /v1 routes. By default SQLite is stored at /data/ai-router.db.

Optional server keys:

AIROUTER_API_KEY    Protects /v1 routes when configured
AIROUTER_ADMIN_KEY  Enables and protects management routes when configured

Releases

Push a semantic-version tag such as v0.1.0 from a commit contained in main.

The dedicated release workflow then:

1. restores, builds, and tests the solution,
2. packs and smoke-tests AIRouter.Core and AIRouter.AspNetCore,
3. publishes both packages to NuGet.org through trusted publishing,
4. publishes linux/amd64 and linux/arm64 server images to GHCR as 0.1.0, 0.1, and latest.

NuGet.org trusted publishers for both package IDs must target repository dhhieu113pro/ai-router, workflow .github/workflows/release.yml, and GitHub environment production. No long-lived NuGet API-key repository secret is required.

License

MIT