Installation
Basic usage
Using persistent storage
Using with a remote server
Advanced querying
Metadata filtering
Custom retrievers
Loading existing collections
Configuration options
Collection
required
Chroma collection instance
string
Chroma server host (for HttpClient)
int
Chroma server port (for HttpClient)
string
Path for persistent storage (for PersistentClient)
Use cases
Document indexing
Index large document collections for retrieval
Knowledge graphs
Build knowledge graphs with vector embeddings
Multi-modal search
Search across text, images, and other modalities
Agents
Build LLM agents with memory backed by Chroma
Best practices
Choose the right client
Choose the right client
- Use
EphemeralClientfor testing and prototyping - Use
PersistentClientfor local development with persistence - Use
HttpClientfor production client-server deployments
Optimize for performance
Optimize for performance
- Batch document insertions for better performance
- Use appropriate chunk sizes for your documents
- Configure HNSW index parameters for your use case
Resources
LlamaIndex handles document chunking and embedding automatically, making it easy to get started with Chroma.