← Back to Help center
Providers & Models

Add your API key

Open Settings → Providers & keys, find the provider card, paste the key. It is encrypted on your machine. You can update keys at any time.

  1. Open the provider's console: console.groq.com/keys for Groq, platform.openai.com/api-keys for OpenAI, and so on.
  2. Create a new API key. Copy it once (most consoles don't show it again).
  3. Open Dimmy → Settings → Providers & keys.
  4. Click the card for your provider to expand it.
  5. Paste the key in the key field and click Connect.
  6. The card header shows a connected status pill when the key is accepted.
Settings → Providers & keys page with provider cards and status pills

Where the key lives

  • Encrypted at rest in ~/.config/dimmy/keys.enc (or %APPDATA%\dimmy\keys.enc on Windows).
  • AES-256-GCM with a key derived from your machine. No OS keyring popup.
  • Decrypted only in memory when Dimmy needs to call the provider.
  • Sent only to the provider domain. Hardcoded host allowlist.

Multiple keys

Each provider has its own card with its own key field. You can keep keys for Groq, OpenAI, Anthropic, and others simultaneously. Each card shows what the provider can do: speech to text, rewrite, recap.

Was this helpful?

In this category

Providers & Models
Local mode: offline by default
Dimmy ships with Whisper running on your device. No API key, no internet, no per-minute cost. Works on a plane.
Providers & Models
Cloud providers compared
Groq is fastest, OpenAI is the gold standard, Deepgram leads on streaming. All optional. Bring your own key.
Providers & Models
Choose a Whisper model
Smaller is faster but less accurate. base-q8_0 is the default. large-v3-turbo is the top tier on-device.
Providers & Models
Optional on-device LLM
Run the LLM enhancement pass locally via llama.cpp. No cloud, no key, no per-token cost. Pick a model to match your GPU memory.
Last updated: 2026-05-22