Skip to content

Get CookingΒΆ

This is a collection of small guides and recipes to help you get started with ChromaDB.

Critical Fix in 0.5.13

If you are using Chroma >=0.5.7 and <=0.5.13 please upgrade to 0.5.13+ or later as there is a critical bug that can cause data loss. Read more on the GH Issue #2922.

Latest ChromaDB version: 0.6.3

New and NoteworthyΒΆ

  • πŸ”„ Chroma Maintenance - Learn how to keep your Chroma database in tip-top shape - πŸ“…08-Feb-2025
  • βš’οΈ Configuration - Updated descriptions and added examples of Chroma configuration options - πŸ“…21-Nov-2024
  • 🏎️ Performance Tips - Learn how to optimize the performance of yourChroma - πŸ“…16-Oct-2024
  • ⁉️FAQs - Updated FAQ sections - πŸ“…15-Oct-2024
  • πŸ”₯ SSL-Terminating Proxies - Learn how to secure Chroma server with Envoy or Nginx proxies - πŸ“…31-Jul-2024
  • πŸ—‘οΈ WAL Pruning - Learn how to prune (cleanup) your Chroma database (WAL) with Chroma's built-in CLI vacuum command - πŸ“…30-Jul-2024
  • ✨ Multi-Category Filtering - Learn how to filter data based on multiple categories - πŸ“…15-Jul-2024
  • πŸ”’ Chroma Auth - Learn how to secure your Chroma deployment with Authentication - πŸ“…11-Jul-2024
  • πŸ“¦ Async Http Client - Chroma now supports async HTTP clients - πŸ“…19-Jun-2024
  • πŸ”’ Security - Learn how to secure your Chroma deployment - πŸ“…13-Jun-2024
  • πŸ”§ Installation - Learn about the different ways to install Chroma - πŸ“…08-Jun-2024
  • 🧠 Memory Management - Learn how to manage memory in ChromaDB - πŸ“…30-May-2024
  • πŸ“ Resource Requirements - Recently updated with temporary storage requirements - πŸ“…28-May-2024

Getting StartedΒΆ

We suggest you first head to the Concepts section to get familiar with ChromaDB concepts, such as Documents, Metadata, Embeddings, etc.

Once you're comfortable with the concepts, you can jump to the Installation section to install ChromaDB.

Core Topics:

  • Filters - Learn to filter data in ChromaDB using metadata and document filters
  • Resource Requirements - Understand the resource requirements for running ChromaDB
  • ✨Multi-Tenancy - Learn how to implement multi-tenancy in ChromaDB

Running ChromaDBΒΆ

  • CLI - Running ChromaDB via the CLI
  • Docker - Running ChromaDB in Docker
  • Docker Compose - Running ChromaDB in Docker Compose
  • Kubernetes - Running ChromaDB in Kubernetes (Minikube)

IntegrationsΒΆ

  • ✨LangChain - Integrating ChromaDB with LangChain
  • ✨LlamaIndex - Integrating ChromaDB with LlamaIndex
  • ✨Ollama - Integrating ChromaDB with Ollama

The EcosystemΒΆ

ClientsΒΆ

Below is a list of available clients for ChromaDB.

User InterfacesΒΆ

  • VectorAdmin (MintPlex Labs) - An open-source web-based admin interface for vector databases, including ChromaDB
  • ChromaDB UI (Community maintained) - A web-based UI for ChromaDB

CLI ToolingΒΆ

  • Chroma CLI (Community maintained) - Early Alpha
  • Chroma Data Pipes (Community maintained) - A CLI tool for importing and exporting data from ChromaDB
  • Chroma Ops (Community maintained) - A maintenance CLI tool for ChromaDB

StrategiesΒΆ

  • Backup - Backing up ChromaDB data
  • Batch Imports - Importing data in batches
  • Multi-Tenancy - Running multiple ChromaDB instances
  • Keyword Search - Searching for keywords in ChromaDB
  • Memory Management - Managing memory in ChromaDB
  • Time-based Queries - Querying data based on timestamps
  • ✨ Coming Soon Testing with Chroma - learn how to test your GenAI apps that include Chroma.
  • ✨ Coming Soon Monitoring Chroma - learn how to monitor your Chroma instance.
  • ✨ Coming Soon Building Chroma clients - learn how to build clients for Chroma.
  • ✨ Coming Soon Creating the perfect Embedding Function (wrapper) - learn the best practices for creating your own embedding function.
  • ✨ Multi-User Basic Auth Plugin - learn how to build a multi-user basic authentication plugin for Chroma.
  • ✨ CORS Configuration For JS Browser apps - learn how to configure CORS for Chroma.
  • ✨ Running Chroma with SystemD - learn how to start Chroma upon system boot.

Get HelpΒΆ

Missing something? Let us know by opening an issue, reach out on Discord (look for @taz).