Quickstart

This walks you through the hosted path — fastest way from zero to a running agent. If you want to self-host instead, jump to Self-host → Overview.

Prerequisites

A web browser
curl (or Postman, or any HTTP client)
About 5 minutes

Steps

Create an account.

Go to app.openma.dev and sign up with email, email-OTP, or Google. Your tenant is created automatically on first sign-in — no manual setup.
Create an API key.

In the Console, open API Keys → New key. Copy it now; you won’t see it again.
Terminal window
```
export OMA_BASE_URL="https://app.openma.dev"
export OMA_API_KEY="oma_..."     # the key you just copied
```

Create your first agent.

curl -X POST "$OMA_BASE_URL/v1/agents" \
  -H "Authorization: Bearer $OMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "hello-agent",
    "model": "claude-sonnet-4-6",
    "system": "You are a friendly assistant. Keep replies under 3 sentences.",
    "tools": []
  }'

Save the returned id — you’ll need it next.

Start a session and stream events.

AGENT_ID="agent_..."   # from previous step

curl -X POST "$OMA_BASE_URL/v1/sessions" \
  -H "Authorization: Bearer $OMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"agent_id\": \"$AGENT_ID\",
    \"input\": [{ \"role\": \"user\", \"content\": \"What is 2+2?\" }]
  }"

The response includes a session_id. Stream live events with:

SESSION_ID="sess_..."

curl -N "$OMA_BASE_URL/v1/sessions/$SESSION_ID/events" \
  -H "Authorization: Bearer $OMA_API_KEY"

You’ll see Server-Sent Events for each model turn, tool call, and tool result.

Check it in the Console.

Back in app.openma.dev, open Sessions → click your new session. You’ll see the full event stream, including the model’s reply.

Where to go next

Concepts Learn the nouns: Agent, Session, Environment, Vault, Skill, Tool, Harness, Integration.

Use the Console Create agents, sessions, environments, and skills from the UI instead of the API.

Build with the API REST surface, auth, SSE streaming, the CLI, and the SDK types package.