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

Thrown by checkSetup() (server/utils/agents/index.js:128) when the resolved agent provider is 'lemonade' but process.env.LEMONADE_LLM_BASE_PATH is unset/empty. It is a precondition gate in agent.init() ensuring the AMD Lemonade local server endpoint is configured before use.

Source

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

      case "docker-model-runner":
        if (!process.env.DOCKER_MODEL_RUNNER_BASE_PATH)
          throw new Error(
            "Docker Model Runner 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;
      default:
        throw new Error(
          "No workspace agent provider set. Please set your agent provider in the workspace's settings"
        );
    }

View on GitHub (pinned to 526360e320)

Solutions

1. Set LEMONADE_LLM_BASE_PATH in .env (e.g. http://127.0.0.1:8000/v1) and restart the server.
2. Confirm the Lemonade server is running and reachable at that URL.
3. Switch provider if Lemonade is not intended.

Example fix

// before (.env)
LEMONADE_LLM_BASE_PATH=
// after (.env)
LEMONADE_LLM_BASE_PATH=http://127.0.0.1:8000/v1

function assertLemonadeReady(workspaceAgentProvider) {
  const using = workspaceAgentProvider === 'lemonade' || process.env.LLM_PROVIDER === 'lemonade';
  if (using && !process.env.LEMONADE_LLM_BASE_PATH)
    throw new Error('LEMONADE_LLM_BASE_PATH missing - set it before starting an agent.');
}

try { await agent.init(); } catch (e) { if (/Lemonade base path must be provided/.test(e.message)) return showProviderConfig('lemonade'); throw e; }

When it happens

Trigger: A chat turn calls agent.init(); this.provider resolves to 'lemonade'; case 'lemonade' runs and process.env.LEMONADE_LLM_BASE_PATH is falsy.

Common situations: Lemonade picked as agent provider but base path never set; the local server moved port; .env updated but server not restarted.

Related errors

• Docker Model Runner base path must be provided to use agents
• Privatemode base path must be provided to use agents.
• OMLX base path must be provided to use agents.
• No Lemonade API Base Path was set.
• LMStudio base path must be provided to use agents.

AI-assisted analysis of Mintplex-Labs/anything-llm@526360e320 (2026-08-13). Data as JSON: /api/errors/890f84e94f0c4eb5. Report an issue: GitHub.