How to: Store and query vectors with the Dapr JavaScript SDK

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

Use DaprClient.vector to store precomputed embeddings and find similar records through a Dapr vector store component. This guide covers collection configuration, upserts, retrieval, similarity queries, batch queries, and deletes.

Prerequisites

Dapr CLI
An initialized Dapr environment with a Vector-capable runtime from the 1.19 release line or later
Node.js 18 or later
The @dapr/dapr package, version 3.19.0 or later
A configured vector store component, such as the in-memory component below

Runtime support

Use a Dapr runtime that includes the Vector API. Installing JavaScript SDK 3.19.0 alone does not enable runtime support for Vector.

In your application directory, initialize an npm project if you do not already have one, then install the SDK:

Vector client usage

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

Vector is available through DaprClient.vector in JavaScript SDK 3.19.0 or later. Both HTTP and gRPC use the alpha Vector API and require a Vector-capable Dapr runtime from the 1.19 release line or later. Installing the JavaScript SDK alone does not enable the Vector API.

Client lifetime and configuration

Reuse a long-lived DaprClient rather than creating a client for each operation. Await outstanding operations before calling await client.stop() during application shutdown.

Dapr Vector JavaScript SDK on Dapr Docs

How to: Store and query vectors with the Dapr JavaScript SDK

Prerequisites

Runtime support

Vector client usage

Client lifetime and configuration