Skip to content

Add a model

Ardra works with any AI service that speaks the OpenAI-compatible API, and with models running on your Mac. You add as many as you like, from free tiers to paid plans.

Any of these opens the same screen:

  • Settings → Models & API keys (Settings is at the bottom of the left sidebar)
  • On Home, click the model name under the prompt box
  • In the Code chat, open the agent picker and choose Models & API keys
  1. Choose Add a new model.

  2. Provider shortcut (optional). Tap Google Gemini, OpenAI, OpenRouter, DeepSeek or Ollama on Mac to fill in the address. For any other service, paste its address into Provider Base URL (see Providers).

  3. API Key. Paste the key you created on the provider’s website.

  4. Model ID. Click Find models and pick one from the list. If no list appears, type the exact model ID from the provider’s documentation.

  5. Click Test. When it answers, the model is marked Verified.

  6. Click Add model.

A model you add becomes the active one, used by Home. To switch, click Use next to another model.

Each model in the list shows its address and whether it is Verified:

  • Use: make it the active model
  • Test: check it still answers (a key can expire or run out of credit)
  • Edit: change the model ID or address, or replace the key (leave the key blank to keep the saved one)
  • ×: remove it

Step-by-step pages for Anthropic Claude, OpenAI, Google Gemini, DeepSeek, Groq, OpenRouter, Ollama, and any other provider. No key yet? Start with a free model.