🔑 Setting Up AI Model API Keys

AMBA pairs your local files and analytical execution engine with frontier cloud intelligence for strategic reasoning. To operate AMBA, you need an API key from at least one supported AI provider.

---

🔒 Bank-Grade Security: OS Keychain Storage

IMPORTANT

Your API keys are never stored in plaintext.
AMBA writes all provider keys directly to your operating system's hardware-encrypted keychain:

• macOS: Encrypted in Apple's native macOS Keychain.
• Windows: Encrypted in Windows Credential Manager.

Keys are never written to disk files, logged, or sent to any central server.

---

📋 Recommended Providers & Obtaining Keys

1. Anthropic Claude (Highly Recommended)

Best for: Executive synthesis, complex multi-track decomposition, and deep analytical reasoning.

1. Visit the Anthropic Console.
2. Sign in or create an account.
3. Navigate to API Keys and click Create Key.
4. Name your key AMBA Desktop and copy the generated key string (starts with sk-ant-...).

2. OpenAI

Best for: High-speed general assistant workflows and structured document drafting.

1. Visit the OpenAI Platform.
2. Go to Settings > API Keys.
3. Click Create new secret key, name it AMBA Desktop, and copy the key (starts with sk-proj-...).

3. Google Gemini

Best for: Large-context ingestion and rapid exploratory analysis.

1. Visit Google AI Studio.
2. Click Get API key and generate a new key.

---

⚙️ Adding Keys in AMBA

1. Launch AMBA on your computer.
2. In the left navigation sidebar, click ⚙️ Settings.
3. Under the Model Profiles section, select your desired provider profile (e.g. anthropic-claude-3-5-sonnet or openai-gpt-4o).
4. Click Set API Key.
5. Paste your key and click Save to Keychain.
6. The key status will immediately show a green Saved in Keychain indicator.