默认 Client() 为内存模式,数据不持久化,需自行配置持久化;客户端-服务器模式需单独执行 chroma run 启动服务
pip install chromadb
chroma run --path /chroma_db_pathREADME 未说明
开源 AI 数据基础设施,提供向量、混合与全文检索,帮工程师快速搭建相似度搜索
开源的向量数据库,专门给 AI 应用做检索基础设施,支持 RAG、语义搜索和智能体记忆存储,底层用 Rust 重写后性能更强。
核心能力
- 核心 API 仅 4 个函数即可完成增删查
- 自动处理分词、嵌入与索引,也可自带向量
- 支持按元数据和文档内容过滤查询
- 提供 Python 与 JavaScript 客户端
- 支持内存原型与客户端-服务器持久化模式
容易踩的坑
- 1.5.9最新正式版2026-05-05 · 2026-05-05 05:55 UTC
Version:
1.5.9Git ref:refs/tags/1.5.9Build Date:2026-05-05T05:55PIP Package:chroma-1.5.9.tar.gzGithub Container Registry Image::1.5.9DockerHub Image::1.5.9What's Changed
- ENH: block functions on topology dbs by @rescrv in https://github.com/chroma-core/chroma/pull/6836
- ENH: 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/chroma-core/chroma/pull/6905
- [ENH]: Enable rebuilds for sharded collections by @tanujnay112 in https://github.com/chroma-core/chroma/pull/6916
- [ENH]: Group by support with sharding by @sanketkedia in https://github.com/chroma-core/chroma/pull/6909
- [CHORE]: Denormalize tenant and database into collection_compaction_cursors table by @tanujnay112 in https://github.com/chroma-core/chroma/pull/6940
- [CHORE] Use normalized record sets for test add by @rescrv in https://github.com/chroma-core/chroma/pull/6935
- [ENH]: Add workflow to build and publish service container images by @jasonvigil in https://github.com/chroma-core/chroma/pull/6944
- [ENH] - Updates language around Chroma Cloud to be more representative. by @tjkrusinskichroma in https://github.com/chroma-core/chroma/pull/6952
- [ENH]: Add change stream to collection compaction cursors by @tanujnay112 in https://github.com/chroma-core/chroma/pull/6955
- [BUG] Switch to storing DOCKERHUB_USERNAME as var by @jasonvigil in https://github.com/chroma-core/chroma/pull/6962
- [CHORE]: Standardize Tilt CI image build on root docker-bake.hcl by @jasonvigil in https://github.com/chroma-core/chroma/pull/6958
- [BUG]: Rename database on soft delete by @tanujnay112 in https://github.com/chroma-core/chroma/pull/6943
- Revert "[CHORE]: Standardize Tilt CI image build on root docker-bake.hcl" by @jasonvigil in https://github.com/chroma-core/chroma/pull/6965
- ENH: name and size all worker threads by @rescrv in https://github.com/chroma-core/chroma/pull/6936
- BUG: simplify flaky indexing progress test by @rescrv in https://github.com/chroma-core/chroma/pull/6968
- [CHORE] stabilize Tilt dev environment configs by @rescrv in https://github.com/chroma-core/chroma/pull/6937
- BUG: use correct version file per collection in ancestor walk by @rescrv in https://github.com/chroma-core/chroma/pull/6970
- [ENH] Add SparsePostingBlock by @HammadB in https://github.com/chroma-core/chroma/pull/6823
- [ENH] Add basic maxscore writer/reader by @HammadB in https://github.com/chroma-core/chroma/pull/6825
- [ENH] Add maxscore lazy cursor by @HammadB in https://github.com/chroma-core/chroma/pull/6829
- [ENH] Add SIMD for maxscore by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/6865
- [ENH] Benchmark maxscore by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/6866
- [ENH] Add maxscore option in schema by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/6878
- [ENH] Add maxscore index to metadata segment by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/6880
- [ENH] Wire maxscore reader in search by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/6899
- [PERF] Batch load lazy cursor by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/6974
- ENH: add MCMR support for log GC by @rescrv in https://github.com/chroma-core/chroma/pull/6946
- ENH: parameterize multi-region config by @rescrv in https://github.com/chroma-core/chroma/pull/6951
- [CHORE] fix merge conflict in main by @rescrv in https://github.com/chroma-core/chroma/pull/6986
- [ENH]: Refactor offset_id to be a mutable AtomicU32 in record by @tanujnay112 in https://github.com/chroma-core/chroma/pull/6922
- ENH: add spanner-cli wrapper binary by @rescrv in https://github.com/chroma-core/chroma/pull/6959
- BUG: preserve legacy hnsw: metadata keys by @rescrv in https://github.com/chroma-core/chroma/pull/6953
- cli-1.4.42026-05-05 · 2026-05-05 04:47 UTC
查看更新说明
CLI release.
- foundation-cli-v0.1.0-alpha.3pre-release2026-05-01 · 2026-05-01 00:44 UTC
查看更新说明
v0.1.0-alpha.3 (2026-05-01)
- fix release workflow: use rust/foundation/target for standalone workspace binary path
- 1.5.82026-04-16 · 2026-04-16 23:35 UTC
查看更新说明
Version:
1.5.8Git ref:refs/tags/1.5.8Build Date:2026-04-16T23:35PIP Package:chroma-1.5.8.tar.gzGithub Container Registry Image::1.5.8DockerHub Image::1.5.8What'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 @tanujnay112 in https://github.com/chroma-core/chroma/pull/6842
- [ENH]: Merge, sort and truncate in FE by @sanketkedia in https://github.com/chroma-core/chroma/pull/6846
- [CHORE]: Prefetch per shard by @tanujnay112 in https://github.com/chroma-core/chroma/pull/6850
- [CHORE]: Create per-tenant config in the compactor for shard sizes by @tanujnay112 in https://github.com/chroma-core/chroma/pull/6847
- ENH: support partial manifest scans by @rescrv in https://github.com/chroma-core/chroma/pull/6799
- [ENH]: Replace join_all with buffered_unordered with a limit in block loads by @sanketkedia in https://github.com/chroma-core/chroma/pull/6854
- [ENH] Add pod anti-affinity support to StatefulSet helm templates by @jasonvigil in https://github.com/chroma-core/chroma/pull/6859
- [CHORE] Disable stall protection for reads. by @rescrv in https://github.com/chroma-core/chroma/pull/6858
- [CHORE]: Remove fanout in writer by @sanketkedia in https://github.com/chroma-core/chroma/pull/6861
- [BUG] Make the most recent log spanner-migration idempotent. by @rescrv in https://github.com/chroma-core/chroma/pull/6863
- ENH: make admin RPC timeout configurable by @rescrv in https://github.com/chroma-core/chroma/pull/6864
- [ENH] Add CLI I/O terminal for testing by @itaismith in https://github.com/chroma-core/chroma/pull/6860
- [DOC] Fix missing word in manage-collections documentation by @gshahbazian in https://github.com/chroma-core/chroma/pull/6873
- [ENH]: Composite rules for tiering by @sanketkedia in https://github.com/chroma-core/chroma/pull/6876
- [ENH] Add I/O abstraction to CLI commands by @itaismith in https://github.com/chroma-core/chroma/pull/6877
- [ENH]: Add member_id to node_name lookup in ClientAssigner by @davedash in https://github.com/chroma-core/chroma/pull/6875
- [BUG]: get_prefix use buffer ordered by @sanketkedia in https://github.com/chroma-core/chroma/pull/6893
- [CHORE]: Revert "[CLN] Remove compaction_client binary (#6744)" by @tanujnay112 in https://github.com/chroma-core/chroma/pull/6901
- [ENH] Add config store abstraction to CLI by @itaismith in https://github.com/chroma-core/chroma/pull/6879
- [DOC] Add Superlinked embedding function integration by @fm1320 in https://github.com/chroma-core/chroma/pull/6897
- [ENH] add MCMR property tests and fix dirty log detection by @rescrv in https://github.com/chroma-core/chroma/pull/6835
- [ENH] Update stars/followers count by @gshahbazian in https://github.com/chroma-core/chroma/pull/6908
- [ENH]: Make compaction client grpc timeout configurable by @tanujnay112 in https://github.com/chroma-core/chroma/pull/6902
- ENH: add fault injection control plane by @rescrv in https://github.com/chroma-core/chroma/pull/6795
- [ENH]: Change retry rate limits in s3 client by @sanketkedia in https://github.com/chroma-core/chroma/pull/6917
- ENH: add optional upload fault injector by @rescrv in https://github.com/chroma-core/chroma/pull/6849
- [ENH] Use the official Rust client in the CLI by @itaismith in https://github.com/chroma-core/chroma/pull/6906
- [ENH] Add IndexAndBoundedWal read level by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/6914
- [ENH] Add IndexAndAdaptiveWal to clients by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/6918
- [RELEASE] Python 1.5.8 JS 3.4.4 Rust 0.14.0 by @Sicheng-Pan in https://github.com/chroma-core/chroma/pull/6921
New Contributors
- @fm1320 made their first contribution in https://github.com/chroma-core/chr
- latestLatestpre-release2025-04-01 · 2025-04-01 23:29 UTC
查看更新说明
Version:
1.5.10.dev326Git ref:refs/heads/mainBuild Date:2026-10-22T01:30PIP Package:chroma-1.5.10.dev326.tar.gzGithub Container Registry Image::1.5.10.dev326DockerHub Image::1.5.10.dev326
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。

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.
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.
- Join the conversation on Discord -
#contributingchannel - Review the 🛣️ Roadmap and contribute your ideas
- Grab an issue and open a PR -
Good first issue tag - Read our contributing guide
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.