Mintplex-Labs/anything-llm · error · Error

Lemonade base path must be provided to use agents.

Error message

Lemonade base path must be provided to use agents.

What it means

Provider setup guard in AgentHandler.checkSetup: the selected agent provider is 'lemonade' but LEMONADE_LLM_BASE_PATH is empty/unset, so the agent has no URL for the local Lemonade inference server and setup aborts.

Solutions

  1. Set the LEMONADE_BASE_PATH environment variable.
  2. Ensure the Lemonade server is running.
Defensive patterns

Strategy: validation

When it happens

Trigger: Lemonade was selected as the agent provider but no base path is configured.

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/890f84e94f0c4eb5. Report an issue: GitHub.

Appendix: source

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

          throw new Error("Cohere API key must be provided to use agents.");
        break;
      case "llmman":
        if (!process.env.LLMMAN_BASE_PATH)
          throw new Error("llmman base path must be provided to use agents.");
        break;
      case "privatemode":
        if (!process.env.PRIVATEMODE_LLM_BASE_PATH)
          throw new Error(
            "Privatemode base path must be provided to use agents."
          );
        break;
      case "sambanova":
        if (!process.env.SAMBANOVA_LLM_API_KEY)
          throw new Error("SambaNova API key must be provided to use agents.");
        break;
      case "lemonade":
        if (!process.env.LEMONADE_LLM_BASE_PATH)
          throw new Error("Lemonade base path must be provided to use agents.");
        break;
      case "omlx":
        if (!process.env.OMLX_LLM_BASE_PATH)
          throw new Error("OMLX base path must be provided to use agents.");
        break;
      case "minimax":
        if (!process.env.MINIMAX_API_KEY)
          throw new Error("Minimax API key must be provided to use agents.");
        break;
      case "cerebras":
        if (!process.env.CEREBRAS_API_KEY)
          throw new Error("Cerebras API key must be provided to use agents.");
        break;
      case "vertex":
        if (
          !process.env.VERTEX_AI_LLM_API_KEY ||
          !process.env.VERTEX_AI_LLM_PROJECT_ID
        )

View on GitHub (pinned to 20f6d3546c)