# Quickstart

From a blank account to a working agent in about five minutes. We'll send a chat completion via the gateway and then run the same prompt as an agent in Foxora Desktop.

## Walkthrough

- 01Sign in and grab an API keySign up at foxora.ai/signup or sign in if you already have an account. Open the dashboard at foxora.ai/dashboard, head to Settings, and create a new API key.Settings · API keysDashboard → Settings → API keys → Create new keyTreat the key like a passwordAPI keys grant access to your plan’s usage and spend. Store them in a secret manager — never commit them to git.
- 02Send your first requestThe Foxora gateway speaks the same shape as OpenAI’s chat completions endpoint, so most existing SDKs work out of the box. Pick your favourite client:curlNodePythoncurl https://api.foxora.ai/v1/chat/completions \
  -H "Authorization: Bearer $FOXORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "foxora-ai-fast",
    "messages": [
      { "role": "user", "content": "Say hello in one sentence." }
    ]
  }'Copy200 OKA successful response from /v1/chat/completions
- 03Install the SDK locally (optional)Pick the package manager you prefer:npmpnpmyarnbunnpm install openaiCopyInstalledThe official OpenAI SDK works against Foxora — just swap baseURL.
- 04Run it as a desktop agentNow do the same thing inside Foxora Desktop:Open Foxora Desktop.Click + New agent in the dock.Pick a model, paste your system prompt, and click Run.Chat with the agent in its own window. It can call tools, edit files in its workspace, and stay running in the background.Foxora Desktop · Agent windowYour first agent running in its own dock window.Why both?The gateway is for embedding Foxora in your own product. Foxora Desktop is for using Foxora directly on your machine. Same models, same account, same billing.
