chroma-core/chroma · error · Error

Could not find API key at ${args.apiKeyEnvVar}

Error message

Could not find API key at ${args.apiKeyEnvVar}

What it means

Error "Could not find API key at ${args.apiKeyEnvVar}" thrown in chroma-core/chroma.

Source

Thrown at clients/new-js/packages/ai-embeddings/huggingface-server/src/index.ts:24

import * as process from "node:process";
import { validateConfigSchema } from "@chroma-core/ai-embeddings-common";

const NAME = "huggingface-server";

export interface HuggingfaceServerConfig {
  api_key_env_var?: string;
  url: string;
}

export class HuggingfaceServerEmbeddingFunction implements EmbeddingFunction {
  public readonly name = NAME;
  private readonly apiKeyEnvVar: string | undefined;
  private readonly url: string;
  private readonly headers: Record<string, any> | undefined;

  constructor(args: { apiKey?: string; apiKeyEnvVar?: string; url: string }) {
    if (args.apiKeyEnvVar && !process.env[args.apiKeyEnvVar]) {
      throw new Error(`Could not find API key at ${args.apiKeyEnvVar}`);
    }

    this.apiKeyEnvVar = args.apiKeyEnvVar;
    this.url = args.url;

    const apiKey =
      args.apiKey || (this.apiKeyEnvVar && process.env[this.apiKeyEnvVar]);

    this.headers = {
      "Content-Type": "application/json",
      Authorization: apiKey ? `Bearer ${apiKey}` : undefined,
    };
  }

  public async generate(texts: string[]): Promise<number[][]> {
    const response = await fetch(this.url, {
      method: "POST",
      headers: this.headers,

View on GitHub (pinned to aecdd12c8a)

When it happens

Trigger: Thrown at clients/new-js/packages/ai-embeddings/huggingface-server/src/index.ts:24 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/54b81206440acf56. Report an issue: GitHub.