API Keys

Betwixt follows a bring-your-own-keys model. You provide API keys for the LLM providers you want to use, and Betwixt handles routing, context management, and orchestration.

Authenticate with Betwixt

First, log in to your Betwixt account:

bx auth login

This opens your browser to complete authentication. Once verified, a session token is stored securely in your OS keyring.

Add Provider Keys

Add API keys for each provider you want to use. Betwixt supports multiple providers simultaneously, and Niko will route tasks to the best available model.

Anthropic (Claude)

bx provider add anthropic

You will be prompted to enter your Anthropic API key. Get one from console.anthropic.com.

OpenAI (GPT, Codex)

bx provider add openai

Enter your OpenAI API key from platform.openai.com.

Google (Gemini)

bx provider add google

Enter your Google AI API key from aistudio.google.com.

Verify Configuration

Check that your providers are configured correctly:

bx provider list

This shows all configured providers and their status. A green checkmark indicates the key is valid and the provider is reachable.

Key Storage

API keys are encrypted at rest using ChaCha20-Poly1305 and stored in your local Betwixt vault. Keys never leave your machine -- Betwixt sends requests directly from your device to each provider's API.

Minimum Configuration

You need at least one provider configured to start using Betwixt. For the best experience, configure all three major providers so Niko can route tasks to the optimal model for each sub-task.

Next Steps

With your keys configured, start your first session to see distributed agent orchestration in action.