+6
日增长
+65
周增长
+206
月增长
29,691
stars
2,607
forks
132
watchers
6,188
prs
1,734
issues
137
releases
README
!Chroma
!Chroma
Chroma - the open-source data infrastructure for AI.
|
|
Docs
|
Homepage
bash
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):
python
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 - contributing channel
- 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.
License
Apache 2.0Top issues
#2513[Bug]: chromadb 0.5.4 crashes on windows 55 comments · 2024-07-13#1330[Feature Request]: Hybrid Search with BM2536 comments · 2023-11-03#4089[Bug]: metadata filter does not work over 20 millions chunk.27 comments · 2025-03-26#469[Feature Request]: Expose sorting/ordering to query/get path19 comments · 2023-05-05#2446[Bug]: Unable to delete the persistent directory from another program due to PermissionError15 comments · 2024-07-03#1152[Bug]: Client.DeleteCollection not deleting files, version 0.4.1014 comments · 2023-09-18#6717[Vulnerability ]: Python Backend Server Side RCE & Python Client SDK RCE12 comments · 2026-03-24#2571[Bug]: Error chroma with protobuf12 comments · 2024-07-24
Latest release
1.5.9 1.5.9 2026-05-05Version: 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: 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