Kaidera OS

Configure providers and models

Set up model providers, choose model routes, understand the catalog, and keep API keys out of code.

Public docs for dev reviewLast verified 2026-07-01

Based on the Kaidera OS provider and model design, Settings guide, and public product page.

Provider setup

Provider keys are configured in Settings. They should be stored as secrets, never rendered back into HTML, and never committed into code or documentation. A masked value means a key exists without exposing it.

Supported provider families

The provider layer is designed for commercial and open model providers. Current design coverage includes Anthropic, OpenAI, OpenRouter, Fireworks, Gemini, xAI, Together, and custom OpenAI-compatible endpoints.

Model catalog

The Models surface should show what is available from configured providers. Catalog data can be discovered dynamically where the provider supports it and supplemented where a provider needs normalized capability metadata.

Choosing a model route

Configure each worker with a suitable provider, model, and reasoning level. Use stronger reasoning for planning, architecture, code review, and complex execution. Use lighter models for routine summarization, extraction, and deterministic support flows.

Custom OpenAI-compatible providers

If a provider exposes an OpenAI-compatible v1 API, Kaidera OS can support it through the custom provider path when the endpoint, key, and model names are configured correctly.

Troubleshooting model issues

If a worker cannot run, check the provider key, model name, account access, rate limits, and worker configuration before changing project setup. Provider errors should be treated differently from project-memory or workspace-root errors.

Default open model direction

The roadmap includes Manifold, a built-in open provider path, so a fresh install can have a default route without requiring a commercial provider key first. Until that path is available, bring a provider key for model-backed work.

Website context

Connect this guide back to the product story

The technology docs map links this page to the public technology narrative and helps buyers move from a capability overview into the right operating guide.

Open technology docs map →