ErrLookup › chroma-core/chroma
chroma-core/chroma
Search infrastructure for AI · Rust · 979 source files
Analyzed at aecdd12c8a on 2026-08-16. 733 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Multiple embedding functions provided. Please provide only o | validation | error | chromadb, select, deserialization, typeerror, query-payload |
| Bad request to ${input} with status: ${resp.statusText} | http | error | chromadb, select, schema, valueerror, payload-shape |
| Unauthorized | http | error | chromadb, aggregate, groupby, min-k, deserialization, typeerror |
| You do not have permission to access the requested resource. | http | error | chromadb, aggregate, missing-field, valueerror, min-k, max-k |
| The requested resource could not be found: ${input} | http | error | chromadb, aggregate, missing-field, valueerror, max-k, min-k |
| The resource already exists | http | error | chromadb, aggregate, keys, typeerror, min-k, max-k |
| ${respBody?.message} | http | error | chromadb, aggregate, empty-list, valueerror, min-k, max-k |
| Unable to connect to the chromadb server. Please try again l | http | error | chromadb, aggregate, typeerror, k, min-k, max-k |
| Failed to fetch ${input} with status ${resp.status}: ${resp. | http | error | chromadb, aggregate, invalid-value, valueerror, k, min-k, max-k |
| Failed to connect to chromadb. Make sure your server is runn | exception | error | chromadb, aggregate, typeerror, deserialization, min-k, max-k |
| No API key provided | validation | error | chromadb, aggregate, empty-dict, valueerror, groupby |
| You must provide either queryEmbeddings or queryTexts | validation | error | chromadb, aggregate, valueerror, schema, min-k, max-k |
| Cannot specify both 'hnsw' and 'spann' configurations. | validation | error | chromadb, aggregate, unknown-operator, valueerror, min-k, max-k |
| Invalid JSON string for collection configuration | validation | error | chromadb, groupby, typeerror, deserialization |
| Invalid HNSW config provided | validation | error | chromadb, groupby, missing-field, valueerror, aggregate |
| Invalid SPANN config provided | validation | error | chromadb, groupby, keys, typeerror |
| Could not serialize collection configuration | validation | error | chromadb, groupby, empty-list, valueerror |
| Cannot specify both 'hnsw' and 'spann' configurations during | validation | error | configuration, validation, hnsw, spann, index, collection-creation |
| Invalid HNSW config provided in CreateCollectionConfiguratio | validation | error | configuration, validation, hnsw, type-mismatch, collection-creation |
| Invalid SPANN config provided in CreateCollectionConfigurati | validation | error | configuration, validation, spann, type-mismatch, collection-creation |
| Cannot specify both 'hnsw' and 'spann' configurations during | validation | error | configuration, validation, hnsw, spann, update, collection-modify |
| Invalid HNSW config provided in UpdateCollectionConfiguratio | validation | error | configuration, validation, hnsw, type-mismatch, update, collection-modify |
| Invalid SPANN config provided in UpdateCollectionConfigurati | validation | error | configuration, validation, spann, type-mismatch, update, collection-modify |
| No valid configuration fields provided for update. | validation | error | configuration, validation, update, empty-payload, collection-modify |
| Credentials must be supplied via environment variable (CHROM | validation | error | auth, credentials, environment-variable, basic-auth |
| Auth provider not specified | validation | error | auth, configuration, client-construction, validation |
| Auth credentials not specified | validation | error | auth, credentials, configuration, client-construction, validation |
| Invalid auth provider | validation | error | auth, configuration, validation, client-construction, unsupported-provider |
| Cloudflare API key is required. Please provide it in the con | validation | error | embeddings, cloudflare, api-key, environment-variable, credentials |
| resp.detail || "Unknown error" | exception | error | embeddings, cloudflare, api-response, http-error, runtime |
| Error calling Cloudflare Workers AI API: ${error.message} | exception | error | embeddings, cloudflare, network, error-wrapping, runtime |
| Error calling Cloudflare Workers AI API: ${error} | exception | error | embeddings, cloudflare, error-wrapping, non-error-throw, runtime |
| Cohere API key is required. Please provide it in the constru | validation | error | embeddings, cohere, api-key, environment-variable, credentials |
| Please install the cohere-ai package to use the CohereEmbedd | exception | error | embeddings, cohere, missing-dependency, module-not-found, npm |
| CohereEmbeddingFunction model_name cannot be changed after i | validation | error | embeddings, cohere, configuration, immutable-field, model-change |
| DefaultEmbeddingFunction model cannot be changed after initi | validation | error | embeddings, default-embedding, onnx, configuration, immutable-field, model-change |
| Please install the chromadb-default-embed package to use the | exception | error | npm, optional-dependency, embeddings, module-not-found, lazy-import |
| Please install chromadb-default-embed as a dependency with, | exception | error | npm, optional-dependency, module-not-found, error-masking, embeddings |
| Google API key is required. Please provide it in the constru | validation | error | api-key, env-var, google, gemini, configuration, embeddings |
| Please install the @google/generative-ai package to use the | exception | error | npm, google, gemini, optional-dependency, module-not-found, lazy-import |
| Please install @google/generative-ai as a dependency with, e | exception | error | npm, google, gemini, module-not-found, error-masking, embeddings |
| The model name cannot be changed after initialization. | validation | error | embeddings, config, google, immutable, validation |
| The task type cannot be changed after initialization. | validation | error | embeddings, config, google, immutable, validation, key-mismatch |
| Failed to generate embeddings: ${response.statusText} | exception | error | network, http, huggingface, embeddings, server, status-code |
| Changing the URL is not allowed. | validation | error | config, huggingface, immutable, embeddings, validation, url |
| Jina AI API key is required. Please provide it in the constr | validation | error | api-key, env-var, jina, configuration, embeddings |
| data.detail | exception | error | api, jina, embeddings, http, error-response, auth |
| Error calling Jina AI API: ${error.message} | exception | error | jina, network, embeddings, error-wrapping, fetch, proxy |
| Error calling Jina AI API: ${error} | exception | error | jina, error-wrapping, embeddings, non-error-throw |
| Please install the ollama package to use the OllamaEmbedding | exception | error | npm, ollama, optional-dependency, module-not-found, lazy-import, embeddings |
| Please install Ollama as a dependency with, e.g. `npm instal | exception | error | npm, ollama, module-not-found, error-masking, embeddings |
| OpenAI API key is required. Please provide it in the constru | validation | error | api-key, env-var, openai, configuration, embeddings |
| Please install the openai package to use the OpenAIEmbedding | exception | error | npm, openai, optional-dependency, module-not-found, lazy-import, embeddings |
| Cannot change model name. | validation | error | embeddings, config, openai, immutable, validation |
| Together AI API key is required. Please provide it in the co | validation | error | api-key, env-var, together-ai, configuration, embeddings |
| Invalid response format from Together AI API | exception | error | together-ai, embeddings, api-response, authentication, http |
| Error calling Together AI API: ${error.message} | exception | error | together-ai, embeddings, network, fetch, json-parse |
| Error calling Together AI API: ${error} | exception | error | together-ai, embeddings, non-error-throw, testing, fetch-mock |
| Please install the @xenova/transformers package to use the T | exception | error | transformers, embeddings, optional-dependency, npm, local-inference |
| Please install @xenova/transformers as a dependency with, e. | exception | error | transformers, embeddings, npm, wasm, native-module, docker |
| Cannot change the model of the embedding function. | validation | error | transformers, embeddings, immutable-config, collection-update |
| Cannot change the revision of the embedding function. | validation | error | transformers, embeddings, immutable-config, model-revision, collection-update |
| Cannot change the quantization of the embedding function. | validation | error | transformers, embeddings, immutable-config, quantization, collection-update |
| VoyageAI API key is required. Please provide it in the const | validation | error | voyageai, embeddings, api-key, env-var, configuration |
| Please install the voyageai package to use the VoyageAIEmbed | exception | error | voyageai, embeddings, optional-dependency, npm |
| Cannot change the model of the embedding function. | validation | error | voyageai, embeddings, immutable-config, collection-update |
| Embedding function must have a name to be registered. | validation | error | registry, embeddings, function-name, bundling, minification |
| Embedding function ${name} not found | validation | error | registry, embeddings, lookup, name-mismatch, deserialization |
| Config validation failed for schema '${schemaName}': ${error | validation | error | ajv, json-schema, config-validation, embeddings, schema |
| Could not connect to tenant ${tenant}. Are you sure it exist | exception | error | tenant, admin-api, multi-tenancy, chroma-server, not-found |
| Could not connect to database ${database} for tenant ${tenan | exception | error | database, tenant, admin-api, multi-tenancy, not-found |
| embeddings and documents cannot both be undefined | validation | error | records, add, upsert, validation, embeddings |
| Failed to generate embeddings for your request. | exception | error | records, embeddings, custom-embedding-function, validation, return-value |
| Expected ids to be strings, found ${typeof ids[i]} at index | validation | error | records, ids, type-error, validation, add |
| ids, embeddings, metadatas, and documents must all be the sa | validation | error | records, add, upsert, length-mismatch, validation, batching |
| ID's must be unique, found duplicates for: ${duplicateIds} | validation | error | ids, validation, duplicate-ids, add-records |
| got empty embedding at pos | validation | error | embeddings, validation, empty-vector |
| Unsupported architecture on macOS: ${process.arch} | exception | critical | native-bindings, platform, macos, module-load |
| Unsupported architecture on Linux: ${process.arch} | exception | critical | native-bindings, platform, linux, arm, module-load |
| Unsupported Windows architecture: ${process.arch}. Only ARM6 | exception | critical | native-bindings, platform, windows, module-load |
| Unsupported platform: ${process.platform} | exception | critical | native-bindings, platform, module-load |
| Failed to fetch package data: ${response.statusText} | exception | warning | cli, network, npm-registry, update-check |
| Updating '${key}' is not supported for ${NAME} | validation | error | config, validation, bm25, sparse-embeddings |
| Failed to generate embeddings. | exception | error | embeddings, cloud-api, qwen, api-response |
| Error calling Chroma Embedding API: ${error.message} | exception | error | embeddings, cloud-api, qwen, network, error-wrapping |
| Error calling Chroma Embedding API: ${error} | exception | error | embeddings, cloud-api, qwen, error-wrapping, testing |
| Config is missing a required field | validation | error | config, validation, qwen, embeddings, deserialization |
| Model cannot be updated | validation | error | config, validation, qwen, immutable-field |
| Task cannot be updated | validation | error | config, validation, qwen, immutable-field |
| Instructions cannot be updated | validation | error | config, validation, qwen, immutable-field |
| HTTP ${response.status} ${response.statusText}: ${errorText} | http | error | cloud-api, splade, http-error, embeddings, sparse-embeddings |
| Invalid response format: expected object | exception | error | cloud-api, splade, response-validation, embeddings |
| Invalid response format: missing or invalid embeddings array | exception | error | |
| Error calling Chroma Embedding API: ${error.message} | exception | error | |
| Error calling Chroma Embedding API: ${error} | exception | error | |
| Model cannot be updated | validation | error | |
| Error calling Cloudflare Workers AI API: ${e} | exception | error | |
| Error calling Cloudflare Workers AI API | exception | error | |
| Model name cannot be updated | validation | error | |
| Cohere image embedding supports one image at a time | validation | error | |
| Cohere image embedding supports a maximum of 96 text inputs | validation | error | |
| Failed to generate embeddings | exception | error | |
| Model name cannot be updated | validation | error | |
| Config validation failed for schema '${schemaName}': ${error | validation | error | |
| The DefaultEmbeddingFunction's 'model' cannot be changed aft | validation | error | |
| Failed to generate Gemini embeddings: ${e} | exception | error | |
| Failed to generate Gemini embeddings | exception | error | |
| Model name cannot be updated | validation | error | |
| Dimension cannot be updated | validation | error | |
| Could not find API key at ${args.apiKeyEnvVar} | validation | error | |
| Failed to generate embeddings: ${response.statusText} | http | error | |
| Failed to generate jina embedding data. | exception | error | |
| Error calling Jina AI API: ${error.message} | exception | error | |
| Error calling Jina AI API: ${error} | exception | error | |
| Model name cannot be updated | validation | error | |
| Failed to generate Mistral embeddings | exception | error | |
| Model name cannot be updated | validation | error | |
| API key not found. Please set ${api_key_env_var} environment | validation | error | |
| Model name cannot be updated | validation | error | |
| Failed to instantiate Ollama client | exception | error | |
| Model name cannot be updated | validation | error | |
| Model name cannot be updated | validation | error | |
| Failed to generate Perplexity embeddings | exception | error | |
| Model name cannot be updated | validation | error | |
| Keyword argument '${key}' has a value of type '${typeof valu | validation | error | |
| model_name, device, and normalize_embeddings are required | validation | error | |
| Model name cannot be updated | validation | error | |
| Failed to generate VoyageAI embeddings | exception | error | |
| Model name cannot be updated | validation | error | |
| Unsupported architecture on macOS: ${arch} | exception | error | |
| Unsupported architecture on Linux: ${arch} | exception | error | |
| Unsupported Windows architecture: ${arch}. Only ARM64 is sup | exception | error | |
| Unsupported platform: ${platform} | exception | critical | native-bindings, platform-support, module-load, embedded |
| Your API key does not have access to any DBs for tenant ${th | exception | error | auth, cloud, tenant, api-key, authorization |
| Your API key is scoped to more than 1 DB. Please provide a D | validation | error | cloud, configuration, api-key, database, validation |
| tenant and database must be set on the client before calling | validation | error | configuration, synchronous-api, collection-handle, validation |
| Failed to connect to chromadb. Make sure your server is runn | exception | error | network, connection, cors, dns, server-not-running |
| Failed to connect to Chroma | exception | error | network, tls, proxy, fetch, connection |
| Bad request to ${(input as Request).url || "Chroma"} with st | http | error | http-400, validation, server-response, version-skew |
| Unauthorized | http | error | auth, http-401, api-key, credentials |
| You do not have permission to access the requested resource. | http | error | auth, http-403, rbac, permissions |
| The requested resource could not be found | http | error | http-404, not-found, collection, lifecycle |
| conditional write conflict | http | warning | http-409, concurrency, optimistic-concurrency, retryable |
| The resource already exists | http | error | http-409, duplicate, collection, uniqueness |
| stale read | http | warning | http-412, consistency, session, retryable |
| Precondition Failed | http | error | http-412, precondition, versioning, concurrency |
| Quota exceeded | http | error | http-422, quota, billing, cloud, rate-limits |
| Unprocessable Entity | http | error | http-422, validation, server-response, payload |
| Unprocessable Entity: ${response.statusText} | http | error | http-422, proxy, unparseable-body, gateway |
| Backoff and retry | http | warning | http-429, rate-limit, throttling, retryable, cloud |
| Rate limit exceeded | http | warning | http-429, rate-limit, retryable, throttling |
| ${response.status}: ${response.statusText} | http | error | http-5xx, server-error, gateway, retryable, transient |
| Failed to fetch package data: ${response.statusText} | exception | error | |
| Missing API key. Please provide it to the CloudClient constr | validation | error | |
| Cannot specify both HNSW and SPANN configurations | validation | error | |
| Invalid HNSW config provided in UpdateCollectionConfiguratio | validation | error | |
| Invalid SPANN config provided in UpdateCollectionConfigurati | validation | error | |
| No embedding function found for collection '${this._name}'. | validation | error | |
| Sparse embedding function returned unexpected number of embe | validation | error | |
| Embedding function returned unexpected number of embeddings. | validation | error | |
| Cannot embed string query for key '${key}': schema is not av | validation | error | |
| Cannot embed string query for key '${key}': key not found in | validation | error | |
| Cannot embed string query for key '${key}': no embedding fun | validation | error | |
| limit must be a non-negative integer | validation | error | |
| limit can only be specified when a where or whereDocument cl | validation | error | |
| At least one search payload must be provided. | validation | error | |
| maxRetries must be a non-negative integer | validation | error | |
| txn.commit() cannot be called inside run() | validation | error | |
| transactional filter reads require a positive limit | validation | error | |
| transactional get response did not include an OCC read token | exception | error | |
| transactional read token offset ${actualReadToken} is not a | exception | error | |
| transactional read token changed from log upper bound offset | exception | error | |
| transactional read token changed from log upper bound offset | exception | error | |
| transactional write request contains duplicate id "${id}" | validation | error | |
| transaction already has a buffered write for id "${id}" | validation | error | |
| transactional add for id "${id}" requires a prior read provi | validation | error | |
| transactional update for id "${id}" requires a prior read pr | validation | error | |
| transactional delete for id "${id}" requires a prior read pr | validation | error | |
| conditional transaction is closed | validation | error | |
| This operation requires an embedding function, which is not | validation | error | |
| modify() is not supported on a collection obtained via clien | validation | error | |
| fork() is not supported on a collection obtained via client. | validation | error | |
| Embedding function with name ${name} is already registered. | validation | error | |
| Sparse embedding function with name ${name} is already regis | validation | error | |
| Embedding function provided when already defined in the coll | validation | error | chroma, embedding-function, configuration, createcollection |
| Aggregate input must be an Aggregate instance or object with | validation | error | chroma, group-by, aggregate, typeerror |
| MinK keys cannot be empty | validation | error | chroma, group-by, mink, validation |
| MinK k must be positive | validation | error | chroma, group-by, mink, numeric |
| MaxK keys cannot be empty | validation | error | chroma, group-by, maxk, validation |
| MaxK k must be positive | validation | error | chroma, group-by, maxk, numeric |
| GroupBy keys cannot be empty | validation | error | chroma, group-by, validation |
| GroupBy requires 'keys' array | validation | error | chroma, group-by, json, validation |
| GroupBy requires 'aggregate' | validation | error | chroma, group-by, json, validation |
| GroupBy input must be a GroupBy instance or plain object | validation | error | chroma, group-by, typeerror |
| K.DOCUMENT.contains requires a string value | validation | error | chroma, where-filter, document, typeerror |
| K.DOCUMENT.notContains requires a string value | validation | error | chroma, where-filter, document, typeerror |
| $regex requires a string pattern | exception | error | chroma, where-filter, regex, typeerror |
| $not_regex requires a string pattern | exception | error | chroma, where-filter, regex, typeerror |
| Limit offset must be a non-negative integer | exception | error | chroma, limit, pagination, numeric |
| Limit must be a positive integer when provided | exception | error | chroma, limit, pagination, numeric |
| Invalid limit input | exception | error | chroma, limit, typeerror |
| ${message} | exception | error | chroma, rank, knn, numeric |
| Rank input must be a RankExpression, number, or plain object | exception | error | chroma, rank, expression, typeerror |
| Dense query vector values must be finite numbers | exception | error | chroma, knn, embedding-vector, numeric |
| Knn limit must be a positive integer | exception | error | knn, limit, input-validation, rank-expression, client-side |
| Knn key must be a string or Key instance | exception | error | knn, key, input-validation, type-error, client-side |
| Knn default must be a finite number | exception | error | knn, default, nan, infinity, input-validation |
| ${context} must be a rank expression | exception | error | rank-expression, null-operand, undefined-operand, input-validation |
| Rrf k must be a positive integer | exception | error | rrf, k, input-validation, rank-expression, client-side |
| Rrf requires at least one rank expression | exception | error | rrf, ranks, empty-array, input-validation |
| Number of weights must match number of ranks | exception | error | rrf, weights, length-mismatch, input-validation |
| Weights must be non-negative numbers | exception | error | rrf, weights, negative-value, input-validation |
| Weights must sum to a positive value when normalize=true | exception | error | rrf, weights, normalization, zero-division |
| Sum requires at least one rank expression | exception | error | sum, rank-expression, empty-arguments, input-validation |
| Mul requires at least one rank expression | exception | error | mul, rank-expression, empty-arguments, input-validation |
| Max requires at least one rank expression | exception | error | max, rank-expression, empty-arguments, input-validation |
| Min requires at least one rank expression | exception | error | min, rank-expression, empty-arguments, input-validation |
| Select keys must be strings or Key instances | exception | error | select, keys, input-validation, type-error, client-side |
| Unsupported select input | exception | error | select, input-validation, unsupported-input, client-side |
| Where input must be a WhereExpression or plain object | exception | error | where, filter, input-validation, type-error, client-side |
| $and cannot be combined with other keys | exception | error | where, and, query-filter, input-validation |
| $and must be a non-empty array | exception | error | where, and, empty-array, query-filter, input-validation |
| Invalid where clause at index ${index} | exception | error | where, and, null-clause, query-filter, input-validation |
| $or cannot be combined with other keys | exception | error | where, or, query-filter, input-validation |
| $or must be a non-empty array | exception | error | where-filter, query-validation, chroma, javascript |
| Where dictionary must contain exactly one field | exception | error | where-filter, query-validation, chroma, javascript |
| Operator dictionary for field "${field}" must contain exactl | exception | error | where-filter, range-query, query-validation, chroma |
| Unsupported where operator: ${operator} | exception | error | where-filter, unsupported-operator, query-validation, chroma |
| Unsupported or missing CMEK provider in data: ${JSON.stringi | exception | error | cmek, encryption, config-parsing, chroma |
| Cannot enable all index types globally. Must specify either | exception | error | schema, index-config, chroma, typescript |
| Cannot create index on special key '${key}'. This key is man | exception | error | schema, index-config, reserved-key, chroma |
| Cannot create index on special key '${key}' with this config | exception | error | schema, index-config, full-text-search, chroma |
| key cannot begin with '#'. Keys starting with '#' are reserv | exception | error | schema, index-config, reserved-key, naming, chroma |
| Vector index cannot be enabled on specific keys. Use createI | exception | error | schema, index-config, vector-index, chroma |
| FTS index can only be enabled on #document key. Use createIn | validation | error | schema, index-config, full-text-search, chroma |
| Sparse vector index must be created on a specific key. Pleas | validation | error | schema, index-config, sparse-vector, chroma |
| Cannot enable all index types for key '${key}'. Please speci | validation | error | schema, index-config, chroma, typescript |
| Cannot disable all indexes. Must specify either config or ke | validation | error | schema, index-config, teardown, chroma |
| Cannot modify #embedding. Currently not supported | validation | error | schema, index-config, reserved-key, chroma |
| Cannot delete index on special key '${key}' with this config | validation | error | schema, index-config, full-text-search, chroma |
| Deleting vector index is not currently supported. | validation | error | schema, index-config, vector-index, unsupported-operation, chroma |
| Deleting sparse vector index is not currently supported. | validation | error | schema, index-config, sparse-vector, unsupported-operation, chroma |
| Deleting FTS index is only supported on #document key. | validation | error | chromadb, schema, fts, index-management, client-side-validation |
| Cannot disable all index types for key '${key}'. Please spec | validation | error | chromadb, schema, index-management, client-side-validation |
| Cannot enable all indexes for special key '${key}'. These ke | validation | error | chromadb, schema, index-management, reserved-keys |
| Cannot disable all indexes for special key '${key}'. These k | validation | error | chromadb, schema, index-management, reserved-keys |
| If sourceKey is provided then embeddingFunction must also be | validation | error | chromadb, schema, sparse-vectors, embedding-function, index-management |
| At least one of ${recordSetFields.join(", ")} must be provid | validation | error | chromadb, validation, recordset, client-side-validation |
| Non-empty lists are required for ${zeroLength.join(", ")} | validation | error | chromadb, validation, recordset, empty-array |
| Unequal lengths for fields ${lengths.map(([field, _]) => fie | validation | error | chromadb, validation, recordset, length-mismatch |
| Expected '${fieldName}' to be an array, but got ${typeof emb | validation | error | chromadb, validation, embeddings, type-mismatch |
| Expected embeddings to be an array with at least one item | validation | error | chromadb, validation, embeddings, empty-array |
| Expected each embedding to be an array of numbers | validation | warning | chromadb, validation, embeddings, client-bug, dead-code |
| Expected each embedding to be a non-empty array of numbers, | validation | error | chromadb, validation, embeddings, empty-array |
| Expected '${fieldName}' to be an array, but got ${typeof doc | validation | error | chromadb, validation, documents, type-mismatch |
| Expected '${fieldName}' to be a non-empty list | validation | error | chromadb, validation, documents, empty-array |
| Expected each document to be a string, but got ${typeof docu | validation | error | chromadb, validation, documents, null-handling |
| Expected 'ids' to be an array, but got ${typeof ids} | validation | error | chromadb, validation, ids, type-mismatch |
| Expected 'ids' to be a non-empty list | validation | error | chromadb, validation, ids, empty-array |
| Found non-string IDs at ${nonStrings.join(", ")} | validation | error | chromadb, validation, ids, type-mismatch |
| Expected IDs to be unique, but found duplicates of ${duplica | validation | error | chromadb, validation, ids, duplicates |
| Expected IDs to be unique, but found duplicates of ${duplica | validation | error | chromadb, validation, ids, duplicates, large-batch |
| Expected metadata to be non-empty | validation | error | metadata, validation, javascript, chroma |
| Expected metadata list value for key '${key}' to be non-empt | validation | error | metadata, arrays, validation, javascript |
| Expected metadata list value for key '${key}' to contain onl | validation | error | metadata, type-error, validation, javascript |
| Expected metadata list value for key '${key}' to contain onl | validation | error | metadata, type-error, validation, javascript |
| Expected metadata value for key '${key}' to be a string, num | validation | error | metadata, type-error, validation, javascript |
| Expected metadatas to be an array, but got ${typeof metadata | validation | error | metadata, validation, javascript, type-error |
| At least one of '${embeddingsField}' and '${documentsField}' | validation | error | records, validation, embeddings, documents |
| Record set length ${recordSetLength} exceeds max batch size | validation | error | batching, limits, bulk-import, validation |
| Expected where to be a non-empty object | validation | error | where-filter, validation, query, javascript |
| Expected 'where' to have exactly one operator, but got ${Obj | validation | error | where-filter, validation, query |
| Expected 'where' value to be a string, number, boolean, or a | validation | error | where-filter, validation, type-error |
| Expected 'where' value for $and or $or to be a list of 'wher | validation | error | where-filter, validation, logical-operators |
| Expected operator expression to have one operator, but got $ | validation | error | where-filter, validation, range-query |
| Expected operand value to be a number for ${operator}, but g | validation | error | where-filter, type-error, validation |
| Expected operand value to be an array for ${operator}, but g | validation | error | where-filter, validation, set-operators |
| Expected operand value to be a string, number, or boolean fo | validation | error | where-filter, validation, contains |
| Expected operator to be one of $gt, $gte, $lt, $lte, $ne, $e | validation | error | where-filter, validation, unsupported-operator |
| Expected operand value to be a string, number, boolean, or a | validation | error | where-filter, validation, null-handling |
| Expected 'where' operand value to be a non-empty list and al | validation | error | where-filter, validation, arrays |
| Expected 'whereDocument' to be a non-empty object | validation | error | where-document, validation, query |
| Expected 'whereDocument' to have exactly one operator, but g | validation | error | javascript, typescript, validation, where-document, filters |
| Expected 'whereDocument' operator to be one of $contains, $n | validation | error | javascript, typescript, validation, where-document, operators |
| Expected operand for ${operator} to be a list of 'whereDocum | validation | error | javascript, typescript, validation, where-document, logical-operators |
| Expected 'whereDocument' operand for ${operator} to be a lis | validation | error | javascript, typescript, validation, where-document, logical-operators |
| Expected operand for ${operator} to be a non empty string, b | validation | error | javascript, validation, where-document, edge-case |
| Expected 'include' to be a non-empty array | validation | error | javascript, typescript, validation, include, query-options |
| Expected 'include' items to be strings | validation | error | javascript, typescript, validation, include, type-mismatch |
| Expected 'include' items to be one of ${validValues.join(", | validation | error | javascript, typescript, validation, include, enum |
| ${item} is not allowed for this operation | validation | error | javascript, validation, include, get-vs-query |
| Expected 'nResults' to be a number, but got ${typeof nResult | validation | error | javascript, typescript, validation, nresults, type-mismatch |
| Number of requested results has to positive | validation | error | javascript, validation, nresults, query-options |
| Invalid URL: ${path} | validation | error | javascript, url, connection, validation, deprecated-api |
| [91mYour system has an unsupported version of sqlite3. Chro | exception | critical | python, sqlite, environment, import-error, version-check |
| Chroma server host provided in settings[{settings.chroma_ser | validation | error | python, configuration, connection, settings, env-vars |
| Chroma server http port provided in settings[{settings.chrom | validation | error | python, configuration, connection, settings, env-vars |
| Missing required arguments: {', '.join([arg.name for arg in | validation | error | python, cloud, authentication, api-key, env-vars |
| Conditional transactions are only supported when connecting | exception | error | python, client-mode, transactions, not-implemented, embedded-vs-server |
| AsyncClient cannot be created synchronously. Use .from_syste | exception | error | python, asyncio, client-construction, not-implemented |
| Could not connect to a Chroma server. Are you sure it is run | validation | error | chroma, connection, async, http-client, client-init, tenant |
| Could not connect to tenant {tenant}. Are you sure it exists | validation | error | chroma, tenant, error-mapping, proxy, async |
| Invalid URL. Unrecognized protocol - {parsed.scheme}. | validation | error | chroma, url, configuration, input-validation, host |
| Invalid URL. Seems that you are trying to pass URL as a host | validation | error | chroma, url, configuration, input-validation, host |
| Chroma error response missing required 'message' field: {res | http | error | chroma, http, error-mapping, version-mismatch, proxy |
| {resp.text} (trace ID: {trace_id}) | http | error | chroma, http, error-mapping, proxy, gateway |
| Conditional transactions are only supported when connecting | exception | error | chroma, conditional-transactions, client-mode, not-implemented |
| Could not determine a tenant from the current authentication | exception | error | chroma, authentication, tenant, rbac, client-init |
| Could not determine a database name from the current authent | exception | error | chroma, authentication, database, rbac, client-init |
| Could not connect to a Chroma server. Are you sure it is run | exception | error | chroma, connection, http-client, client-init, sync |
| Could not connect to tenant {tenant}. Are you sure it exists | exception | error | chroma, tenant, error-mapping, proxy, sync |
| hnsw and spann cannot both be provided | validation | error | chroma, collection-configuration, hnsw, spann, vector-index |
| Embedding function name not found in config: {ef_config} | validation | error | chroma, collection-configuration, embedding-function, deserialization |
| Embedding function {ef_name} not found. Add @register_embedd | validation | error | chroma, embedding-function, registry, custom-ef, collection-configuration |
| Could not build embedding function {ef_config['name']} from | validation | error | chroma, embedding-function, config-validation, deserialization, version-mismatch |
| not a valid hnsw config: {e} | validation | info | chroma, collection-configuration, hnsw, dead-code, vector-index |
| not a valid spann config: {e} | validation | info | chroma, collection-configuration, spann, dead-code, vector-index |
| not a valid space: {space_value} | validation | error | chroma, hnsw, configuration, vector-space, distance-metric, create-collection |
| Cannot update embedding function: incompatible types ({exist | validation | error | chroma, embedding-function, modify-collection, incompatible-types, configuration |
| Multiple embedding functions provided. Please provide only o | validation | error | chroma, embedding-function, create-collection, conflict, configuration |
| An embedding function already exists in the collection confi | validation | error | chroma, embedding-function, get-collection, conflict, configuration |
| Schema is missing defaults.float_list.vector_index | validation | error | chroma, schema, vector-index, modify-collection, internal-invariant |
| Schema is missing keys[{embedding_key}] | validation | error | chroma, schema, embedding-key, modify-collection, internal-invariant |
| Schema is missing keys[{embedding_key}].float_list.vector_in | validation | error | chroma, schema, vector-index, embedding-key, modify-collection |
| Trying to update HNSW config but schema has SPANN | validation | error | chroma, hnsw, spann, modify-collection, index-type-mismatch |
| Trying to update SPANN config but schema has HNSW | validation | error | chroma, spann, hnsw, modify-collection, index-type-mismatch |
| conditional transaction is closed | validation | error | chroma, transaction, conditional-http, state-management, client-api |
| conditional transaction cannot span collections | validation | error | chroma, transaction, conditional-http, multi-collection, scope-violation |
| conditional transaction has no collection scope | validation | error | chromadb, transaction, http-client, internal-invariant, commit |
| transactional filter reads require a positive limit | validation | error | chromadb, transaction, get, limit, occ |
| transactional write request contains duplicate id "{id}" | exception | error | chromadb, transaction, duplicate-ids, write-buffer |
| transaction already has a buffered write for id "{id}" | exception | error | chromadb, transaction, write-buffer, duplicate-ids, occ |
| transactional add for id "{id}" requires a prior read provin | exception | error | chromadb, transaction, add, read-before-write, occ |
| transactional update for id "{id}" requires a prior read pro | exception | error | chromadb, transaction, update, read-before-write, occ |
| transactional delete for id "{id}" requires a prior read pro | exception | error | chromadb, transaction, delete, read-before-write, occ |
| invalid conditional transaction for HTTP client | exception | error | chromadb, transaction, http-client, type-check |
| Invalid parameter name: {parameter.name} | validation | error | chromadb, configuration, parameter-names, serialization |
| Invalid configuration type: {parameter.value} | validation | error | chromadb, configuration, nested-config, serialization, type-discriminator |
| Invalid parameter value: {parameter.value} | validation | error | chromadb, configuration, type-mismatch, serialization |
| Invalid parameter name: {name} for configuration {self.__cla | validation | error | chromadb, configuration, parameter-names, lookup |
| Invalid parameter name: {name} | validation | error | chromadb, configuration, parameter-names, mutation |
| Cannot set static parameter: {name} | validation | error | chromadb, configuration, static-parameter, immutability, hnsw |
| Invalid value for parameter {name}: {value} | validation | error | chromadb, configuration, value-validation, mutation |
| Unable to decode configuration from JSON string: {json_str} | validation | error | chromadb, configuration, json, deserialization |
| Trying to instantiate configuration of type {cls.__name__} f | validation | error | chromadb, configuration, serialization, type-discriminator |
| batch_size must be less than or equal to sync_threshold | validation | error | chromadb, configuration, hnsw, batch-size, sync-threshold, invariant |
| Invalid legacy HNSW parameter name: {name} | validation | error | chromadb, configuration, hnsw, legacy-migration, metadata |
| ids must be provided for transactional delete | validation | error | transactions, delete, input-validation, async |
| txn.commit() cannot be called inside run() | exception | error | transactions, commit, api-misuse, async |
| You must set a data loader on the collection if loading from | validation | error | data-loader, uris, get, collection-config |
| At least one of ids, where, or where_document must be provid | validation | error | delete, input-validation, where-filter |
| limit must be a non-negative integer | validation | error | limit, type-validation, delete |
| limit can only be specified when a where or where_document c | validation | error | limit, delete, parameter-conflict |
| Changing the distance function of a collection once it is cr | validation | error | metadata, hnsw, distance-function, modify, immutable-config |
| Sparse embedding function returned unexpected number of embe | validation | error | sparse-embeddings, custom-embedding-function, count-mismatch, upsert |
| Record does not contain any non-None fields that can be embe | validation | error | embeddings, upsert, input-validation, empty-input |
| You must provide an embedding function to compute embeddings | validation | error | embeddings, embedding-function, configuration |
| Embedding function returned unexpected number of embeddings | validation | error | embeddings, knn-query, custom-embedding-function, count-mismatch |
| Cannot embed string query for key '{key}': key not found in | validation | error | schema, knn-query, vector-search, key-not-found |
| Sparse embedding function returned unexpected number of embe | validation | error | sparse-embeddings, knn-query, custom-embedding-function, count-mismatch |
| Cannot embed string query for key '{key}': no embedding func | validation | error | schema, knn-query, embedding-function, configuration |
| max_retries must be a non-negative integer | validation | error | transactions, retry, input-validation, configuration |
| ids must be provided for transactional delete | validation | error | transactions, delete, input-validation |
| txn.commit() cannot be called inside run() | validation | error | chroma, transaction, api-misuse, python |
| Collection forking is not implemented for Local Chroma | exception | error | chroma, embedded-mode, rust-bindings, fork, not-implemented |
| Fork count is not implemented for Local Chroma | exception | error | chroma, embedded-mode, rust-bindings, fork-count, not-implemented |
| Indexing status is not implemented for Local Chroma | exception | error | chroma, embedded-mode, rust-bindings, indexing-status, not-implemented |
| Search is not implemented for Local Chroma | exception | error | chroma, embedded-mode, rust-bindings, search, not-implemented |
| Conditional transactions are only supported when connecting | exception | error | chroma, embedded-mode, rust-bindings, transaction, not-implemented |
| Attached functions are only supported when connecting to a C | exception | error | chroma, embedded-mode, rust-bindings, attached-functions, not-implemented |
| Expected collection name that (1) contains 3-63 characters, | validation | error | chroma, collection-name, validation, python |
| Database name must be at least 3 characters long | validation | error | chroma, database-name, validation, python |
| Tenant name must be at least 3 characters long | validation | error | chroma, tenant-name, validation, python |
| Collection forking is not implemented for SegmentAPI | exception | error | chroma, embedded-mode, segment-api, fork, not-implemented |
| Fork count is not implemented for SegmentAPI | exception | error | chroma, embedded-mode, segment-api, fork-count, not-implemented |
| Indexing status is not implemented for SegmentAPI | exception | error | chroma, segment-api, embedded, not-implemented, indexing-status |
| Search is not implemented for SegmentAPI | exception | error | chroma, segment-api, embedded, not-implemented, vector-search |
| Collection {name} does not exist. | validation | error | chroma, delete-collection, not-found, value-error |
| You must provide either ids, where, or wher | validation | error | chroma, delete, empty-filter, validation, guard-clause |
| limit must be a non-negative integer | validation | error | chroma, delete, limit, parameter-validation, type-coercion |
| limit can only be specified when a where or where_document c | validation | error | chroma, delete, limit, parameter-combination |
| Conditional transactions are not supported by SegmentAPI | exception | error | chroma, transactions, not-implemented, embedded, segment-api |
| Attached functions are only supported when connecting to a C | exception | error | chroma, attached-functions, not-implemented, embedded, server-only |
InvalidDimension Embedding dimension {dim} does not match collection dimensionality {collection[' | exception | error | chroma, embeddings, dimension-mismatch, invalid-dimension, add |
| An instance of Chroma already exists for {identifier} with d | validation | error | chroma, client, settings, singleton, persistent-client |
| Chroma API implementation must be set in settings | validation | error | chroma, settings, configuration, api-impl, client-construction |
| Unsupported Chroma API implementation {api_impl} | validation | error | chroma, settings, configuration, api-impl, version-migration |
| Expected Embeddings to be non-empty list or numpy array, got | validation | error | chroma, embeddings, empty-input, validation, add |
| Expected embeddings to be a list of floats or ints, a list o | validation | error | chroma, embeddings, type-validation, numpy, input-format |
| At least one of one of {', '.join(record_set.keys())} must b | validation | error | chroma, record-set, validation, missing-fields, add |
| Non-empty lists are required for {zero_lengths} | validation | error | chroma, record-set, validation, empty-list, add |
| Unequal lengths for fields: {error_str} | validation | error | chromadb, python, validation, batch-insert, argument-mismatch |
| Attempting to embed a record that already has embeddings. | validation | error | chromadb, python, embeddings, validation, internal-api |
| At least one of {', '.join(contains_any)} must be provided | validation | error | chromadb, python, validation, record-set, internal-api |
| Exactly one of {', '.join(contains_one)} must be provided | validation | error | chromadb, python, embeddings, add, query, validation |
| Invalid field in contains: {', '.join(contains)}, available | validation | error | chromadb, python, validation, internal-api, field-names |
| Expected EmbeddingFunction.__call__ to have the following si | validation | error | chromadb, python, embedding-function, interface, migration |
| Expected IDs to be a list, got {type(ids).__name__} as IDs | validation | error | chromadb, python, ids, validation, type-check |
| Expected IDs to be a non-empty list, got {len(ids)} IDs | validation | error | chromadb, python, ids, empty-input, validation |
| Expected ID to be a str, got {id_} | validation | error | chromadb, python, ids, type-coercion, validation |
| Expected metadata list value for key '{key}' to be non-empty | validation | error | chromadb, python, metadata, lists, validation |
| Expected metadata list value for key '{key}' to contain only | validation | error | chromadb, python, metadata, lists, type-safety, validation |
| Expected metadata to be a dict or None, got {type(metadata). | validation | error | chromadb, python, metadata, type-check, validation |
| Expected metadata to be a non-empty dict, got {len(metadata) | validation | error | chromadb, python, metadata, empty-dict, validation |
| Expected metadata to not contain the reserved key {META_KEY_ | validation | error | chromadb, python, metadata, reserved-keys, validation |
| Expected metadata key to be a str, got {key} which is a {typ | validation | error | chromadb, python, metadata, type-error, keys, validation |
| Expected metadata value to be a str, int, float, bool, Spars | validation | error | chromadb, python, metadata, type-safety, validation |
| Expected metadata to be a dict or None, got {type(metadata)} | validation | error | chromadb, python, metadata, update, type-check, validation |
| Expected metadata to be a non-empty dict, got {metadata} | validation | error | chromadb, python, metadata, update, empty-dict, validation |
| Expected metadata key to be a str, got {key} | validation | error | chromadb, python, metadata, update, keys, validation |
| Expected metadata value to be a str, int, float, bool, Spars | validation | error | chromadb, python, metadata, update, type-safety, validation |
| Expected metadatas to be a list, got {metadatas} | validation | error | chromadb, validation, metadata, ingestion |
| Expected where to be a dict, got {where} | validation | error | chromadb, validation, where-filter, query |
| Expected where to have exactly one operator, got {where} | validation | error | chromadb, validation, where-filter, query |
| Expected document value for $and or $or to be a list with at | validation | error | chromadb, where-document, query-filter, input-validation |
| Expected where document operand value for operator {operator | validation | error | chromadb, where-document, type-mismatch, input-validation |
| Expected where document operand value for operator {operator | validation | error | chromadb, where-document, empty-string, input-validation |
| Expected include to be a list, got {include} | validation | error | chromadb, include-parameter, type-mismatch, input-validation |
| Expected include item to be a str, got {item} | validation | error | chromadb, include-parameter, type-mismatch, input-validation |
| Expected include item to be one of {', '.join(valid_items)}, | validation | error | chromadb, include-parameter, invalid-value, typo |
| Include item cannot be one of {', '.join(dissalowed)}, got { | validation | error | chromadb, include-parameter, distances, get-vs-query |
| Expected requested number of results to be a int, got {n_res | validation | error | chromadb, n-results, top-k, type-mismatch |
| Number of requested results {n_results}, cannot be negative, | validation | error | chromadb, n-results, top-k, type-error |
| Expected embeddings to be a list, got {type(embeddings).__na | validation | error | chromadb, embeddings, type-mismatch, input-validation |
| Expected embeddings to be a list with at least one item, got | validation | error | chromadb, embeddings, empty-list, batching |
| Expected each embedding in the embeddings to be a numpy arra | validation | error | chromadb, embeddings, numpy, type-mismatch |
| Expected a 1-dimensional array, got a 0-dimensional array {e | validation | error | chromadb, embeddings, numpy, dimensionality |
| Expected each embedding in the embeddings to be a 1-dimensio | validation | error | chromadb, embeddings, empty-array, numpy |
| Expected each value in the embedding to be a int or float, g | validation | error | chromadb, embeddings, dtype, numpy |
| Expected sparse vectors to be a list, got {type(vectors).__n | validation | error | chromadb, sparse-vectors, hybrid-search, type-mismatch |
| Expected sparse vectors to be a non-empty list, got {len(vec | validation | error | chromadb, sparse-vectors, empty-list, batching |
| Expected SparseVector instance at position {i}, got {type(ve | validation | error | chromadb, sparse-vectors, type-mismatch, isinstance |
| Expected documents to be a list, got {type(documents).__name | validation | error | chromadb, documents, type-mismatch, input-validation |
| Expected documents to be a non-empty list, got {len(document | validation | error | chromadb, documents, empty-list, batching |
| Expected document to be a str, got {document} | validation | error | |
| Expected images to be a list, got {type(images).__name__} | validation | error | |
| Expected images to be a non-empty list, got {len(images)} im | validation | error | |
| Expected image to be a numpy array, got {image} | validation | error | |
| Batch size {len(batch[0])} exceeds maximum batch size {limit | validation | error | |
| Expected SparseEmbeddingFunction.__call__ to have the follow | validation | error | |
invalid_field '{invalid_fields[0]}' is not a valid field for {class_name}. | validation | error | |
| source_key must be str or Key, got {type(v).__name__} | validation | error | |
| source_key cannot begin with '#'. The only valid key startin | validation | error | |
| embedding_function must be callable or None | validation | error | |
| embedding_function must be a callable SparseEmbeddingFunctio | validation | error | |
| Unknown CMEK provider: {self.provider} | validation | error | |
| CMEK gcp resource must be a string, got: {type(resource)} | validation | error | |
| Unsupported or missing CMEK provider in data: {data} | validation | error | |
| Cannot enable all index types globally. Must specify either | validation | error | |
| Cannot create index on special key '{key}'. This key is mana | validation | error | |
| Cannot create index on special key '{key}' with this config. | validation | error | |
| Invalid Authorization header format | exception | error | |
| Invalid username or password | exception | error | |
| Forbidden | http | error | |
| Forbidden | http | error | |
| Invalid token. Must contain only ASCII letters, digits, and | validation | error | |
| Invalid token transport header: {token_header}. Must be one | validation | error | |
| User missing tokens | validation | error | |
| Token {token} already in use: wanted to use it for user {use | validation | error | |
| Authorization header '{self._token_transport_header.value}' | exception | error | |
| Bearer not found in Authorization header | exception | error | |
| Invalid credentials: Token not found} | exception | error | |
| Forbidden | http | error | |
| Tenant {user_provided_tenant} does not match {new_tenant} fr | http | error | |
| Database {user_provided_database} does not match {new_databa | http | error | |
| Expected SparseVector indices to be a list, got {type(self.i | validation | error | |
| Expected SparseVector values to be a list, got {type(self.va | validation | error | |
| SparseVector indices and values must have the same length, g | validation | error | |
| Expected SparseVector labels to be a list, got {type(self.la | validation | error | |
| SparseVector labels must have the same length as indices and | validation | error | |
| SparseVector indices must be integers, got {type(idx).__name | validation | error | sparse-vector, type-validation, numpy, python |
| SparseVector indices must be non-negative, got {idx} at posi | validation | error | sparse-vector, index-validation, data-quality |
| SparseVector values must be numbers, got {type(val).__name__ | validation | error | sparse-vector, type-validation, numpy |
| SparseVector indices must be sorted in strictly ascending or | validation | error | sparse-vector, sort-order, duplicates |
| Expected #type='sparse_vector', got {d.get(TYPE_KEY)} | validation | error | sparse-vector, serialization, wire-format |
| Missing required config value '{key}' | validation | error | configuration, settings, env-vars |
| [91mYou are using a deprecated configuration of Chroma. [ | validation | error | configuration, migration, deprecated, upgrade |
| Chroma is running in http-only client mode, and can only be | exception | error | client-mode, thin-client, configuration, runtimeerror |
| Resetting is not allowed by this configuration (to enable it | validation | error | configuration, reset, guard, settings |
| Resetting the database is not allowed. Set `allow_reset` to | validation | error | sqlite, reset, configuration, guard |
| Migrations have not been initialized | exception | error | migrations, database, startup, sqlite |
| Unapplied migrations in {dir}, starting with version {versio | exception | error | migrations, schema-upgrade, version-mismatch |
| Invalid migration filename: {filename} | exception | error | migrations, file-naming, convention |
| Inconsistent migration versions in {dir}:db version was {db_ | exception | critical | migrations, version-mismatch, schema, data-integrity |
| Inconsistent hashes in {path}:db hash was {db_hash}, source | exception | critical | chroma, sqlite, migrations, schema-drift, startup |
| No migration file found for dir {file['dir']} with filename | exception | error | chroma, migrations, packaging, file-not-found, install |
| Invalid hash algorithm specified: {alg} | exception | error | chroma, migrations, config, hash, invalid-value |
| Component not running | exception | error | chroma, internal-api, lifecycle, runtime-error, embeddings-queue |
BatchSizeExceededError Cannot submit more than {max_batch_size:,} embeddings at once.
Please submit you | exception | error | chroma, internal-api, embeddings-queue, batching, sqlite-limits |
| SeqIDs must be integers for sql-based EmbeddingsDB | validation | error | |
| Invalid SeqID range: {start} to {end} | validation | error | |
UniqueConstraintError Database {name} already exists for tenant {tenant} | exception | error | |
NotFoundError Database {name} not found for tenant {tenant}. Are you sure it exists? | exception | error | |
| id must be specified if get_or_create is False | validation | error | |
| If name is specified, tenant and database must also be speci | validation | error | |
| Expected dict for Where, got {type(data).__name__} | validation | error | |
| Where dict cannot be empty | validation | error | |
| $and must be a list, got {type(data['$and']).__name__} | validation | error | |
| $and requires at least one condition | validation | error | |
| $and cannot be combined with other fields in the same dict | validation | error | |
| $or must be a list, got {type(data['$or']).__name__} | validation | error | |
| $or requires at least one condition | validation | error | |
| $or cannot be combined with other fields in the same dict | validation | error | |
| Where dict must contain exactly one field, got {len(data)} | validation | error | |
| Field name must be a string, got {type(field).__name__} | validation | error | |
| Operator dict for field '{field}' cannot be empty | validation | error | |
| Operator dict for field '{field}' must contain exactly one o | validation | error | |
| $in requires a list, got {type(value).__name__} | validation | error | |
| $nin requires a list, got {type(value).__name__} | exception | error | |
| $contains requires a str, int, float, or bool, got {type(val | exception | error | |
| $not_contains requires a str, int, float, or bool, got {type | exception | error | |
| $regex requires a string pattern, got {type(value).__name__} | exception | error | |
| $not_regex requires a string pattern, got {type(value).__nam | exception | error | |
| Unknown operator: {op} | exception | error | |
| $contains on #document requires a string pattern | exception | error | |
| $not_contains on #document requires a string pattern | exception | error | |
| Expected dict for Limit, got {type(data).__name__} | exception | error | validation, typeerror, pagination, limit, deserialization, chromadb |
| Limit offset must be an integer, got {type(offset).__name__} | exception | error | validation, typeerror, pagination, offset, chromadb |
| Limit offset must be non-negative, got {offset} | exception | error | validation, valueerror, pagination, offset, chromadb |
| Limit limit must be an integer, got {type(limit).__name__} | exception | error | validation, typeerror, pagination, limit, numpy, chromadb |
| Limit limit must be positive, got {limit} | exception | error | validation, valueerror, pagination, limit, chromadb |
| Unexpected keys in Limit dict: {unexpected_keys} | exception | error | validation, valueerror, pagination, schema, chromadb |
| Expected dict for Rank, got {type(data).__name__} | exception | error | validation, typeerror, rank, expression, chromadb |
| Rank dict cannot be empty | exception | error | validation, valueerror, rank, expression, chromadb |
| Rank dict must contain exactly one operator, got {len(data)} | exception | error | validation, valueerror, rank, expression, chromadb |
| $val requires a number, got {type(value).__name__} | exception | error | validation, typeerror, rank, val, chromadb |
| $knn requires a dict, got {type(knn_data).__name__} | exception | error | validation, typeerror, knn, rank, embedding, chromadb |
| $knn requires 'query' field | exception | error | validation, valueerror, knn, rank, missing-field, chromadb |
| Expected dict with {TYPE_KEY}='{SPARSE_VECTOR_TYPE_VALUE}', | exception | error | validation, valueerror, knn, sparse-vector, serialization, chromadb |
| $knn requires exactly one query embedding | exception | error | validation, valueerror, knn, embedding, batching, chromadb |
| $knn query must be a list, numpy array, or SparseVector dict | exception | error | validation, typeerror, knn, embedding, chromadb |
| $knn key must be a string, got {type(key).__name__} | exception | error | validation, typeerror, knn, key, chromadb |
| $knn limit must be an integer, got {type(limit).__name__} | exception | error | validation, typeerror, knn, top-k, chromadb |
| $knn limit must be positive, got {limit} | exception | error | validation, valueerror, knn, top-k, chromadb |
| $knn return_rank must be a boolean, got {type(return_rank)._ | exception | error | validation, typeerror, knn, boolean, config, chromadb |
| $sum requires a list, got {type(ranks_data).__name__} | exception | error | validation, typeerror, rank, sum, expression, chromadb |
| $sum requires at least 2 ranks, got {len(ranks_data)} | exception | error | chromadb, rank-expression, validation, deserialization, hybrid-search |
| $sub requires a dict with 'left' and 'right', got {type(sub_ | exception | error | chromadb, rank-expression, validation, deserialization, type-error |
| $sub requires 'left' and 'right' fields | exception | error | chromadb, rank-expression, validation, deserialization, missing-field |
| $mul requires a list, got {type(ranks_data).__name__} | exception | error | chromadb, rank-expression, validation, deserialization, type-error |
| $mul requires at least 2 ranks, got {len(ranks_data)} | exception | error | chromadb, rank-expression, validation, deserialization, hybrid-search |
| $div requires a dict with 'left' and 'right', got {type(div_ | exception | error | chromadb, rank-expression, validation, deserialization, type-error |
| $div requires 'left' and 'right' fields | exception | error | chromadb, rank-expression, validation, deserialization, missing-field |
| $abs requires a rank dict, got {type(child_data).__name__} | exception | error | chromadb, rank-expression, validation, deserialization, type-error |
| $exp requires a rank dict, got {type(child_data).__name__} | exception | error | chromadb, rank-expression, validation, deserialization, type-error |
| $log requires a rank dict, got {type(child_data).__name__} | exception | error | chromadb, rank-expression, validation, deserialization, type-error |
| $max requires a list, got {type(ranks_data).__name__} | exception | error | chromadb, rank-expression, validation, deserialization, type-error |
| $max requires at least 2 ranks, got {len(ranks_data)} | validation | error | chromadb, rank-expression, validation, deserialization, clamping |
| $min requires a list, got {type(ranks_data).__name__} | validation | error | chromadb, rank-expression, validation, deserialization, type-error |
| $min requires at least 2 ranks, got {len(ranks_data)} | validation | error | chromadb, rank-expression, validation, deserialization, clamping |
| Unknown rank operator: {op} | validation | error | chromadb, rank-expression, validation, unknown-operator, version-skew |
| RRF requires at least one rank | validation | error | chromadb, rrf, rank-expression, validation, hybrid-search |
| k must be positive, got {self.k} | validation | error | chromadb, rrf, rank-expression, validation, configuration |
| Number of weights ({len(self.weights)}) must match number of | validation | error | chromadb, rrf, rank-expression, validation, configuration, hybrid-search |
| All weights must be non-negative | validation | error | chromadb, rrf, rank-expression, validation, weights |
| Sum of weights must be positive when normalize=True | validation | error | chromadb, rrf, rank-expression, validation, weights, divide-by-zero |
| Expected dict for Select, got {type(data).__name__} | validation | error | |
| Select keys must be a list/tuple/set, got {type(keys).__name | validation | error | |
| Select key must be a string, got {type(k).__name__} | validation | error | |
| Unexpected keys in Select dict: {unexpected_keys} | validation | error | |
| {op} requires a dict, got {type(agg_data).__name__} | validation | error | |
| {op} requires 'keys' field | validation | error | |
| {op} requires 'k' field | validation | error | |
| {op} keys must be a list, got {type(keys).__name__} | validation | error | |
| {op} keys cannot be empty | validation | error | |
| {op} k must be an integer, got {type(k).__name__} | validation | error | |
| {op} k must be positive, got {k} | validation | error | |
| Expected dict for Aggregate, got {type(data).__name__} | validation | error | |
| Aggregate dict cannot be empty | validation | error | |
| Aggregate dict must contain exactly one operator, got {len(d | validation | error | |
| Unknown aggregate operator: {op} | validation | error | |
| Expected dict for GroupBy, got {type(data).__name__} | validation | error | |
| GroupBy requires 'keys' field | validation | error | |
| GroupBy requires 'aggregate' field | validation | error | |
| GroupBy keys must be a list, got {type(keys).__name__} | validation | error | |
| GroupBy keys cannot be empty | validation | error | |
| GroupBy aggregate must be a dict, got {type(aggregate_data). | validation | error | |
| where must be a Where object, dict, or None, got {type(where | validation | error | |
| rank must be a Rank object, dict, or None, got {type(rank)._ | validation | error | |
| group_by must be a GroupBy object, dict, or None, got {type( | validation | error | |
| limit must be a Limit object, dict, int, or None, got {type( | validation | error | |
| select must be a Select object, dict, list, set, or None, go | validation | error | |
| Unsupported encoding: {encoding.value} | validation | error | |
| Invalid topic name: {topic_name} | validation | error | |
| Not implemented | exception | error | |
| Resetting the database is not allowed. Set `allow_reset` to | validation | error | |
| Limit cannot be negative | validation | error | |
| Unknown where_doc operator {k} | validation | error | |
| Unknown distance function: {space} | validation | error | |
| Unknown HNSW parameter: {param} | validation | error | |
| Invalid value for HNSW parameter: {param} = {value} | validation | error | |
InvalidDimension Dimensionality of ({dim}) does not match indexdimensionality ({self._dimensional | validation | error | |
InvalidHTTPVersion HTTP version {http_version} is not supported | http | error | |
| No such key: {key}, valid keys are: {self.get_model_fields() | exception | error | |
| Could not deserialize configuration_json: {e} | validation | error | |
| The PIL python package is not installed. Please install it w | exception | error | python, pip, pillow, optional-dependency, image-loader, chromadb |
| Failed to register embedding function: {e} | validation | error | python, embedding-functions, registry, decorator, plugin-registration, chromadb |
| Failed to register sparse embedding function: {e} | validation | error | python, sparse-embedding, embedding-functions, registry, plugin-registration, chromadb |
| Config must contain a 'name' field. | validation | error | python, embedding-functions, config, validation, deserialization, chromadb |
| Unsupported embedding function: {name} | validation | error | python, embedding-functions, registry, config, unknown-name, chromadb |
| Keyword argument {key} is not a primitive type | validation | error | python, aws, bedrock, serialization, type-validation, embedding-functions, chromadb |
| The boto3 python package is not installed. Please install it | exception | error | python, aws, boto3, bedrock, optional-dependency, deserialization, chromadb |
| The model name cannot be changed after the embedding functio | validation | error | python, aws, bedrock, embedding-functions, immutable-field, collection-modify, chromadb |
| The openai python package is not installed. Please install i | exception | error | python, baseten, openai-sdk, optional-dependency, embedding-functions, chromadb |
| API key not provided and {self.api_key_env_var} environment | exception | error | python, baseten, api-key, environment-variables, credentials, chromadb |
| The api_base argument must be provided. | exception | error | python, baseten, required-argument, embedding-functions, validation, chromadb |
| Missing 'api_key_env_var' or 'api_base' in configuration for | exception | error | python, baseten, config, deserialization, required-fields, chromadb |
| Missing 'api_base' in configuration for BasetenEmbeddingFunc | exception | info | python, baseten, dead-code, config, static-analysis, chromadb |
| The fastembed python package is not installed. Please instal | exception | error | python, fastembed, bm25, sparse-embedding, optional-dependency, deprecated, chromadb |
| Keyword argument {key} is not a primitive type | exception | error | python, fastembed, bm25, serialization, type-validation, chromadb |
| Invalid task: {self.task} | exception | error | python, bm25, sparse-embedding, enum-validation, invalid-argument, chromadb |
| Invalid task: {task} | exception | error | python, bm25, sparse-embedding, enum-validation, query-config, chromadb |
| Updating '{key}' is not supported for {NAME} | exception | error | bm25, chroma, config-validation, embedding-function, immutable-config |
| The httpx python package is not installed. Please install it | exception | error | httpx, missing-dependency, chroma-cloud, qwen, python |
| API key not found in environment variable {api_key_env_var} | exception | error | api-key, env-var, chroma-cloud, qwen, credentials |
| Unknown error | exception | error | chroma-cloud, qwen, api-error, embedding-function, runtime |
| The model cannot be changed after the embedding function has | exception | error | chroma-cloud, qwen, immutable-config, config-validation, embedding-function |
| The task cannot be changed after the embedding function has | exception | error | chroma-cloud, qwen, immutable-config, config-validation, embedding-function |
| The instructions cannot be changed after the embedding funct | exception | error | chroma-cloud, qwen, immutable-config, config-validation, embedding-function |
| The httpx python package is not installed. Please install it | exception | error | httpx, missing-dependency, chroma-cloud, splade, sparse-embeddings |
| API key not found in environment variable {self.api_key_env_ | exception | error | api-key, env-var, chroma-cloud, splade, credentials |
| Failed to get embeddings from Chroma Cloud API: HTTP {e.resp | exception | error | chroma-cloud, splade, http-status-error, api-error, sparse-embeddings |
| Request to Chroma Cloud API timed out after 60 seconds | exception | error | chroma-cloud, splade, timeout, retry, sparse-embeddings |
| Failed to get embeddings from Chroma Cloud API: {e} | exception | error | chroma-cloud, splade, network, connection-error, sparse-embeddings |
| Unexpected error calling Chroma Cloud API: {e} | exception | error | chroma-cloud, splade, catch-all, json-parse, sparse-embeddings |
| model must be provided in config | exception | error | chroma-cloud, splade, config-validation, deserialization, embedding-function |
| api_key_env_var must be provided in config | exception | error | chroma-cloud, splade, config-validation, deserialization, api-key |
| Updating '{key}' is not supported for chroma-cloud-splade | exception | error | chroma-cloud, splade, immutable-config, config-validation, sparse-embeddings |
| The langchain_core python package is not installed. Please i | exception | error | langchain, missing-dependency, embedding-function, python |
| The embedding_function must implement the Embeddings interfa | exception | error | langchain, type-check, embedding-function, isinstance |
| The provided embedding function does not support image embed | exception | error | langchain, multimodal, image-embeddings, embedding-function |
| Building a ChromaLangchainEmbeddingFunction from config is n | exception | error | langchain, not-implemented, serialization, embedding-function, deserialization |
| Updating a ChromaLangchainEmbeddingFunction config is not su | exception | error | chroma, langchain, embedding-function, config-update, not-implemented |
| The httpx python package is not installed. Please install it | exception | error | chroma, cloudflare, httpx, missing-dependency, embedding-function |
| The {self.api_key_env_var} environment variable is not set. | exception | error | chroma, cloudflare, api-key, environment-variable, credentials |
| Cloudflare Workers AI only supports text documents, not imag | exception | error | chroma, cloudflare, multimodal, input-validation, embedding-function |
| Unknown error | exception | error | chroma, cloudflare, http, api-response, runtime-error |
| The model name cannot be changed after the embedding functio | exception | error | chroma, cloudflare, config-update, embedding-function, immutable-field |
| The cohere python package is not installed. Please install i | exception | error | chroma, cohere, missing-dependency, embedding-function |
| The PIL python package is not installed. Please install it w | exception | error | chroma, cohere, pillow, missing-dependency, embedding-function, multimodal |
| The {self.api_key_env_var} environment variable is not set. | exception | error | chroma, cohere, api-key, environment-variable, credentials |
| Expected image input to be a numpy array, got {type(image_np | exception | error | chroma, cohere, multimodal, numpy, input-validation |
| Failed to convert image numpy array to base64 data URI: {e} | exception | error | chroma, cohere, multimodal, pillow, numpy, image-encoding |
| Input contains a mix of text documents and images, which is | exception | error | chroma, cohere, multimodal, batch-input, input-validation |
| Input must be a list of text documents (str) or a list of im | exception | error | chroma, cohere, input-validation, type-error, embedding-function |
| The model name cannot be changed after the embedding functio | exception | error | chroma, cohere, config-update, embedding-function, immutable-field |
| trust_remote_code is not allowed as a kwarg to prevent arbit | exception | error | chroma, security, huggingface, kwargs, remote-code-execution, config-validation |
| The fastembed python package is not installed. Please instal | exception | error | chroma, fastembed, missing-dependency, sparse-embeddings, embedding-function |
| Keyword argument {key} is not a primitive type | exception | error | chroma, fastembed, kwargs, serialization, input-validation |
| Invalid task: {self.task} | exception | error | chroma, fastembed, invalid-parameter, sparse-embeddings, embedding-function |
| Invalid task: {task} | exception | error | fastembed, sparse-embeddings, chroma, query-config, invalid-parameter |
| The google-genai python package is not installed. Please ins | exception | error | google-genai, gemini, chroma, missing-dependency, importerror |
| Vertex AI and API key are mutually exclusive in the client i | exception | error | vertexai, gemini, api-key, mutually-exclusive, chroma, auth |
| The {self.api_key_env_var} environment variable must be set | exception | error | gemini, api-key, environment-variable, google-genai, chroma |
| Input documents cannot be empty | exception | error | gemini, input-validation, empty-input, chroma |
| Input must be a list or tuple of documents | exception | error | gemini, input-validation, type-error, chroma |
| All input documents must be strings | exception | error | gemini, input-validation, type-error, chroma |
| Failed to generate embeddings: {str(e)} | exception | error | gemini, api-error, rate-limit, network, google-genai, chroma |
| No embeddings returned from the API | exception | error | gemini, api-response, google-genai, chroma |
| Malformed embedding response: missing 'values' | exception | error | gemini, api-response, google-genai, chroma |
| The model name is required. | exception | error | config, build-from-config, gemini, chroma |
| The model name cannot be changed after the embedding functio | exception | error | immutable-config, collection-modify, gemini, chroma |
| The dimension cannot be changed after the embedding function | exception | error | immutable-config, embedding-dimension, gemini, chroma |
| The vertexai cannot be changed after the embedding function | exception | error | immutable-config, vertexai, gemini, chroma |
| The project cannot be changed after the embedding function h | exception | error | immutable-config, gcp-project, vertexai, chroma |
| The location cannot be changed after the embedding function | exception | error | immutable-config, gcp-region, vertexai, chroma |
| The Google Generative AI python package is not installed. Pl | exception | error | google-generativeai, gemini, chroma, missing-dependency, deprecated-sdk |
| The {self.api_key_env_var} environment variable is not set. | exception | error | google-generativeai, api-key, environment-variable, chroma |
| Google Generative AI only supports text documents, not image | exception | error | google-generativeai, input-validation, multimodal, type-error, chroma |
| The task type cannot be changed after the embedding function | exception | error | |
| Google PaLM only supports text documents, not images | exception | error | |
| The vertexai python package is not installed. Please install | exception | error | |
| Google Vertex only supports text documents, not images | exception | error | |
| The project ID cannot be changed after the embedding functio | validation | error | |
| The region cannot be changed after the embedding function ha | validation | error | |
| The httpx python package is not installed. Please install it | exception | error | |
| The {self.api_key_env_var} environment variable is not set. | validation | error | |
| The model name cannot be changed after the embedding functio | validation | error | |
| URL must be provided for HuggingFaceEmbeddingServer | validation | error | |
| The URL cannot be changed after the embedding function has b | validation | error | |
| The sentence_transformers python package is not installed. P | exception | error | |
| Keyword argument {key} is not a primitive type | validation | error | |
| Invalid task: {self.task} | validation | error | python, validation, enum, sparse-embeddings, constructor-argument |
| Invalid task: {self.query_config.get('task')} | validation | error | python, validation, enum, sparse-embeddings, query-config |
| The InstructorEmbedding python package is not installed. Ple | exception | error | python, dependency, pip, instructor-embeddings, optional-import |
| Instructor only supports text documents, not images | validation | error | python, validation, multimodal, text-only, instructor-embeddings |
| The httpx python package is not installed. Please install it | exception | error | python, dependency, pip, httpx, jina, optional-import |
| The PIL python package is not installed. Please install it w | exception | error | python, dependency, pip, pillow, jina, multimodal |
| The {self.api_key_env_var} environment variable is not set. | validation | error | python, authentication, environment-variables, jina, api-key |
| Failed to convert image numpy array to base64 data URI: {e} | exception | error | python, numpy, pillow, image-processing, jina, multimodal |
| Unknown error | exception | error | python, api, jina, remote-api, runtime-error, diagnostics |
| The model name cannot be changed after the embedding functio | validation | error | python, configuration, immutable-field, jina, config-update |
| The mistralai python package is not installed. Please instal | exception | error | python, dependency, pip, mistralai, optional-import |
| The {api_key_env_var} environment variable is not set. | validation | error | python, authentication, environment-variables, mistral, api-key |
| Mistral only supports text documents, not images | validation | error | python, validation, text-only, mistral, multimodal |
| The model cannot be changed after the embedding function has | validation | error | python, configuration, immutable-field, mistral, config-update |
| The openai python package is not installed. Please install i | exception | error | python, dependency, pip, openai, morph, optional-import |
| The {api_key_env_var} environment variable is not set. | validation | error | python, authentication, environment-variables, morph, api-key |
| The model name cannot be changed after the embedding functio | validation | error | python, configuration, immutable-field, morph, config-update |
| The nomic python package is not installed. Please install it | exception | error | python, dependency, pip, nomic, optional-import |
| The {api_key_env_var} environment variable is not set. | validation | error | nomic, embedding-function, environment-variable, api-key, chroma |
| Nomic only supports text documents, not images | validation | error | nomic, embedding-function, type-validation, documents, chroma |
| Nomic only supports text queries, not images | validation | error | nomic, embedding-function, type-validation, query, chroma |
| The model cannot be changed after the embedding function has | validation | error | nomic, embedding-function, immutable-config, config-update, chroma |
| The ollama python package is not installed. Please install i | exception | error | ollama, embedding-function, import-error, dependency, chroma |
| The model name cannot be changed after the embedding functio | validation | error | ollama, embedding-function, immutable-config, config-update, chroma |
| Preferred providers must be a list of strings | validation | error | onnx, embedding-function, config-validation, execution-providers, chroma |
| Preferred providers must be unique | validation | error | onnx, embedding-function, config-validation, duplicate-values, chroma |
| The onnxruntime python package is not installed. Please inst | exception | error | onnx, embedding-function, import-error, dependency, chroma |
| The tokenizers python package is not installed. Please insta | exception | error | onnx, embedding-function, tokenizers, import-error, dependency, chroma |
| The tqdm python package is not installed. Please install it | exception | error | onnx, embedding-function, tqdm, import-error, dependency, chroma |
| Downloaded file {fname} does not match expected SHA256 hash. | exception | critical | onnx, embedding-function, checksum, download, integrity, chroma |
| Document length {len(doc_tokens.ids)} is greater than the ma | validation | error | onnx, embedding-function, token-limit, truncation, chunking, chroma |
| Preferred providers must be subset of available providers: { | validation | error | onnx, embedding-function, execution-providers, cuda, config-validation, chroma |
| The open_clip python package is not installed. Please instal | exception | error | openclip, embedding-function, import-error, dependency, multimodal, chroma |
| The torch python package is not installed. Please install it | exception | error | openclip, torch, embedding-function, import-error, dependency, chroma |
| The PIL python package is not installed. Please install it w | exception | error | openclip, pillow, embedding-function, import-error, dependency, chroma |
| The model name cannot be changed after the embedding functio | validation | error | openclip, embedding-function, immutable-config, config-update, chroma |
| The checkpoint cannot be changed after the embedding functio | validation | error | openclip, embedding-function, immutable-config, checkpoint, chroma |
| The openai python package is not installed. Please install i | exception | error | openai, embedding-function, import-error, dependency, chroma |
| The {self.api_key_env_var} environment variable is not set. | validation | error | openai, embedding, api-key, environment-variable, chroma, constructor |
| api_version must be specified for Azure OpenAI | validation | error | azure, openai, embedding, configuration, chroma, constructor |
| deployment_id must be specified for Azure OpenAI | validation | error | azure, openai, embedding, deployment, configuration, chroma |
| api_base must be specified for Azure OpenAI | validation | error | azure, openai, embedding, endpoint, configuration, chroma |
| The model name cannot be changed after the embedding functio | validation | error | openai, embedding, model-name, immutable, collection-modify, chroma |
| The perplexityai python package is not installed. Please ins | exception | error | perplexity, embedding, dependency, import, pip, chroma |
| The {self.api_key_env_var} environment variable is not set. | validation | error | perplexity, embedding, api-key, environment-variable, chroma |
| The model name cannot be changed after the embedding functio | validation | error | perplexity, embedding, model-name, immutable, collection-modify, chroma |
| The {self.api_key_env_var} environment variable is not set. | validation | error | roboflow, embedding, api-key, environment-variable, chroma |
| The PIL python package is not installed. Please install it w | exception | error | roboflow, pillow, dependency, import, pip, chroma |
| The snowballstemmer python package is not installed. Please | exception | error | bm25, snowballstemmer, dependency, import, tokenizer, chroma |
| not implemented | panic | critical | rust, sysdb, panic, unimplemented, sqlite, grpc, chroma |
| failed to close cache: {:?} | exception | error | rust, foyer, cache, shutdown, disk, io, chroma |