Providers

add managed provider

Managed providers are configured from environment variables and appear as read-only entries in the Providers page. They are visible to all users, and users cannot read the API keys.

Set one or more of the following environment variables before starting the app:

• OPENAI_API_KEY to add an OpenAI provider using https://api.openai.com/v1
• HF_TOKEN to add a Hugging Face provider using https://router.huggingface.co/v1
• GROQ_API_KEY to add a Groq provider using https://api.groq.com/openai/v1

By default, managed OpenAI and Hugging Face use the Responses API (type=open_responses). Groq remains on OpenAI-compatible chat completions (type=openai).

Restart the app after changing environment variables so the managed providers are reloaded.

add workspace provider

Workspace providers are created in the UI and are configured per user.

1. Open Settings.
2. Go to Providers.
3. Click "Add provider".
4. Fill in the provider name, API key, base URL, headers JSON, and timeout.
5. Click "Create provider".

Notes:

• Provider name should match the model provider segment (for example OpenAI or Groq) in a model name URI.
• Base URL is required for OpenAI-compatible endpoints that are not OpenAI itself.
• Provider type controls the API surface:
• openai uses chat completions.
• open_responses uses the Responses API.