freshcrate
Skin:/
Home > Databases > chroma

chroma

Data infrastructure for AI

Why this rank:Strong adoptionRelease freshnessHealthy release cadence

Description

Data infrastructure for AI

README

Chroma Chroma

Chroma - the open-source data infrastructure for AI.

Discord | License | Docs | Homepage

pip install chromadb # python client
# for javascript, npm install chromadb!
# for client-server mode, chroma run --path /chroma_db_path

Chroma Cloud

Our hosted service, Chroma Cloud, powers serverless vector, hybrid, and full-text search. It's extremely fast, cost-effective, scalable and painless. Create a DB and try it out in under 30 seconds with $5 of free credits.

Get started with Chroma Cloud

API

The core API is only 4 functions (run our 💡 Google Colab):

import chromadb
# setup Chroma in-memory, for easy prototyping. Can add persistence easily!
client = chromadb.Client()

# Create collection. get_collection, get_or_create_collection, delete_collection also available!
collection = client.create_collection("all-my-documents")

# Add docs to the collection. Can also update and delete. Row-based API coming soon!
collection.add(
    documents=["This is document1", "This is document2"], # we handle tokenization, embedding, and indexing automatically. You can skip that and add your own embeddings as well
    metadatas=[{"source": "notion"}, {"source": "google-docs"}], # filter on these!
    ids=["doc1", "doc2"], # unique for each doc
)

# Query/search 2 most similar results. You can also .get by id
results = collection.query(
    query_texts=["This is a query document"],
    n_results=2,
    # where={"metadata_field": "is_equal_to_this"}, # optional filter
    # where_document={"$contains":"search_string"}  # optional filter
)

Learn about all features on our Docs

Get involved

Chroma is a rapidly developing project. We welcome PR contributors and ideas for how to improve the project.

Release Cadence We currently release new tagged versions of the pypi and npm packages on Mondays. Hotfixes go out at any time during the week.

License

Apache 2.0

Release History

VersionChangesUrgencyDate
1.5.9Version: `1.5.9` Git ref: `refs/tags/1.5.9` Build Date: `2026-05-05T05:55` PIP Package: `chroma-1.5.9.tar.gz` Github Container Registry Image: `:1.5.9` DockerHub Image: `:1.5.9` ## What's Changed * [ENH](frontend): block functions on topology dbs by @rescrv in https://github.com/chroma-core/chroma/pull/6836 * [ENH](faults): Add Tilt fault injection CLI by @rescrv in https://github.com/chroma-core/chroma/pull/6881 * [CHORE] Debug TimeoutError in test_add.py by @rescrv in https://github.com/chroHigh5/5/2026
1.5.8Version: `1.5.8` Git ref: `refs/tags/1.5.8` Build Date: `2026-04-16T23:35` PIP Package: `chroma-1.5.8.tar.gz` Github Container Registry Image: `:1.5.8` DockerHub Image: `:1.5.8` ## What's Changed * [ENH]: Make materialize_logs aware of sharding by @tanujnay112 in https://github.com/chroma-core/chroma/pull/6833 * [ENH]: retry per shard instead of every shard by @sanketkedia in https://github.com/chroma-core/chroma/pull/6841 * [ENH]: Integrate seal operator for sharded collections by @tanujnay112High4/16/2026
1.5.7Version: `1.5.7` Git ref: `refs/tags/1.5.7` Build Date: `2026-04-08T07:49` PIP Package: `chroma-1.5.7.tar.gz` Github Container Registry Image: `:1.5.7` DockerHub Image: `:1.5.7` ## What's Changed * [CHORE] Update Rust setup for CLI workflows by @itaismith in https://github.com/chroma-core/chroma/pull/6818 * [ENH] Add getCollectionById API across all client SDKs and server by @HammadB in https://github.com/chroma-core/chroma/pull/6805 * [ENH]: Pass down shard_index, num_shards and log_upper_bounHigh4/8/2026
cli-1.4.3CLI release.Medium4/8/2026
1.5.6Version: `1.5.6` Git ref: `refs/tags/1.5.6` Build Date: `2026-04-07T03:01` PIP Package: `chroma-1.5.6.tar.gz` Github Container Registry Image: `:1.5.6` DockerHub Image: `:1.5.6` ## What's Changed * [DOC] add concrete example for query/get response by @kylediaz in https://github.com/chroma-core/chroma/pull/6593 * [DOC] Make delete clearer by @kylediaz in https://github.com/chroma-core/chroma/pull/6596 * [DOC] Add multimodal example by @itaismith in https://github.com/chroma-core/chroma/pull/6622Medium4/7/2026
cli-1.4.2CLI release.Medium4/4/2026
1.5.5Version: `1.5.5` Git ref: `refs/tags/1.5.5` Build Date: `2026-03-10T09:30` PIP Package: `chroma-1.5.5.tar.gz` Github Container Registry Image: `:1.5.5` DockerHub Image: `:1.5.5` ## What's Changed * [RELEASE] Rust v0.13.2 by @HammadB in https://github.com/chroma-core/chroma/pull/6583 * [ENH] Use buffer_unordered for lazy fragment fetch concurrency by @rescrv in https://github.com/chroma-core/chroma/pull/6584 * [DOC] chroma configuration reference by @kylediaz in https://github.com/chroma-core/chLow3/10/2026
1.5.3Version: `1.5.3` Git ref: `refs/tags/1.5.3` Build Date: `2026-03-07T19:07` PIP Package: `chroma-1.5.3.tar.gz` Github Container Registry Image: `:1.5.3` DockerHub Image: `:1.5.3` ## What's Changed * [ENH] Thread topology name through purge-dirty pipeline by @rescrv in https://github.com/chroma-core/chroma/pull/6503 * [CHORE] Tighten down k8s resources in test. by @rescrv in https://github.com/chroma-core/chroma/pull/6509 * [ENH] Purge dirty via Spanner when topology is specified by @rescrv in hLow3/7/2026
1.5.2Version: `1.5.2` Git ref: `refs/tags/1.5.2` Build Date: `2026-02-27T19:50` PIP Package: `chroma-1.5.2.tar.gz` Github Container Registry Image: `:1.5.2` DockerHub Image: `:1.5.2` ## What's Changed * [CHORE] Remove unwraps in index by @HammadB in https://github.com/chroma-core/chroma/pull/6382 * [CHORE] Add tracing spans to RLS to debug hangs by @rescrv in https://github.com/chroma-core/chroma/pull/6384 * [DOC] Where Filter reference by @kylediaz in https://github.com/chroma-core/chroma/pull/6386Low2/27/2026
1.5.1Version: `1.5.1` Git ref: `refs/tags/1.5.1` Build Date: `2026-02-19T20:01` PIP Package: `chroma-1.5.1.tar.gz` Github Container Registry Image: `:1.5.1` DockerHub Image: `:1.5.1` ## What's Changed * [CHORE] Remove unwraps in index by @HammadB in https://github.com/chroma-core/chroma/pull/6382 * [CHORE] Add tracing spans to RLS to debug hangs by @rescrv in https://github.com/chroma-core/chroma/pull/6384 * [DOC] Where Filter reference by @kylediaz in https://github.com/chroma-core/chroma/pull/6386Low2/19/2026
cli-1.4.1CLI release.Low2/19/2026
1.5.0Version: `1.5.0` Git ref: `refs/tags/1.5.0` Build Date: `2026-02-09T08:47` PIP Package: `chroma-1.5.0.tar.gz` Github Container Registry Image: `:1.5.0` DockerHub Image: `:1.5.0` ## What's Changed * [ENH]: Create collection impl in rust sysdb by @sanketkedia in https://github.com/chroma-core/chroma/pull/6131 * [ENH] Export search options parameter by @gshahbazian in https://github.com/chroma-core/chroma/pull/6160 * [CHORE] Wire up `s3_*` metrics for object storage by @rescrv in https://github.cLow2/9/2026
cli-1.4.0CLI release.Low2/9/2026
1.4.1Version: `1.4.1` Git ref: `refs/tags/1.4.1` Build Date: `2026-01-14T19:19` PIP Package: `chroma-1.4.1.tar.gz` Github Container Registry Image: `:1.4.1` DockerHub Image: `:1.4.1` ## What's Changed * [ENH]: Sysdb + migration service connect to real spanner in gcp by @sanketkedia in https://github.com/chroma-core/chroma/pull/6084 * [CHORE]: Update google cloud spanner dependency + update rust version by @sanketkedia in https://github.com/chroma-core/chroma/pull/6086 * [CHORE]: Remove unstable featLow1/14/2026
cli-1.3.1CLI release.Low1/13/2026
1.4.0Version: `1.4.0` Git ref: `refs/tags/1.4.0` Build Date: `2025-12-24T02:59` PIP Package: `chroma-1.4.0.tar.gz` Github Container Registry Image: `:1.4.0` DockerHub Image: `:1.4.0` ## What's Changed * [DOC] Fix doc 500 by @kylediaz in https://github.com/chroma-core/chroma/pull/5966 * [DOC] Fix doc 500 due to tabs component by @kylediaz in https://github.com/chroma-core/chroma/pull/5989 * [DOC] Fix doc 404 due to path case sensitivity by @kylediaz in https://github.com/chroma-core/chroma/pull/5990 Low12/24/2025
cli-1.3.0CLI release.Low12/24/2025
cli-1.2.4CLI release.Low12/12/2025
1.3.6Version: `1.3.6` Git ref: `refs/tags/1.3.6` Build Date: `2025-12-10T05:26` PIP Package: `chroma-1.3.6.tar.gz` Github Container Registry Image: `:1.3.6` DockerHub Image: `:1.3.6` ## What's Changed * [ENH] Use GCS with aws-sdk-go-v2 by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/5878 * [ENH]: Refactor compactor into three chained orchestrators by @tanujnay112 in https://github.com/chroma-core/chroma/pull/5831 * [CHORE]: Disable S3heap service and remove nonce-related logic by @tanuLow12/10/2025
cli-1.2.3CLI release.Low12/10/2025
1.3.5Version: `1.3.5` Git ref: `refs/tags/1.3.5` Build Date: `2025-11-18T10:09` PIP Package: `chroma-1.3.5.tar.gz` Github Container Registry Image: `:1.3.5` DockerHub Image: `:1.3.5` ## What's Changed * [ENH]: Garbage collection for soft deleted attached functions by @tanujnay112 in https://github.com/chroma-core/chroma/pull/5774 * [BUG]: Don't log offset since records can be empty by @sanketkedia in https://github.com/chroma-core/chroma/pull/5812 * [TST]: fix Rust doc tests, add `cargo test --doc` Low11/18/2025
cli-1.2.2CLI release.Low11/18/2025
1.3.3Version: `1.3.3` Git ref: `refs/tags/1.3.3` Build Date: `2025-11-05T02:09` PIP Package: `chroma-1.3.3.tar.gz` Github Container Registry Image: `:1.3.3` DockerHub Image: `:1.3.3` ## What's Changed * [DOC]: web sync by @codetheweb in https://github.com/chroma-core/chroma/pull/5798 * [CHORE] Bump max concurrent streams for log service by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/5803 * [ENH] Add chroma_bm25 embedding function to python by @jairad26 in https://github.com/chroma-corLow11/5/2025
1.3.2Version: `1.3.2` Git ref: `refs/tags/1.3.2` Build Date: `2025-11-04T04:57` PIP Package: `chroma-1.3.2.tar.gz` Github Container Registry Image: `:1.3.2` DockerHub Image: `:1.3.2` ## What's Changed * [BUG]: Rebuild compaction job with empty logs by @sanketkedia in https://github.com/chroma-core/chroma/pull/5794 * [ENH] - Adds Qwen to list of js packages by @tjkrusinskichroma in https://github.com/chroma-core/chroma/pull/5796 * [BUG] fix sparse autoembed queries on search api by @jairad26 in httpsLow11/4/2025
cli-1.2.1CLI release.Low11/3/2025
cli-1.2.0CLI release.Low10/29/2025
1.3.0Version: `1.3.0` Git ref: `refs/tags/1.3.0` Build Date: `2025-10-29T03:08` PIP Package: `chroma-1.3.0.tar.gz` Github Container Registry Image: `:1.3.0` DockerHub Image: `:1.3.0` ## What's Changed * [ENH] - Adds rust client to list of clients by @tjkrusinskichroma in https://github.com/chroma-core/chroma/pull/5740 * [ENH]: Integrate task operators into compaction by @tanujnay112 in https://github.com/chroma-core/chroma/pull/5687 * [ENH]: Add heaptender client to compaction and make finishtask usLow10/29/2025
1.2.2Version: `1.2.2` Git ref: `refs/tags/1.2.2` Build Date: `2025-10-26T22:10` PIP Package: `chroma-1.2.2.tar.gz` Github Container Registry Image: `:1.2.2` DockerHub Image: `:1.2.2` ## What's Changed * [ENH]: remove request structs from Chroma Rust client by @codetheweb in https://github.com/chroma-core/chroma/pull/5662 * [ENH]: (Rust client) add get_collection() and delete_collection() methods by @codetheweb in https://github.com/chroma-core/chroma/pull/5663 * [ENH] Serialize Where clause in Rust Low10/26/2025
1.1.1Version: `1.1.1` Git ref: `refs/tags/1.1.1` Build Date: `2025-10-05T02:52` PIP Package: `chroma-1.1.1.tar.gz` Github Container Registry Image: `:1.1.1` DockerHub Image: `:1.1.1` ## What's Changed * [ENH] Tenant override for bm25 by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/5483 * [ENH] Allow specifying sysdb nodeSelector and tolerations by @jasonvigil in https://github.com/chroma-core/chroma/pull/5485 * [BLD]: strip debug symbols from JS bindings by @codetheweb in https://githuLow10/5/2025
cli-1.1.11CLI release.Low10/1/2025
cli-1.1.10CLI release.Low9/16/2025
1.1.0Version: `1.1.0` Git ref: `refs/tags/1.1.0` Build Date: `2025-09-16T21:23` PIP Package: `chroma-1.1.0.tar.gz` Github Container Registry Image: `:1.1.0` DockerHub Image: `:1.1.0` ## What's Changed * [ENH]: fix high cardinality compaction metrics by @codetheweb in https://github.com/chroma-core/chroma/pull/5461 * [ENH] A control interface for GC. by @rescrv in https://github.com/chroma-core/chroma/pull/5218 * [CHORE] remove tilt_config.yaml by @rescrv in https://github.com/chroma-core/chroma/pulLow9/16/2025
1.0.21Version: `1.0.21` Git ref: `refs/tags/1.0.21` Build Date: `2025-09-11T22:34` PIP Package: `chroma-1.0.21.tar.gz` Github Container Registry Image: `:1.0.21` DockerHub Image: `:1.0.21` ## What's Changed * [ENH]: Propagate cancellations to NAC queue by @tanujnay112 in https://github.com/chroma-core/chroma/pull/5129 * [ENH] Update auth hooks to return user identity by @drewkim in https://github.com/chroma-core/chroma/pull/5305 * [ENH] Add AVX512 support to distance calculations by @jairad26 in httpLow9/11/2025
cli-1.1.9CLI release.Low9/11/2025
1.0.20Version: `1.0.20` Git ref: `refs/tags/1.0.20` Build Date: `2025-08-18T17:04` PIP Package: `chroma-1.0.20.tar.gz` Github Container Registry Image: `:1.0.20` DockerHub Image: `:1.0.20` ## What's Changed * [RELEASE] 1.0.20 by @itaismith in https://github.com/chroma-core/chroma/pull/5303 **Full Changelog**: https://github.com/chroma-core/chroma/compare/1.0.19...1.0.20Low8/18/2025
cli-1.1.8CLI release.Low8/18/2025
1.0.18Version: `1.0.18` Git ref: `refs/tags/1.0.18` Build Date: `2025-08-18T08:09` PIP Package: `chroma-1.0.18.tar.gz` Github Container Registry Image: `:1.0.18` DockerHub Image: `:1.0.18` ## What's Changed * [CHORE]: Added short descriptions to CLI commands by @tazarov in https://github.com/chroma-core/chroma/pull/5217 * [ENH] Use AVX in distance calculations by @jairad26 in https://github.com/chroma-core/chroma/pull/5258 * [ENH] Auto-set tenant, scoped database in python CloudClient by @jairad26 inLow8/18/2025
cli-1.1.7CLI release.Low8/18/2025
1.0.17Version: `1.0.17` Git ref: `refs/tags/1.0.17` Build Date: `2025-08-14T22:52` PIP Package: `chroma-1.0.17.tar.gz` Github Container Registry Image: `:1.0.17` DockerHub Image: `:1.0.17` ## What's Changed * [ENH]: add metrics for span & metric exporters by @codetheweb in https://github.com/chroma-core/chroma/pull/5223 * [ENH]: add metric for # of aborted tasks in dispatcher by @codetheweb in https://github.com/chroma-core/chroma/pull/5224 * [ENH]: make take_result_channel() return an option by @codLow8/14/2025
cli-1.1.6CLI release.Low8/13/2025
1.0.16Version: `1.0.16` Git ref: `refs/tags/1.0.16` Build Date: `2025-08-08T00:26` PIP Package: `chroma-1.0.16.tar.gz` Github Container Registry Image: `:1.0.16` DockerHub Image: `:1.0.16` ## What's Changed * [ENH]: add cache mount & tolerations to garbage collector template in Helm chart by @codetheweb in https://github.com/chroma-core/chroma/pull/5016 * [DOC] Fix docs typo by @itaismith in https://github.com/chroma-core/chroma/pull/5018 * [CLN] Change GenericQuotaError from 429 to 422 by @drewkim iLow8/8/2025
cli-1.1.5CLI release.Low8/7/2025
1.0.15Version: `1.0.15` Git ref: `refs/tags/1.0.15` Build Date: `2025-07-02T17:07` PIP Package: `chroma-1.0.15.tar.gz` Github Container Registry Image: `:1.0.15` DockerHub Image: `:1.0.15` ## What's Changed * [BUG] Track the threshold of garbage collected fragments by @rescrv in https://github.com/chroma-core/chroma/pull/4874 * [ENH] Make the Failed to Fetch log error verbose by @rescrv in https://github.com/chroma-core/chroma/pull/4886 * [ENH] Put a limiter on the purge_dirty_for_collection call. Low7/2/2025
cli-1.1.4CLI release.Low7/2/2025
cli-1.1.3CLI release.Low6/23/2025
1.0.13Version: `1.0.13` Git ref: `refs/tags/1.0.13` Build Date: `2025-06-18T22:16` PIP Package: `chroma-1.0.13.tar.gz` Github Container Registry Image: `:1.0.13` DockerHub Image: `:1.0.13` ## What's Changed * [PERF]: skip document mutation in full-text index writer if old and new documents are same by @codetheweb in https://github.com/chroma-core/chroma/pull/4678 * [BUG] Rust log service fork offsets off by one by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/4689 * [ENH] Use tracing utiLow6/18/2025
1.0.12Version: `1.0.12` Git ref: `refs/tags/1.0.12` Build Date: `2025-05-31T02:41` PIP Package: `chroma-1.0.12.tar.gz` Github Container Registry Image: `:1.0.12` DockerHub Image: `:1.0.12` ## What's Changed * [ENH] Add rust log service memberlist by @HammadB in https://github.com/chroma-core/chroma/pull/4415 * [BUG] Wire up the rust-log-service member ID to the dirty log. by @rescrv in https://github.com/chroma-core/chroma/pull/4645 * [CLN] Failed precondition -> Internal by @HammadB in https://githLow5/31/2025
1.0.10Version: `1.0.10` Git ref: `refs/tags/1.0.10` Build Date: `2025-05-22T03:00` PIP Package: `chroma-1.0.10.tar.gz` Github Container Registry Image: `:1.0.10` DockerHub Image: `:1.0.10` ## What's Changed * [CHORE] Use bigger machine for build and publish container image by @HammadB in https://github.com/chroma-core/chroma/pull/4533 * [ENH] Expose may_contain for disk cache, use in prefetch by @HammadB in https://github.com/chroma-core/chroma/pull/4530 * [BUG]: use byte offset in full-text reader rLow5/22/2025
cli-1.1.2CLI release.Low5/20/2025
1.0.9Version: `1.0.9` Git ref: `refs/tags/1.0.9` Build Date: `2025-05-13T03:39` PIP Package: `chroma-1.0.9.tar.gz` Github Container Registry Image: `:1.0.9` DockerHub Image: `:1.0.9` ## What's Changed * [CHORE] Fix JS release to support platform specific bindings by @itaismith in https://github.com/chroma-core/chroma/pull/4442 * [RELEASE] Release JS client 2.4.1 by @itaismith in https://github.com/chroma-core/chroma/pull/4443 * [RELEASE] JS Client 2.4.2 by @itaismith in https://github.com/chroma-corLow5/13/2025
latestVersion: `1.5.9.dev6` Git ref: `refs/heads/main` Build Date: `2026-04-21T07:21` PIP Package: `chroma-1.5.9.dev6.tar.gz` Github Container Registry Image: `:1.5.9.dev6` DockerHub Image: `:1.5.9.dev6`Low4/1/2025

Dependencies & License Audit

Loading dependencies...

Similar Packages

txtai💡 All-in-one AI framework for semantic search, LLM orchestration and language model workflowsv9.10.0
helix-dbHelixDB is an open-source graph-vector database built from scratch in Rust.v3.0.3
meilisearchA lightning-fast search engine API bringing AI-powered hybrid search to your sites and applications.v1.45.2
ai-daily-newsDeliver daily Chinese AI news summaries by filtering top global tech blog articles into concise, valuable insights for quick reading.main@2026-06-02
PageIndex📑 PageIndex: Document Index for Vectorless, Reasoning-based RAGmain@2026-06-02

More in Databases

milvusMilvus is a high-performance, cloud-native vector database built for scalable vector ANN search
WeKnoraLLM-powered framework for deep document understanding, semantic retrieval, and context-aware answers using RAG paradigm.
ai-real-estate-assistantAdvanced AI Real Estate Assistant using RAG, LLMs, and Python. Features market analysis, property valuation, and intelligent search.
alibabacloud-adb20211201Alibaba Cloud adb (20211201) SDK Library for Python