Providers & Models

Built-in providers (14)

From src/utils/values.ts:

Adding your first provider

1. Open the app, navigate to Settings (gear icon in left drawer).
2. Under Default Provider, click Add → pick a provider type (e.g. OpenAI Compatible).
3. Fill in: Display Name, Base URL (for non-fixed providers), API Key.
4. The provider gets a Share Link at the top of Settings. Copy and share it — others who open it auto-fill their settings.

Custom providers (mix-and-match subproviders)

Beyond the 14 built-ins, you can define a Custom Provider in /settings/providers/:id that maps model names across multiple subproviders:

• Subproviders: each subprovider is itself a provider (built-in or another custom) with a modelMap from your custom model id to the upstream model id.
• Fallback provider: if a model id is not in any subprovider's map, the request falls back to this provider.
• Useful when you route cheap queries to one upstream, expensive ones to another, and present them under one alias to your assistants.

Data shape (from src/utils/types.ts):

interface CustomProvider {
  id: string
  name: string
  avatar: Avatar
  subproviders: { provider: Provider, modelMap: Record<string, string> }[]
  fallbackProvider?: Provider
}

Model selection — the cascade

When a dialog runs a turn, the model is picked in this order:

1. dialog.modelOverride (set per-conversation via the model picker in the header)
2. assistant.model (set on the assistant used for this dialog)
3. userPerfs.model (the global default, set in Settings → Default Model)

Each model has an inputTypes triple of {user, assistant, tool} string arrays describing what content types it accepts (text, image, audio, pdf).

Common models shortcut

Settings → Common Models is a list of model ids you switch between often. The picker at the top of a dialog has a quick-pick dropdown populated from this list.

System assistant

Settings → System Assistant is a separate (provider, model) pair used for two background jobs:

• Auto-summarizing a conversation title after the first turn
• Extracting artifacts from assistant replies

If left blank, the global default provider/model is used.