Bring Your Own LLM
Genie includes AI credits by default, but you can also connect your own LLM provider account. When connected, messages use your own API quota — no Genie credits consumed.
This is useful when you have run out of credits, want higher rate limits, or prefer a specific provider.
Supported Providers
Claude (Anthropic)
Setup token (recommended)
Long-lived
Claude (Anthropic)
OAuth (quick)
~8 hours, auto-refresh
Codex (OpenAI)
OAuth sign-in
Session-based
Gemini (Google)
OAuth sign-in
Session-based
Multiple providers can be connected simultaneously. You can switch between them at any time.
Prerequisites
A Genie account with a provisioned server
Server must be in Running state (Settings → Server)
An account with at least one of the supported providers
Connecting a Provider
Go to Settings → Server → LLM Integrations and select the provider tab you want to connect.
Claude — Setup Token (Recommended)
The setup token method creates a long-lived connection and enables Claude Opus as the default model on your server.
Click Start Setup under the Claude tab
A new tab opens to Claude's authorization page
Sign in to your Claude/Anthropic account and authorize access
Copy the authorization code from the callback page
Paste the code into the input field and click Connect
For the full walkthrough with screenshots, see Setting Up Your Server — Claude Setup Token.
Claude — OAuth (Quick)
A faster alternative with shorter-lived tokens (~8 hours, auto-refreshed).
Click Connect in the OAuth section
Authorize in the browser window that opens
The page may show a connection error — this is expected
Copy the full URL from the address bar
Paste the URL back into Genie and click Connect
Codex (OpenAI)
Uses your ChatGPT subscription and its rate limits.
Select the Codex tab and click Connect Codex CLI
Sign in with your OpenAI account in the browser
Authorize access on the consent page
Copy the full callback URL from the address bar (connection error is expected)
Paste back into Genie and click Connect
For the full walkthrough with screenshots, see Connect OpenAI Codex.
Gemini (Google)
Select the Gemini tab
Enter your GCP Project ID — recommended to avoid free-tier rate limits, required for Google Workspace or organization accounts
Go to console.cloud.google.com, select or create a project
Enable the Gemini for Google Cloud API under APIs & Services → Library
Copy the Project ID
Click Continue to sign in
Authorize with your Google account
Copy the full callback URL from the address bar (connection error is expected)
Paste back into Genie and click Connect
For the full walkthrough with screenshots, see Connect Google Gemini.
Using Your Connected LLM
Start a New Chat
Connecting or switching an LLM provider does not take effect in your current active session.
On Dashboard — create a new chat to start using the connected provider
On Telegram — run the
/modelscommand and select your preferred provider/model from the list
Switching Between Providers
You can have multiple providers connected at the same time
Use
/models(Telegram) or the model selector (Dashboard) to switch between themEach new chat session uses whichever model is currently selected
Troubleshooting
"Server must be running"
Start your server in Settings → Server before connecting
OAuth callback shows "connection refused"
This is expected — just copy the URL from the address bar and paste it into Genie
Token expired (Claude OAuth)
OAuth tokens last ~8 hours. Switch to setup-token for a long-lived connection
Gemini rate limits
Provide your own GCP Project ID during setup for higher rate limits
Connected but still using credits
Start a new chat or run /models on Telegram to switch to your provider
Last updated