unstale

npm / chromadb

chromadb

What changed in chromadb 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.

5 breaking23 new APIs and options6 behavior and defaults13 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.1.1 on npm

chromadb 147 changes

Breaking changes 5

  • Callers must specify an output collection when using the statistics wrapper.

    1.3.6release notes

  • The JS client validates that an embedding function is provided when a sparse source key is set.

    1.3.5release notes

  • The Rust client type was renamed from ChromaClient to ChromaHttpClient.

    1.2.2release notes

  • The Rust client option default_database_name was renamed to database_name.

    1.2.2release notes

  • Limits users from setting index parameters.

    1.2.2release notes

New APIs and options 23

  • Cache types are now configurable.

    1.3.6release notes

  • Exposes host and port as CloudClient constructor parameters.

    1.3.6release notes

  • Adds CMEK support to storage, the compactor, the log service, and the collection schema.

    1.3.6release notes

  • Makes detach a Collection method.

    1.3.6release notes

  • Allows specifying multiple filter keys when retrieving statistics.

    1.3.6release notes

  • Adds a key parameter to filter statistics results.

    1.3.6release notes

  • The JS client adds getCollectionByCrn API support.

    1.3.6release notes

  • Adds sparse vector labels to the Python client.

    1.3.6release notes

  • Adds a Python wrapper API for the statistics function.

    1.3.6release notes

  • A Google GenAI embedding function is available.

    1.3.5release notes

  • A Nomic embedding function is available.

    1.3.5release notes

  • The Python client supports EF environment variables without a prefix.

    1.3.5release notes

  • The Python client adds keepalive and maximum-connection controls.

    1.3.5release notes

  • A Transformers.js embedding function is available with compatibility with Python.

    1.3.5release notes

  • A BM25 embedding function is added to Python, allowing developers to use it for embeddings.

    1.3.3release notes

  • Qwen was added to the list of JS packages.

    1.3.2release notes

  • The Rust client adds BM25 support.

    1.2.2release notes

  • Adds a chroma_cloud() constructor for ChromaClientOptions.

    1.2.2release notes

  • The Rust client adds delete_collection() for deleting a collection.

    1.2.2release notes

  • The Rust client adds get_collection() for retrieving a collection.

    1.2.2release notes

  • Makes get_tenant_id() public in the Rust client.

    1.2.2release notes

  • Schemas support the Key object.

    1.2.2release notes

  • The search API can embed query strings.

    1.2.2release notes

Behavior and default changes 6

  • Chroma Cloud embedding functions can obtain the API key from the client, or from a header when available for authentication.

    1.3.6release notes

  • The EF package is automatically loaded when installed.

    1.3.5release notes

  • The default embedding function is automatically loaded with a schema.

    1.3.5release notes

  • Makes get_database_name() public in the Rust client.

    1.2.2release notes

  • Rust client methods accept AsRef<str> instead of String or Into<String>.

    1.2.2release notes

  • Modifying a collection updates its schema.

    1.2.2release notes

Fixes and other changes 13

  • Supports blank tasks for ChromaCloudQwenEmbeddingFunction.

    1.3.6release notes

  • Read/write schema errors distinguish user errors, which return 400, from internal errors, which return 500.

    1.3.6release notes

  • The JS client returns error messages from the server, making server-side error details available to callers.

    1.3.6release notes

  • Embedding functions in schemas are validated.

    1.3.5release notes

  • Garbage collection now handles soft-deleted attached functions.

    1.3.5release notes

  • The TypeScript vector config source key now accepts Key.

    1.3.5release notes

  • Hydration is fixed for Qwen embedding functions that use custom prompts or tasks.

    1.3.3release notes

  • Fixed sparse autoembed queries on the search API.

    1.3.2release notes

  • Fixes the API path used by collection.modify() in the Rust client.

    1.2.2release notes

  • Fixes forking after it was disabled until request and response types matched.

    1.2.2release notes

  • The Python client exports hosted ef from utils.

    1.2.2release notes

  • Fixes sparse auto-embedding in the Python client.

    1.2.2release notes

  • The Rust client serializes Where clauses.

    1.2.2release notes