Providers & models

Obsilo supports 11 AI providers. Setup instructions for each one follow.

For all providers, open Settings > Obsilo Agent > Models, click "+ add model", and select your provider.

Cloud providers

Anthropic

What you need	API key from console.anthropic.com
Recommended models	Claude Sonnet 4.6 (best overall), Claude Haiku (fast and cheap)
Embedding	Not available natively. Use OpenAI for embeddings.

Setup:

1. Create an account at console.anthropic.com
2. Go to API Keys and create a new key
3. In Obsilo, select Anthropic as provider, paste the key, and pick a model

Best tool use

Anthropic models are the most reliable at calling Obsilo's tools correctly. If quality matters most, start here.

OpenAI

What you need	API key from platform.openai.com
Recommended models	GPT-4o (balanced), o3 (reasoning), GPT-4o-mini (budget)
Embedding	Native support. text-embedding-3-small recommended.

Setup:

1. Create an account at platform.openai.com
2. Go to API Keys and generate a new key
3. In Obsilo, select OpenAI as provider, paste the key, and pick a model

Embedding models

An OpenAI key also gives you access to embedding models for semantic search. Configure in Settings > Embeddings.

Google Gemini

What you need	API key from Google AI Studio
Recommended models	Gemini 2.5 Flash (fast, free tier available), Gemini 2.5 Pro (best quality)
Embedding	Not available natively

Setup:

1. Go to Google AI Studio and sign in with your Google account
2. Click Create API Key and copy it
3. In Obsilo, select Google Gemini as provider, paste the key
4. Browse available models or pick from the pre-configured list

Free tier

Google Gemini has a free tier with reasonable rate limits. Good starting point if you want to try Obsilo without paying.

OpenRouter

What you need	API key from openrouter.ai
Recommended models	Any. OpenRouter gives access to 100+ models from multiple providers.
Embedding	Not available

Setup:

1. Create an account at openrouter.ai
2. Go to Keys and create a new API key
3. In Obsilo, select OpenRouter as provider, paste the key
4. Browse or type any model ID (e.g., anthropic/claude-sonnet-4.6, google/gemini-2.5-pro)

Azure OpenAI

What you need	Azure subscription, a deployed model, API key, and endpoint URL
Recommended models	GPT-4o (deployed in your Azure region)
Embedding	Native support via deployed embedding model

Setup:

1. Deploy a model in your Azure OpenAI resource
2. Copy the endpoint URL, API key, and deployment name
3. In Obsilo, select Azure OpenAI as provider and fill in all three fields

Enterprise use

Azure OpenAI fits organizations with compliance requirements. Data stays inside your Azure tenant.

Amazon Bedrock

What you need	AWS account with Bedrock enabled, IAM user with invoke permissions, access key ID + secret access key
Recommended models	Claude Sonnet 4.5, Claude Opus 4.5, Amazon Nova (via cross-region inference profiles)
Embedding	Not supported in phase 1. Use OpenAI or Ollama for embeddings
Regions	eu-central-1, eu-west-1, eu-west-2, eu-west-3, eu-north-1, us-east-1, us-east-2, us-west-2, plus Asia Pacific

Setup:

1. In the AWS console, open Bedrock in your preferred region. For the EU, Frankfurt (eu-central-1) is the most common choice
2. Go to Model access and request access to the model families you want to use. Approval is usually instant for the major foundation models
3. Create an IAM user (or role) with a policy that allows these actions:

   {
     "Effect": "Allow",
     "Action": [
       "bedrock:InvokeModel",
       "bedrock:InvokeModelWithResponseStream"
     ],
     "Resource": "*"
   }

4. For EU cross-region inference profiles (recommended), the resource ARN pattern covers all EU regions. For a more restricted policy, scope it to the specific inference profile ARNs you use
5. Generate an access key ID and secret access key for the user and copy both
6. In Obsilo, select Amazon Bedrock as provider, pick your region, and paste the credentials. Use the quick pick dropdown to select a model

Cross-region inference profiles

Model IDs prefixed with eu. or us. are cross-region inference profiles. They route requests across the regions in that geography for higher availability. In Europe, eu.anthropic.claude-sonnet-4-5-20250929-v1:0 is the recommended default — it works from any EU region and keeps data inside the EU.

Direct regional model IDs (without a prefix) only work in the specific region that hosts the model. Frankfurt supports a smaller direct model list than the EU inference profiles do.

Temporary credentials

For AWS SSO or STS-issued credentials, fill the session token field as well. Long-lived IAM user credentials don't need it.

Billing

Bedrock bills per-token directly through your AWS account. There is no free tier for most foundation models. Check the AWS Bedrock pricing page before heavy use.

Gateway providers

GitHub Copilot

What you need	An active GitHub Copilot subscription (Individual, Business, or Enterprise)
Recommended models	GPT-4o, Claude Sonnet (available through Copilot)
Embedding	Not available

Setup (OAuth device flow):

1. In Obsilo, select GitHub Copilot as provider
2. Click "Sign in with GitHub". A device code appears.
3. Open github.com/login/device in your browser
4. Enter the code and authorize the app
5. Obsilo automatically detects your available models

No extra cost

If you already pay for GitHub Copilot, this costs nothing extra. The models come with your subscription.

Kilo Gateway

What you need	A Kilo Code account with gateway access
Recommended models	Depends on your organization's available models
Embedding	Not available

Setup (device auth, recommended):

1. In Obsilo, select Kilo Gateway as provider
2. Click "Sign in". A device code and URL appear.
3. Open the URL in your browser, enter the code, and authorize
4. Models are loaded dynamically from your organization

Setup (manual token):

1. Obtain a gateway token from your Kilo Code admin
2. In Obsilo, select Kilo Gateway and choose "Manual Token"
3. Paste the token. Models load automatically.

Local providers

Ollama

What you need	Ollama installed on your machine
Recommended models	Qwen 2.5 7B (balanced), Llama 3.2 (general), Codestral (code)
Embedding	Supported via nomic-embed-text or similar

Setup:

1. Install Ollama from ollama.ai
2. Pull a model: ollama pull qwen2.5:7b
3. In Obsilo, select Ollama as provider. No API key needed.
4. The model list auto-detects running models

Privacy

With Ollama, no data leaves your machine. Good for sensitive vaults.

LM Studio

What you need	LM Studio installed with a model loaded
Recommended models	Any GGUF model from the built-in catalog
Embedding	Supported for compatible models

Setup:

1. Install LM Studio from lmstudio.ai
2. Download a model from the catalog and load it
3. Start the local server (LM Studio > Developer tab)
4. In Obsilo, select LM Studio as provider. No API key needed.

Custom endpoint

What you need	Any OpenAI-compatible API endpoint
Recommended models	Depends on the server
Embedding	Depends on the server

Setup:

1. In Obsilo, select Custom as provider
2. Enter the base URL (e.g., http://localhost:8080/v1)
3. Enter an API key if your server requires one
4. Type the model name exactly as the server expects

This works with any server that implements the OpenAI chat completions API: vLLM, text-generation-inference, LocalAI, and self-hosted endpoints.

Provider comparison

Provider	Auth	Cost	Privacy	Embedding	Best for
Anthropic	API key	Pay-per-use	Cloud	No	Best quality
OpenAI	API key	Pay-per-use	Cloud	Yes	Structured output, embeddings
Google Gemini	API key	Free tier + pay	Cloud	No	Free starting point
OpenRouter	API key	Pay-per-use	Cloud	No	Model variety
Azure OpenAI	API key + endpoint	Enterprise	Enterprise tenant	Yes	Compliance
Amazon Bedrock	IAM access key	Pay-per-use via AWS	Cloud (your AWS account)	No	EU data residency via eu-central-1
GitHub Copilot	OAuth	Subscription	Cloud	No	Existing subscribers
Kilo Gateway	Device auth / token	Organization	Cloud	No	Team deployments
Ollama	None	Free	Fully local	Yes	Privacy, offline
LM Studio	None	Free	Fully local	Yes	Visual model browser
Custom	Varies	Varies	Varies	Varies	Self-hosted setups