Skip to main content
Swap models from the title bar, tune sampling, and keep your API key in the macOS keychain — never in a file.

​
Quick Start

1

Open the model combobox

Click the model pill in the title bar. It suggests common models and accepts any string.
2

Set your API key

In Settings → Models → API key, paste your key. It is stored in the macOS keychain.
3

Tune sampling (optional)

Adjust temperature, max_tokens, or top_p in the Models section.

​
Suggested Models

The combobox suggests these and accepts any other string:

​
Sampling & Endpoint

Sampling values are forwarded only when you change them from their defaults, so a provider default you set elsewhere is never overridden unasked.

​
Where Keys Live

The api_key is stored in the macOS keychain (service ai.praison.desktop) and stripped before settings.json is written.
Your api_key never touches settings.json — it lives only in the keychain. Clearing it removes the credential from the environment on the next turn.

​
Choosing a Setup

​
Best Practices

If you already export OPENAI_API_KEY, leave the field blank and the engine uses the environment key.
Both are marked “requires restart”. Relaunch so the engine routes to the new credential or endpoint.
Point base_url at your local server (for example Ollama or LM Studio) to run entirely on-device.

Settings Reference

Every Models field and its default

Data & Privacy

How secrets are kept off disk