Quickstart

Walkthrough

1. 01

   Sign in and grab an API key

   Sign 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 keys

   Treat the key like a password

   API keys grant access to your plan’s usage and spend. Store them in a secret manager — never commit them to git.

2. 02

   Send your first request

   The 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:

   curlNodePython

   curl https://api.foxora.ai/v1/chat/completions \
     -H "Authorization: Bearer $FOXORA_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "gpt-4o-mini",
       "messages": [
         { "role": "user", "content": "Say hello in one sentence." }
       ]
     }'

   Copy

   200 OK

3. 03

   Install the SDK locally (optional)

   Pick the package manager you prefer:

   npmpnpmyarnbun

   npm install openai

   Copy

   Installed

4. 04

   Run it as a desktop agent

   Now do the same thing inside Ember OS:

   1. Open Ember OS (the desktop app).
   2. Click + New agent in the dock.
   3. Pick a model, paste your system prompt, and click Run.
   4. Chat with the agent in its own window. It can call tools, edit files in its workspace, and stay running in the background.

   Ember OS · Agent window

   Why both?

   The gateway is for embedding Foxora in your own product. Ember OS is for using Foxora directly on your machine. Same models, same account, same billing.