BrainDocs

Custom models

Add OpenAI-compatible endpoints for a workspace or the whole instance.

On /models, add a custom model:

  1. Display name
  2. Base URL (OpenAI-compatible)
  3. Provider model id
  4. Optional API key and context window

Presets (Ollama, LM Studio, …) and Fetch models discovery help fill fields.

Scope

ScopeWho can addBadge
This workspaceWorkspace adminThis workspace
Entire instanceInstance adminAll workspaces

Custom models merge with enabled Command Code entries in the composer catalog. Workspace owners/admins can turn individual custom models off, or use Turn all off / Turn all on, without deleting them. Chat works without COMMAND_CODE_API_KEY when a usable enabled custom model exists for the workspace.

Azure AI Foundry and other private hosts

Foundry (and similar private model platforms) is the model plane, not a second chat app. Register the OpenAI-compatible chat-completions URL, the provider model id, and an optional API key. Brain does not train or fine-tune inside the app — that stays in Foundry.

The same path works for a company proxy, Ollama, or LM Studio. See Architecture.