chroma-core/chroma · error · ChromaValueError

Sparse embedding function with name ${name} is already regis

Error message

Sparse embedding function with name ${name} is already registered.

What it means

Error "Sparse embedding function with name ${name} is already registered." thrown in chroma-core/chroma.

Source

Thrown at clients/new-js/packages/chromadb/src/embedding-function.ts:216

    throw new ChromaValueError(
      `Embedding function with name ${name} is already registered.`,
    );
  }
  knownEmbeddingFunctions.set(name, fn);
};

/**
 * Registers a sparse embedding function in the global registry.
 * @param name - Unique name for the sparse embedding function
 * @param fn - Sparse embedding function class to register
 * @throws ChromaValueError if name is already registered
 */
export const registerSparseEmbeddingFunction = (
  name: string,
  fn: SparseEmbeddingFunctionClass,
) => {
  if (knownSparseEmbeddingFunctions.has(name)) {
    throw new ChromaValueError(
      `Sparse embedding function with name ${name} is already registered.`,
    );
  }
  knownSparseEmbeddingFunctions.set(name, fn);
};

/**
 * Retrieves and instantiates an embedding function from configuration.
 * @returns EmbeddingFunction instance or undefined if it cannot be constructed
 */
export const getEmbeddingFunction = async (args: {
  client: ChromaClient;
  efConfig?: EmbeddingFunctionConfiguration;
}) => {
  const { client, efConfig } = args;

  if (efConfig?.type !== "known") {
    return undefined;

View on GitHub (pinned to aecdd12c8a)

When it happens

Trigger: Thrown at clients/new-js/packages/chromadb/src/embedding-function.ts:216 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of chroma-core/chroma@aecdd12c8a (2026-08-16). Data as JSON: /api/errors/121d93e5e168da61. Report an issue: GitHub.