Mintplex-Labs/anything-llm · error · Error

LiteLLM API base path and key must be provided to use…

Error message

LiteLLM API base path and key must be provided to use agents.

What it means

Setup guard in checkSetup(): provider is 'litellm' but LITE_LLM_BASE_PATH is unset, so no LiteLLM proxy URL is configured for the agent runtime. The message also mentions the key because LiteLLM typically needs both endpoint and credential; the throw triggers on the missing base path.

Solutions

  1. Set the LITE_LLM_BASE_PATH and LITE_LLM_API_KEY environment variables.
  2. Ensure the LiteLLM proxy is running.
Defensive patterns

Strategy: validation

When it happens

Trigger: LiteLLM was selected as the agent provider but base path or key is missing.

Common situations: This error is raised at runtime in server/utils/agents/index.js. It occurs when the required configuration for this provider is missing or invalid (unset environment variables, empty API key or base path), when the external service is unreachable or returns an unexpected response, or when invalid input reaches the call site. To prevent it, validate the relevant provider settings and environment variables at startup and confirm the service is reachable before this code path executes.

AI-assisted analysis of Mintplex-Labs/anything-llm@20f6d3546c (2026-08-18). Data as JSON: /api/errors/47712370f7af0627. Report an issue: GitHub.

Appendix: source

Thrown at server/utils/agents/index.js:209

            "TextWebGenUI API base path must be provided to use agents."
          );
        break;
      case "bedrock":
        // No validations since there are many possible authentication methods
        break;
      case "fireworksai":
        if (!process.env.FIREWORKS_AI_LLM_API_KEY)
          throw new Error(
            "FireworksAI API Key must be provided to use agents."
          );
        break;
      case "deepseek":
        if (!process.env.DEEPSEEK_API_KEY)
          throw new Error("DeepSeek API Key must be provided to use agents.");
        break;
      case "litellm":
        if (!process.env.LITE_LLM_BASE_PATH)
          throw new Error(
            "LiteLLM API base path and key must be provided to use agents."
          );
        break;
      case "apipie":
        if (!process.env.APIPIE_LLM_API_KEY)
          throw new Error("ApiPie API Key must be provided to use agents.");
        break;
      case "xai":
        if (!process.env.XAI_LLM_API_KEY)
          throw new Error("xAI API Key must be provided to use agents.");
        break;
      case "zai":
        if (!process.env.ZAI_API_KEY)
          throw new Error("Z.AI API Key must be provided to use agents.");
        break;
      case "novita":
        if (!process.env.NOVITA_LLM_API_KEY)
          throw new Error("Novita API Key must be provided to use agents.");

View on GitHub (pinned to 20f6d3546c)