0
Fork 0
mirror of https://github.com/mastra-ai/mastra.git synced 2026-11-17 08:44:46 +00:00
mastra/stores/chroma
mastra-platform[bot] e02c876685
docs: point store READMEs at the new integrations vector pages (#28970)
Co-authored-by: LekoArts <lekoarts@gmail.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: LekoArts <16143594+LekoArts@users.noreply.github.com>
History 2026-10-30 11:31:23 +01:00
..
src fix(chroma): return per-metric similarity score from query() (#18350) 2026-06-23 14:10:51 +02:00
CHANGELOG.md chore: version - exit prerelease mode 2026-10-28 13:15:52 +00:00
docker-compose.yaml chore(deps): update docker images (#17149) 2026-06-11 20:11:07 +02:00
lint-staged.config.js refactor(lint): replace ESLint with type-aware oxlint (#27476) 2026-10-18 10:38:35 -07:00
package.json chore: version - exit prerelease mode 2026-10-28 13:15:52 +00:00
README.md docs: point store READMEs at the new integrations vector pages (#28970) 2026-10-30 11:31:23 +01:00
tsconfig.build.json chore: fix go-to-definition using tsc declaration maps (#6089) 2025-07-30 15:41:00 -07:00
tsconfig.json chore: migrate package builds to tsdown (#19829) 2026-07-28 12:32:21 +02:00
tsdown.config.ts chore: migrate package builds to tsdown (#19829) 2026-07-28 12:32:21 +02:00
turbo.json chore: migrate package builds to tsdown (#19829) 2026-07-28 12:32:21 +02:00
vitest.config.ts refactor: reorganize core tests and namespace vitest projects across monorepo (#12662) 2026-02-09 10:24:48 +01:00

@mastra/chroma

Vector store implementation for Chroma using the official chromadb client with added dimension validation, collection management, and document storage capabilities.

Installation

npm install @mastra/chroma

Usage

import { ChromaVector } from '@mastra/chroma';

const vectorStore = new ChromaVector({ id: 'chroma-vectors' });

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

// Add vectors with documents
const vectors = [
  [0.1, 0.2, 0.3],
  [0.3, 0.4, 0.5],
];
const metadata = [{ text: 'doc1' }, { text: 'doc2' }];
const documents = ['full text 1', 'full text 2'];
const ids = await vectorStore.upsert({
  indexName: 'myCollection',
  vectors,
  metadata,
  documents, // store original text
});

// Query vectors with document filtering
const results = await vectorStore.query({
  indexName: 'myCollection',
  queryVector: [0.1, 0.2, 0.3],
  topK: 10, // topK
  filter: { text: { $eq: 'doc1' } }, // metadata filter
  includeVector: false, // includeVector
  documentFilter: { $contains: 'specific text' }, // document content filter
});

Documentation

Changelog

See the package changelog for version history and release notes.

Support

We have an open community Discord. Come and say hello and let us know if you have any questions or need any help getting things running.