Dapr Vector .NET SDK on Dapr Docs

How to: Store and query vectors with the Dapr .NET SDK

Mon, 01 Jan 0001 00:00:00 +0000

Use DaprVectorClient to store precomputed embeddings and retrieve similar records through a Dapr vector component. This guide uses three-dimensional vectors for readability; real embeddings must match your model’s dimensions.

Prerequisites

Dapr CLI and an initialized Dapr environment
.NET 8, .NET 9, .NET 10, or .NET 11
Dapr runtime 1.19 or later with Vector support
The Dapr.Vector NuGet package, version 1.19.0 or later

.NET framework support

Be advised that .NET 8 and .NET 9 reach end of support in November 2026. Support for both will be dropped in Dapr v1.20; only .NET 10 and .NET 11 will be supported through the end of 2027.

Install the package in an ASP.NET Core project:

Dapr Vector client

Mon, 01 Jan 0001 00:00:00 +0000

DaprVectorClient in Dapr.Vector implements the alpha Vector API through gRPC. Use .NET SDK 1.19.0 or later with a Dapr runtime and component that support Vector. See the overview for release requirements and the how-to for a complete collection lifecycle.

Client lifetime and configuration

Reuse a long-lived client. Dependency injection registers a singleton by default and disposes it when the container is disposed:

using Dapr.Vector.Extensions;

builder.Services.AddDaprVectorClient((serviceProvider, clientBuilder) =>
{
 clientBuilder.UseGrpcEndpoint("http://localhost:50001");
});

The callback can resolve configuration or other services through serviceProvider. The optional lifetime argument supports other ServiceLifetime values.