@mastra/astra NPM

@mastra/astra

Vector store implementation for DataStax Astra DB, providing vector similarity search capabilities using Cassandra's vector search functionality.

Installation

npm install @mastra/astra

Usage

import { AstraVector } from '@mastra/astra';

const vectorStore = new AstraVector({
  token: 'your-astra-token',
  endpoint: 'your-astra-endpoint',
  keyspace: 'your-keyspace' // optional
});

// Create a new collection
await vectorStore.createIndex({ indexName: 'myCollection', dimension: 1536, metric: 'cosine' });

// Add vectors
const vectors = [[0.1, 0.2, ...], [0.3, 0.4, ...]];
const metadata = [{ text: 'doc1' }, { text: 'doc2' }];
const ids = await vectorStore.upsert({ indexName: 'myCollection', vectors, metadata });

// Query vectors
const results = await vectorStore.query({
  indexName: 'myCollection',
  queryVector: [0.1, 0.2, ...],
  topK: 10, // topK
  filter: { text: { $eq: 'doc1' } }, // optional filter
  includeVector: false // includeVectors
});

Configuration

The Astra DB vector store requires:

token: Your Astra DB token
endpoint: Your Astra DB endpoint
keyspace: (Optional) The keyspace to use

Features

Vector similarity search with cosine, euclidean, and dot product metrics
Metadata filtering support
Batch vector upsert operations
Collection management (create, list, describe, delete)
Optional vector inclusion in query results
Automatic UUID generation for vectors
Built on top of @datastax/astra-db-ts client

Methods

createIndex({ indexName, dimension, metric? }): Create a new collection
upsert({ indexName, vectors, metadata?, ids }): Add or update vectors
query({ indexName, queryVector, topK?, filter?, includeVector? }): Search for similar vectors
listIndexes(): List all collections
describeIndex(indexName): Get collection statistics
deleteIndex(indexName): Delete a collection

Related Links

@datastax/astra-db-ts

0.10.2

6 months ago

0.10.2-alpha.0

6 months ago

0.10.1

6 months ago

0.0.0-taofeeqInngest-20250603090617

6 months ago

0.0.0-vnextAgentNetwork-20250602134426

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

0.0.0-add-runtime-context-to-openai-realtime-20250516201052

7 months ago

0.0.0-vector-sources-20250516175436

7 months ago

0.0.0-vector-query-sources-20250516172905

7 months ago

0.2.15

7 months ago

0.2.15-alpha.4

7 months ago

0.2.15-alpha.3

7 months ago

0.0.0-cloud-transporter-20250513033346

7 months ago

0.0.0-generate-message-id-20250512171942

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

0.0.0-redis-cloud-transporter-20250508203756

7 months ago

0.0.0-redis-cloud-transporter-20250508194049

7 months ago

0.2.14-alpha.1

7 months ago

0.0.0-redis-cloud-transporter-20250508191651

7 months ago

0.0.0-vnext-inngest-20250508131921

7 months ago

0.0.0-vnext-inngest-20250508122351

7 months ago

0.0.0-vnext-inngest-20250508121018

7 months ago

0.0.0-vnext-inngest-20250508111904

7 months ago

0.0.0-vnext-inngest-20250508110322

7 months ago

0.0.0-mastra-2452-core-tracing-sentry-20250507205331

7 months ago

0.0.0-mastra-3338-mastra-memory-pinecone-20250507174328

7 months ago

0.2.14-alpha.0

7 months ago

0.0.0-mcp-server-deploy-20250507160341

7 months ago

0.0.0-vnext-inngest-20250507093737

7 months ago

0.2.13

7 months ago

0.2.13-alpha.6

7 months ago

0.0.0-trigger-playground-ui-package-20250506151043

7 months ago

0.0.0-vnext-inngest-20250506132005

7 months ago

0.0.0-vnext-inngest-20250506123700

7 months ago

0.0.0-vnext-inngest-20250506121901

7 months ago

0.0.0-fix-message-embedding-20250506021742

7 months ago

0.2.13-alpha.5

7 months ago

0.2.13-alpha.4

7 months ago

0.0.0-expose-more-playground-ui-20250502141824

7 months ago

0.2.13-alpha.3

7 months ago

0.0.0-expose-more-playground-ui-20250502050852

7 months ago

0.0.0-agui-20250501191909

7 months ago

0.0.0-agui-20250501182100

7 months ago

0.0.0-expose-more-playground-ui-20250501175749

7 months ago

0.0.0-separate-trace-data-from-component-20250501141108

7 months ago

0.0.0-separate-trace-data-from-component-20250501042644

7 months ago

0.0.0-mcp-schema-serializer-20250430202337

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

0.0.0-pg-pool-options-20250428183821

7 months ago

0.2.12-alpha.2

7 months ago

0.0.0-remove-cloud-span-transform-20250425214156

7 months ago

0.2.12-alpha.1

7 months ago

0.0.0-switch-to-core-20250424015131

7 months ago

0.0.0-llamaindex-switch-core-20250424001624

7 months ago

0.0.0-bundle-dynamic-imports-20250424001248

7 months ago

0.0.0-mastra-3171-llamaindex-pin-20250423175211

7 months ago

0.2.12-alpha.0

7 months ago

0.2.11

7 months ago

0.2.11-alpha.8

7 months ago

0.0.0-vnextWorkflows-20250422142014

7 months ago

0.0.0-vnextWorkflows-20250422081019

7 months ago

0.0.0-a2a-20250421213654

7 months ago

0.0.0-mcp-server-update-parse-20250421171139

7 months ago

0.0.0-mcp-server-update-20250421162713

7 months ago

0.0.0-vnextWorkflows-20250421125930

7 months ago

0.0.0-vnextWorkflows-20250421113058

7 months ago

0.0.0-vnextWorkflows-20250421062111

7 months ago

0.0.0-vnextWorkflows-20250421054100

7 months ago

0.0.0-mastra-3123-mcp-server-20250419180157

7 months ago

0.2.11-alpha.7

7 months ago

0.2.11-alpha.6

7 months ago

0.0.0-extend-clickhouse-20250418135620

7 months ago

0.2.11-alpha.5

7 months ago

0.2.11-alpha.4

8 months ago

0.0.0-vnextWorkflows-20250417075051

8 months ago

0.2.11-alpha.3

8 months ago

0.0.0-revert-schema-20250416221206

8 months ago

0.2.11-alpha.2

8 months ago

0.0.0-llamaindex-extract-20250416163822

8 months ago

0.0.0-vnextWorkflows-20250416071310

8 months ago

0.0.0-remove-tiktoken-20250415231938

8 months ago

0.2.11-alpha.1

8 months ago

0.0.0-message-ordering-20250415215612

8 months ago

0.2.10

8 months ago

0.2.10-alpha.5

8 months ago

0.0.0-afterToolExecute-20250415041527

8 months ago

0.0.0-afterToolExecute-20250414225911

8 months ago

0.2.10-alpha.4

8 months ago

0.0.0-commonjs-20250414101718

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

0.0.0-default-storage-virtual-file-20250410035748

8 months ago

0.0.0-fix-memory-xxhash-20250409202110

8 months ago

0.2.9

8 months ago

0.0.0-mastra-2973-fast-mcp-removal-20250409163028

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

0.0.0-commonjs-20250227130920

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

0.0.0-storage-20250225005900

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago