chroma-core/chroma
Documented errors, page 2 of 7. Back to chroma-core/chroma
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| batch_size must be less than or equal to sync_threshold | validation | error | chromadb, configuration, hnsw, batch-size, sync-threshold, invariant |
| Failed to generate embeddings for your request. | exception | error | records, embeddings, custom-embedding-function, validation, return-value |
| Invalid configuration type | validation | error | chromadb, configuration, nested-config, serialization, type-discriminator |
| Invalid HNSW config provided in… | validation | error | configuration, validation, hnsw, type-mismatch, collection-creation |
| Unsupported select input | exception | error | select, input-validation, unsupported-input, client-side |
| The ollama python package is not installed. Please install… | exception | error | ollama, embedding-function, import-error, dependency, chroma |
| The requested resource could not be found | http | error | chromadb, aggregate, missing-field, valueerror, max-k, min-k |
| API key not found in environment variable | exception | error | api-key, env-var, chroma-cloud, qwen, credentials |
| Please install the chromadb-default-embed package to use… | exception | error | npm, optional-dependency, embeddings, module-not-found, lazy-import |
| Expected 'whereDocument' operator to be one of $contains… | validation | error | javascript, typescript, validation, where-document, operators |
| The torch python package is not installed. Please install… | exception | error | openclip, torch, embedding-function, import-error, dependency, chroma |
| not implemented | panic | critical | rust, sysdb, panic, unimplemented, sqlite, grpc, chroma |
| Sparse embedding function returned unexpected number of… | validation | error | sparse-embeddings, custom-embedding-function, count-mismatch, upsert |
| $sum requires at least 2 ranks, got | exception | error | chromadb, rank-expression, validation, deserialization, hybrid-search |
| conditional write conflict | http | warning | http-409, concurrency, optimistic-concurrency, retryable |
| Nomic only supports text documents, not images | validation | error | nomic, embedding-function, type-validation, documents, chroma |
| Cannot specify both 'hnsw' and 'spann' configurations. | validation | error | chromadb, aggregate, unknown-operator, valueerror, min-k, max-k |
| SparseVector indices must be integers, got | validation | error | sparse-vector, type-validation, numpy, python |
| Expected metadata key to be a str, got | validation | error | chromadb, python, metadata, type-error, keys, validation |
| Expected metadata to be a dict or None, got | validation | error | chromadb, python, metadata, update, type-check, validation |
| Expected metadata value to be a str, int, float, bool… | validation | error | chromadb, python, metadata, type-safety, validation |
| The openai python package is not installed. Please install… | exception | error | openai, embedding-function, import-error, dependency, chroma |
| Auth credentials not specified | validation | error | auth, credentials, configuration, client-construction, validation |
| Knn limit must be a positive integer | exception | error | knn, limit, input-validation, rank-expression, client-side |
| not a valid space | validation | error | chroma, hnsw, configuration, vector-space, distance-metric, create-collection |
| Unapplied migrations in | exception | error | migrations, schema-upgrade, version-mismatch |
| Expected metadatas to be a list, got | validation | error | chromadb, validation, metadata, ingestion |
| Inconsistent hashes in | exception | critical | chroma, sqlite, migrations, schema-drift, startup |
InvalidDimension Embedding dimension does not match collection dimensionality | exception | error | chroma, embeddings, dimension-mismatch, invalid-dimension, add |
| Search is not implemented for SegmentAPI | exception | error | chroma, segment-api, embedded, not-implemented, vector-search |
| Embedding function not found. Add… | validation | error | chroma, embedding-function, registry, custom-ef, collection-configuration |
| ID's must be unique, found duplicates for | validation | error | ids, validation, duplicate-ids, add-records |
| The fastembed python package is not installed. Please… | exception | error | python, fastembed, bm25, sparse-embedding, optional-dependency, deprecated, chromadb |
| Conditional transactions are only supported when connecting… | exception | error | chroma, embedded-mode, rust-bindings, transaction, not-implemented |
| Document length is greater than the max tokens | validation | error | onnx, embedding-function, token-limit, truncation, chunking, chroma |
| Failed to fetch with status | http | error | chromadb, aggregate, invalid-value, valueerror, k, min-k, max-k |
| Preferred providers must be unique | validation | error | onnx, embedding-function, config-validation, duplicate-values, chroma |
| Failed to generate embeddings | exception | error | network, http, huggingface, embeddings, server, status-code |
| got empty embedding at pos | validation | error | embeddings, validation, empty-vector |
| Nomic only supports text queries, not images | validation | error | nomic, embedding-function, type-validation, query, chroma |
| No valid configuration fields provided for update. | validation | error | configuration, validation, update, empty-payload, collection-modify |
| Chroma is running in http-only client mode, and can only be… | exception | error | client-mode, thin-client, configuration, runtimeerror |
| Inconsistent migration versions in | exception | critical | migrations, version-mismatch, schema, data-integrity |
| ${message} | exception | error | chroma, rank, knn, numeric |
| Please install @xenova/transformers as a dependency with… | exception | error | transformers, embeddings, npm, wasm, native-module, docker |
| $or must be a non-empty array | exception | error | where-filter, query-validation, chroma, javascript |
| api_base must be specified for Azure OpenAI | validation | error | azure, openai, embedding, endpoint, configuration, chroma |
| Invalid URL. Unrecognized protocol | validation | error | chroma, url, configuration, input-validation, host |
| Expected dict with =' ', got | exception | error | validation, valueerror, knn, sparse-vector, serialization, chromadb |
| Expected embeddings to be a list of floats or ints, a list… | validation | error | chroma, embeddings, type-validation, numpy, input-format |
| Expected metadata value to be a str, int, float, bool… | validation | error | chromadb, python, metadata, update, type-safety, validation |
| If sourceKey is provided then embeddingFunction must also… | validation | error | chromadb, schema, sparse-vectors, embedding-function, index-management |
| Preferred providers must be a list of strings | validation | error | onnx, embedding-function, config-validation, execution-providers, chroma |
| Rrf k must be a positive integer | exception | error | rrf, k, input-validation, rank-expression, client-side |
| Rank input must be a RankExpression, number, or plain object | exception | error | chroma, rank, expression, typeerror |
| Unable to decode configuration from JSON string | validation | error | chromadb, configuration, json, deserialization |
| Expected metadata to be a dict or None, got | validation | error | chromadb, python, metadata, type-check, validation |
| not a valid hnsw config | validation | info | chroma, collection-configuration, hnsw, dead-code, vector-index |
| Tenant does not match from the server. Are you sure the… | http | error | |
| Unexpected error calling Chroma Cloud API | exception | error | chroma-cloud, splade, catch-all, json-parse, sparse-embeddings |
| deployment_id must be specified for Azure OpenAI | validation | error | azure, openai, embedding, deployment, configuration, chroma |
| Schema is missing keys | validation | error | chroma, schema, embedding-key, modify-collection, internal-invariant |
| Invalid SPANN config provided in… | validation | error | configuration, validation, spann, type-mismatch, update, collection-modify |
| Invalid value for parameter | validation | error | chromadb, configuration, value-validation, mutation |
| ${response.status}: ${response.statusText} | http | error | http-5xx, server-error, gateway, retryable, transient |
| DefaultEmbeddingFunction model cannot be changed after… | validation | error | embeddings, default-embedding, onnx, configuration, immutable-field, model-change |
| Expected metadata to not contain the reserved key | validation | error | chromadb, python, metadata, reserved-keys, validation |
| An embedding function already exists in the collection… | validation | error | chroma, embedding-function, get-collection, conflict, configuration |
BatchSizeExceededError Cannot submit more than | exception | error | chroma, internal-api, embeddings-queue, batching, sqlite-limits |
| Cannot update embedding function: incompatible types | validation | error | chroma, embedding-function, modify-collection, incompatible-types, configuration |
| Conditional transactions are not supported by SegmentAPI | exception | error | chroma, transactions, not-implemented, embedded, segment-api |
| Invalid parameter name | validation | error | chromadb, configuration, parameter-names, serialization |
| Schema is missing keys | validation | error | chroma, schema, vector-index, embedding-key, modify-collection |
| stale read | http | warning | http-412, consistency, session, retryable |
| Updating a ChromaLangchainEmbeddingFunction config is not… | exception | error | chroma, langchain, embedding-function, config-update, not-implemented |
| Cloudflare API key is required. Please provide it in the… | validation | error | embeddings, cloudflare, api-key, environment-variable, credentials |
| ids must be provided for transactional delete | validation | error | transactions, delete, input-validation, async |
| Unprocessable Entity | http | error | http-422, proxy, unparseable-body, gateway |
| The PIL python package is not installed. Please install it… | exception | error | openclip, pillow, embedding-function, import-error, dependency, chroma |
| Unsupported architecture on macOS | exception | critical | native-bindings, platform, macos, module-load |
| Config is missing a required field | validation | error | config, validation, qwen, embeddings, deserialization |
| Expected #type='sparse_vector', got | validation | error | sparse-vector, serialization, wire-format |
| Knn key must be a string or Key instance | exception | error | knn, key, input-validation, type-error, client-side |
| Cannot set static parameter | validation | error | chromadb, configuration, static-parameter, immutability, hnsw |
| Cannot specify both 'hnsw' and 'spann' configurations… | validation | error | configuration, validation, hnsw, spann, update, collection-modify |
| Expected where to have exactly one operator, got | validation | error | chromadb, validation, where-filter, query |
| Migrations have not been initialized | exception | error | migrations, database, startup, sqlite |
| Resetting the database is not allowed. Set `allow_reset` to… | validation | error | sqlite, reset, configuration, guard |
| Your API key does not have access to any DBs for tenant | exception | error | auth, cloud, tenant, api-key, authorization |
| Auth provider not specified | validation | error | auth, configuration, client-construction, validation |
| Missing required arguments | validation | error | python, cloud, authentication, api-key, env-vars |
| The nomic python package is not installed. Please install… | exception | error | python, dependency, pip, nomic, optional-import |
| Missing 'api_key_env_var' or 'api_base' in configuration… | exception | error | python, baseten, config, deserialization, required-fields, chromadb |
| Error calling Jina AI API | exception | error | jina, network, embeddings, error-wrapping, fetch, proxy |
| Expected each embedding in the embeddings to be a numpy… | validation | error | chromadb, embeddings, numpy, type-mismatch |
| Resetting is not allowed by this configuration (to enable… | validation | error | configuration, reset, guard, settings |
| [91mYour system has an unsupported version of sqlite3… | exception | critical | python, sqlite, environment, import-error, version-check |
| Invalid parameter value | validation | error | chromadb, configuration, type-mismatch, serialization |
| Where dictionary must contain exactly one field | exception | error | where-filter, query-validation, chroma, javascript |
| Expected each document to be a string, but got | validation | error | chromadb, validation, documents, null-handling |