AI Key Setup

Connect AI in a few simple steps, even if you are not technical.

How it works

Run-Calc does not have a built-in AI subscription. Instead you connect your own account from one of the providers below — this is called BYOK (Bring Your Own Key). Your key is stored safely on your computer only.

Open Settings -> AI in Run-Calc.
Pick a provider preset (OpenAI, Gemini, OpenRouter, or Anthropic).
Follow that provider's steps below to get a free or paid API key.
Copy the key, paste it into the API key (BYOK) box, and click Save key.
Click Test and Save. A green status means you are ready.

OpenAI

Best if you already use ChatGPT or have an OpenAI account

Create a free OpenAI account (skip if you have one).
Sign in, then open platform.openai.com/api-keys.
Click Create new secret key, give it a name, and click Create.
Copy the key immediately — you will not see it again.
Paste it into Run-Calc and click Save key.

Run-Calc preset: OpenAI

Gemini

Good choice if you have a Google account — has a free tier

Go to Google AI Studio and sign in with your Google account.
Click Create API key.
Copy the key shown.
Paste it into Run-Calc and click Save key.

Run-Calc preset: Gemini

OpenRouter

Great for trying many AI models from one account

Create a free OpenRouter account (or sign in).
Open openrouter.ai/settings/keys.
Click Create Key, give it a name, and confirm.
Copy the key shown.
Paste it into Run-Calc and click Save key.

Run-Calc preset: OpenRouter

Anthropic (Claude)

The Anthropic preset in Run-Calc routes through OpenRouter — use an OpenRouter key

Create a free OpenRouter account (or sign in).
Open openrouter.ai/settings/keys and create a key.
Copy the key shown.
In Run-Calc, choose the Anthropic preset.
Paste the OpenRouter key and click Save key.

Run-Calc preset: Anthropic — wants an OpenRouter key because it uses the OpenRouter endpoint.

If Something Fails

"Not configured" — no key is saved yet. Paste it and click Save key.
"Unauthorized" — key is wrong or expired. Create a new key and save it again.
"Timeout" — network or provider delay. Try again, or raise the timeout in AI settings.
Changed provider? — save a key for the new preset and run Test and Save again.

Advanced: Custom Provider

The Custom preset lets you point Run-Calc at any OpenAI-compatible endpoint (e.g. a local model or a company proxy). Enter the endpoint URL and model id manually, then save the matching API key.

If you switch custom endpoints while a custom key is already saved, Run-Calc will warn you about key reuse. Enable the reuse toggle in settings, or save a new key for the new endpoint.