Quick Start

Your first agent run in under 2 minutes, in Python or TypeScript.

1. Install

Building a React app? npm i @m8tes/react@alpha gives you a drop-in chat component. See Embed a UI.

On Node or TypeScript? npm i @m8tes/sdk@alpha is the same API for your server. See TypeScript SDK.

2. Create your account

Already have one? Grab your key from the Developer dashboard and skip to step 3.

Runs are prepaid and a new account starts at $0, so fund it before the first run: top up or connect a model subscription (and use a matching model). Verification is separate — a preview allowance (25 completed runs) lets you build first; after that, runs need the account verified by email.

3. Run your first agent

Pick the path that matches how you fund the account:

Embed / prepaid (multi-tenant)

Pass user_id so each end-user stays isolated. This bills the prepaid wallet — top up first (billing). Own-subscription credentials never attach to user_id runs.

That user_id is the whole multi-tenant story. See Multi-tenancy.

Not funded yet? This call fails fast with 402 TOKEN_BALANCE_DEPLETED and a topup_url. If you already connected a model plan, the error also carries own_sub_hint — drop user_id and use a matching model for personal development.

Solo / own model subscription

Connect OpenAI, xAI, Gemini, or Claude via client.model_connections.authorize(...) (Claude can also paste_claude from Claude Code credentials). Connecting auto-activates the free plan. Then run without user_id on a matching model:

See Develop on your model subscription.

From here, connect tools (Stripe, Slack, ...) and trigger runs by schedule, webhook, or email. See Agents.

HTTP equivalent

Signup (no auth; returns {"api_key": "m8_...", ...}):

cURL

Run:

cURL

Rotate a key any time with POST /api/v2/token (invalidates the previous key) or the Developer dashboard.

Next: Agents · Runs · Multi-tenancy