Quick Start
Configure providers and send your first request.
This guide picks up where Installation left off. By the end you'll have an LLM provider configured, an API key issued, and your first request routed through the gateway.
Make sure Everstack is running and the health check passes before continuing:
curl https://{instance}.{region}.everstack.ai/debug/healthzOpen the Admin Dashboard
Navigate to https://{instance}.{region}.everstack.ai in your browser.
If authentication is enabled, you'll be prompted to create an account. The first user to register automatically becomes the owner with full admin access.
Add an LLM Provider
Go to Vault → LLM Providers and click Add Provider. Enter your credentials for the provider you want to use:
| Field | Value |
|---|---|
| Provider | openai |
| API Key | sk-… |
Supported models: gpt-4o, gpt-4o-mini, o3-mini, and more.
| Field | Value |
|---|---|
| Provider | anthropic |
| API Key | sk-ant-… |
Supported models: claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5, and more.
| Field | Value |
|---|---|
| Provider | google |
| API Key | AIza… |
Supported models: gemini-2.0-flash, gemini-2.5-pro, and more.
| Field | Value |
|---|---|
| Provider | azure |
| API Key | your Azure key |
| Base URL | https://<resource>.openai.azure.com/openai/deployments/<deployment> |
The base URL must point to a specific deployment endpoint.
You can add multiple providers. The gateway routes requests to the right provider based on the model name in the request.
Create an API Key
Go to Vault → API Keys and click Create Key. Give it a name, set an optional expiry, and copy the key — it's only shown once.
This is the key your applications will use when calling the gateway.
Send Your First Request
Everstack is OpenAI API-compatible — any existing OpenAI SDK or tool works by changing the base URL and API key.
curl -X POST https://{instance}.{region}.everstack.ai/openai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_EVERSTACK_API_KEY" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{"role": "user", "content": "Hello!"}
]
}'from openai import OpenAI
client = OpenAI(
base_url="https://{instance}.{region}.everstack.ai/openai/v1",
api_key="YOUR_EVERSTACK_API_KEY",
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://{instance}.{region}.everstack.ai/openai/v1",
apiKey: "YOUR_EVERSTACK_API_KEY",
});
const response = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "Hello!" }],
});
console.log(response.choices[0].message.content);You should get a response from the provider within a few hundred milliseconds. The request is routed, logged, and traced automatically.
View the Trace
Go to Observability → Traces in the dashboard. You'll see your request listed with its full trace — latency breakdown, token counts, cost estimate, and the raw provider response.
Every request is traced automatically with no SDK or instrumentation required in your application.
What's Next?
Configuration
Set up the YAML config file, environment variables, database modes, and more.
Node SDK
Integrate chat, memory, agents, sandboxes, datasets, and evaluations from Node.js.
Gateway
Routing rules, fallbacks, load balancing, and rate limiting.
Agents
Build autonomous AI agents with tools, memory, and sandboxed execution.
Workflow Studio
Design visual AI pipelines with the drag-and-drop studio.