Repo brief: chroma-core/chroma

Generated by RepoPilot · document generated 2026-09-17 · concise human review Evidence snapshot · analyzed 2026-09-17T03:50:23.531Z · commit 34f8e76bae61

Verdict

Healthy — Strong maintenance signals

• Last commit today
• 9 active contributors
• Distributed ownership (top contributor 41% of recent commits)
• Apache-2.0 licensed
• 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

Chroma is an open-source vector database and search infrastructure for AI applications, providing semantic search across documents, embeddings, and hybrid full-text search. It offers a unified API for storing, indexing, and querying high-dimensional embeddings with automatic tokenization and embedding generation, accessible both as an in-memory Python client and via a client-server architecture with persistence. Monorepo structure: chromadb/ contains the Python client API (chromadb/api/ with client.py, async_client.py, fastapi.py for server mode); rust/ houses 28 workspace crates including the core index/, storage/, and distance modules; bin/ contains CI/test orchestration scripts…

Start here

Read these in order:

• chromadb/config.py — Foundation: doesn't import anything internally and is imported by 77 other files. Read first to learn the vocabulary.
• chromadb/errors.py — Foundation: imported by 30, no internal dependencies of its own.
• chromadb/telemetry/opentelemetry/__init__.py — Built on the foundation; imported by 22 downstream files.
• chromadb/auth/__init__.py — Built on the foundation; imported by 16 downstream files.
• chromadb/utils/embedding_functions/schemas/__init__.py — Layer 2 — composes lower-level code into reusable abstractions (imported 29×).

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/chroma-core/chroma.git
cd chroma
# For Python development:
pip install -e .
# For Rust development (requires Rust toolchain):
cargo build --workspace
# For running tests:
python bin/test.py
# For server mode:
chroma run --path /chroma_db_path

Daily commands:

Python in-memory (dev prototyping):

import chromadb
client = chromadb.Client()
collection = client.create_collection("test")
collection.add(documents=["doc1"], ids=["1"])
results = collection.query(query_texts=["search"], n_results=2)

Server mode:

…shortened for this brief.

Key cautions & unknowns

• 1. Rust compilation required for Python install: pip install -e . compiles Rust bindings (rust/python_bindings/) via Cargo—requires Rust toolchain, not just Python. 2. Storage backend must be configured:…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.