Chroma
AI & LLMsOpen-source search and retrieval database for AI applications.
Release History
1.5.14 fixes19 featuresVersion 1.5.1 focuses heavily on performance enhancements, particularly around quantized segment reading/writing and MCMR support, alongside numerous documentation updates and internal cleanup.
cli-1.4.11.5.03 fixes32 featuresVersion 1.5.0 introduces major enhancements by integrating collection management into Rust sysdb, improving configuration handling via MCMR, and adding performance optimizations across storage and indexing layers. This release also sees documentation updates and the introduction of USearch support.
cli-1.4.01.4.15 fixes26 featuresVersion 1.4.1 focuses heavily on backend infrastructure improvements, particularly around Spanner integration, Rust sysdb operations, and introducing features like indexing status across clients. It also includes several bug fixes related to quotas, database deletion, and collection affinity.
cli-1.3.11.4.0Breaking3 fixes10 featuresVersion 1.4.0 introduces major enhancements including group by support across clients, CMEK support, and significant architectural work on the Rust sysdb service and WAL3 abstraction layers. This release also resolves several documentation issues and a bug affecting BM25 search under multithreading.
cli-1.3.0No release notes provided.
cli-1.2.4No release notes provided.
1.3.69 fixes31 featuresThis release introduces significant enhancements to embedding functions, compactor architecture (including backfill capabilities), and sparse vector handling. Several bug fixes address issues related to soft deletes, authorization, and error propagation.
cli-1.2.3No release notes provided.
1.3.58 fixes11 featuresVersion 1.3.5 introduces several new embedding functions (Nomic, Google GenAI, transformers.js) and enhances garbage collection and schema validation. This release also includes numerous bug fixes across Python and JavaScript clients.
cli-1.2.2No release notes provided.
1.3.32 featuresVersion 1.3.3 introduces the chroma_bm25 embedding function for Python and resolves an issue with Qwen EF hydration. This release also includes documentation updates and minor chore improvements.
1.3.22 fixes1 featureVersion 1.3.2 is a patch release that includes fixes for compaction jobs and sparse autoembed queries, along with an enhancement to the JavaScript packages list.
cli-1.2.1No release notes provided.
cli-1.2.0No release notes provided.
1.3.01 fix10 featuresVersion 1.3.0 introduces significant enhancements to schema handling, compaction processes, and adds support for the Rust client. This release focuses on internal stability and feature parity across different components.
1.2.2Breaking12 fixes14 featuresVersion 1.2.2 introduces major enhancements and refactoring to the Rust client, including renaming core types and adding features like BM25 support. This release also resolves several critical bugs related to request types, schema population, and API paths.
1.1.16 fixes13 featuresVersion 1.1.1 introduces several enhancements, including tenant overrides for bm25, improved search argument handling, and updates to the Fastembed function. Several bugs related to search errors, distance calculations, and metadata updates have also been resolved.
cli-1.1.11No release notes provided.
cli-1.1.10No release notes provided.
1.1.03 fixes11 featuresVersion 1.1.0 introduces significant enhancements to the search API, including rank expression support and IDF modifiers, alongside new GC controls and various backend stability improvements.
1.0.216 fixes31 featuresVersion 1.0.21 introduces significant enhancements in performance and observability, including AVX512 support, garbage collection improvements, and the foundational implementation for sparse vector support and a new search endpoint. Several bug fixes address metric cardinality and request handling issues.
cli-1.1.9No release notes provided.
1.0.20This release, version 1.0.20, was published on 2025-08-18 and corresponds to Git ref refs/tags/1.0.20.
cli-1.1.8No release notes provided.
1.0.188 fixes14 featuresVersion 1.0.18 introduces significant performance enhancements through AVX utilization and query optimizations, alongside new features like manual garbage collection and CRN collection retrieval. Several bugs related to compaction, deadlocks, and garbage collection logic were also addressed.
cli-1.1.7No release notes provided.
1.0.17Breaking5 fixes12 featuresVersion 1.0.17 focuses on enhancing observability with new metrics and tracing capabilities, alongside performance improvements like reduced peak memory usage in the compactor. A key change involves removing the 'id' field from the GetCollectionByResourceNameRequest structure.
cli-1.1.6No release notes provided.
1.0.1612 fixes25 featuresThis release introduces significant enhancements in observability, performance optimizations for fetching and garbage collection, and stricter validation on collection creation endpoints. It also updates error handling for billing issues in the JS client and refines tracing configurations.
cli-1.1.5No release notes provided.
1.0.1519 fixes14 featuresVersion 1.0.15 focuses heavily on stability, garbage collection improvements (especially for WAL3), and enhanced S3/storage handling. It includes numerous bug fixes related to data deletion, manifest consistency, and contention management.
cli-1.1.4No release notes provided.
cli-1.1.3No release notes provided.
1.0.1314 fixes8 featuresVersion 1.0.13 focuses heavily on performance improvements, stability fixes across the Rust log service and WAL3 reader, and introduces a new JavaScript client alongside documentation updates.
1.0.127 fixes16 featuresVersion 1.0.12 focuses heavily on internal stability, particularly around the Rust log service integration, garbage collection improvements for hard deletes, and general bug fixes. New features include support for the Mistral embedding function and enhanced validation for client configurations.
1.0.108 fixes15 featuresVersion 1.0.10 introduces several enhancements to caching, logging, and collection management, alongside various bug fixes, particularly around full-text search and log service payload sizes.
cli-1.1.2No release notes provided.
1.0.97 fixes19 featuresVersion 1.0.9 introduces significant enhancements to logging, query filtering (regex support), and operational stability with added retries and bug fixes. Key improvements focus on internal service resilience and configuration management, especially around SPANN integration.
1.0.813 fixes15 featuresVersion 1.0.8 introduces significant feature enhancements, including collection forking across clients, new embedding function support (Cloudflare Worker AI, Together AI), and improved query capabilities. Numerous bugs related to HNSW, SPANN, consistency, and garbage collection have also been resolved.
cli-1.1.0No release notes provided.
1.0.74 fixes10 featuresVersion 1.0.7 introduces significant enhancements around collection forking capabilities across SysDB, RFE, and Python interfaces, alongside various bug fixes and build system improvements.
1.0.6Breaking10 fixes10 featuresVersion 1.0.6 introduces significant enhancements to collection configuration management, improved logging/throttling, and fixes several critical bugs related to data handling and indexing.
1.0.52 fixes15 featuresVersion 1.0.5 introduces significant enhancements to garbage collection, storage layer request priority, and wal3 functionality, alongside fixing a race condition and improving error propagation. This release also removes JavaScript bindings from the core package build.
1.0.47 fixes10 featuresVersion 1.0.4 focuses on stability, fixing several bugs related to GC, CLI, and collection querying, while introducing new features like Baseten integration and improved metrics configuration.
cli-1.0.1No release notes provided.
1.0.32 fixes1 featureVersion 1.0.3 focuses on stability with garbage collection improvements and fixes to the Windows CLI installation script, alongside documentation updates.
cli-1.0.0No release notes provided.
1.0.08 fixes48 featuresVersion 1.0.0 introduces major architectural improvements, including moving the sysdb client to its own crate, enhancing distributed system capabilities with better routing and assignment, and improving compaction and garbage collection mechanisms. This release also features updates to Python and JS clients, including switching to the official Ollama client.
latestThis is a development release (1.4.1.dev23) with no documented changes in this release note snippet.
0.6.311 fixes8 featuresVersion 0.6.3 focuses heavily on bug fixes, particularly around HNSW indexing and data handling, alongside introducing several new features for database management and distributed operations.
Common Errors
ChromaConnectionError2 reportsChromaConnectionError usually arises from schema mismatches between the client and the Chroma server, often due to differing versions or manually altered schemas. To resolve it, ensure your Chroma client version matches the server version and that no manual schema manipulations have been performed that are causing conflicts. If version mismatch is not the cause, try deleting and recreating the Chroma collection to enforce a consistent schema across client and server.
ChromaValueError1 reportChromaValueError usually arises when attempting an operation with a collection that doesn't exist or isn't properly initialized, often after a database reset or migration. Ensure the collection exists by either recreating it with `chroma_client.create_collection()` or verifying its presence with `chroma_client.get_collection()` before attempting any operations like adding or querying. If using persistent storage, double-check the persistence directory and ensure the chroma service is running and configured correctly.
ChromaServerError1 reportChromaServerError often arises from conflicts or incompatibilities between the client's request and the Chroma server's configuration, such as mismatched schemas, embedding functions, or API versions. Resolve this by ensuring the client-side schema and embedding function specifications precisely match the server's expectations and that your Chroma client library is compatible with the Chroma server version. Clear configuration mismatches and explicitly define consistent schema and embedding settings to prevent the error.
NotFoundError1 reportThe "NotFoundError" in Chroma usually arises when attempting to access a collection that doesn't exist in the database. To resolve this, verify that the collection name is correct and that the collection was indeed created beforehand. If the collection is missing, create it using `chroma_client.create_collection(name="your_collection_name")` before attempting to access it.
Related AI & LLMs Packages
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.
Get up and running with OpenAI gpt-oss, DeepSeek-R1, Gemma 3 and other models.
🦜🔗 The platform for reliable agents.
The most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.
LLM inference in C/C++
GPT4All: Run Local LLMs on Any Device. Open-source and available for commercial use.
Subscribe to Updates
Get notified when new versions are released