Files
5792915c28 feat: make chromadb an optional extra (crewai[chromadb]) (#8941)
* feat(packaging): make chromadb an optional extra, add qdrant-client to core

chromadb moves from core dependencies to the crewai[chromadb] extra.
qdrant-client (without fastembed) becomes a core dependency since Knowledge
now defaults to local Qdrant. The qdrant extra keeps fastembed for
QdrantConfig()'s local default embedder.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test: skip chromadb-only tests when chromadb is not installed

Add a requires_chromadb marker (skipped by a conftest hook when chromadb is
missing) and importorskip the tests/rag/chromadb modules, so the suite can run
against an install without the crewai[chromadb] extra.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* feat(tools): import crewai_tools without chromadb, default RagTool to Qdrant

crewai_tools.rag.core imports chromadb lazily and points to crewai[chromadb]
when it is missing. RagTool defaults to local Qdrant with OpenAI's
text-embedding-3-small (shared with Knowledge via default_embedding_function),
and wraps embedders for the Qdrant client. chromadb stays available through
provider="chromadb" with the crewai[chromadb] extra.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* chore(rag): fix stale docstrings and remove unused optional-import placeholders

Correct the ChromaDB default-embedder and Qdrant 1536-dimension docstrings, use
get_rag_client() in BaseClient examples, and drop the unused DISCRIMINATOR and
Missing*Config placeholders with their test.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* docs: Knowledge and RAG tools default to Qdrant, ChromaDB is an optional extra

Document the Qdrant default, the crewai[chromadb] extra, the need to re-index
Knowledge, and the local Qdrant limits (one process per folder, no concurrent
thread writes). Synced to ar, ko and pt-BR.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* chore: update chromadb and oauthlib comments for the optional extra

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(tools): re-record search tool cassettes for the Qdrant default

RagTool now defaults to Qdrant, which makes an extra dimension-probe
embedding call and uses text-embedding-3-small. Re-record the cassettes,
add one for the docx init test, and use a 0.3 similarity threshold in the
csv, directory and txt tests since Qdrant applies it to the raw cosine score.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* docs: drop stale chroma-hnswlib warning, add RAG client section to ko and pt-BR Knowledge

chromadb is no longer a core dependency and the lock has no chroma-hnswlib,
so the Windows build-tools warning no longer applies. Removed it from the
root and crewai READMEs and the en/ar/ko/pt-BR installation pages.

The ko and pt-BR Knowledge pages were missing the vector store (RAG) client
section that en and ar have, so they did not say Qdrant is the default.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(llm): restore the Azure completion module after the import test

test_azure_completion_module_is_imported deleted the module from sys.modules
and never put it back, so later tests built a second AzureCompletion class and
their isinstance checks failed whenever the random test order put it first.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* docs: local Qdrant is thread-safe, point to a Qdrant server or ChromaDB for multiple processes

The shared local Qdrant client now serializes calls, so the thread-safety limit
no longer applies. Keep the one-process-per-folder limit and say how to share
storage across processes: a Qdrant server URL or ChromaDB. Synced to ar, ko and
pt-BR.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* docs: describe the per-process default Qdrant folder and how to keep or share Knowledge

The default local Qdrant folder is now qdrant-pid<PID> and is removed when the
process exits, so processes no longer collide but nothing persists by default.
Explain how to keep Knowledge on disk with a fixed path, how to share a store
with a Qdrant server or ChromaDB, and that building a QdrantConfig needs
crewai[qdrant] or an embedding_function. Update the storage-location snippets.
Synced to ar, ko and pt-BR.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(tools): run directory, text and CSV search tests at the default threshold

The 0.3 overrides only hid the Qdrant score threshold mismatch, which is now
fixed, so these tests use the default again.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* docs: score_threshold uses the same 0-1 scale on Qdrant and ChromaDB

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(tools): patch chromadb.Client directly now that RAG imports chromadb lazily

The JSONL fixture patched crewai_tools.rag.core.chromadb.Client, which no
longer exists as a module attribute. Skip the file when chromadb is not
installed.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* chore: update tool specifications

---------

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-11-18 20:26:51 +05:30
..