# SDK

## Examples

Real, runnable files on GitHub. Copy one, set `MARITIME_API_KEY`, and run. Every example is verified to compile against the published packages.

## Browse the examples

### Provision on signup

One agent per customer, idempotent

[TypeScript](https://github.com/maritime-sh/maritime-sdk/blob/main/examples/typescript/provision-on-signup.ts) [Python](https://github.com/maritime-sh/maritime-sdk/blob/main/examples/python/provision_on_signup.py)

### Express / FastAPI chat API

An endpoint that provisions + chats

[TypeScript](https://github.com/maritime-sh/maritime-sdk/blob/main/examples/typescript/express-chat-api.ts) [Python](https://github.com/maritime-sh/maritime-sdk/blob/main/examples/python/fastapi_app.py)

### Next.js route handler

Drop-in app/api/assistant/route.ts

[TypeScript](https://github.com/maritime-sh/maritime-sdk/blob/main/examples/typescript/nextjs-route.ts)

### Webhook receiver

Verify the HMAC signature, handle events

[TypeScript](https://github.com/maritime-sh/maritime-sdk/blob/main/examples/typescript/webhook-receiver.ts) [Python](https://github.com/maritime-sh/maritime-sdk/blob/main/examples/python/flask_webhook.py)

### Scoped worker key

Mint a deploy-only key for a subsystem

[TypeScript](https://github.com/maritime-sh/maritime-sdk/blob/main/examples/typescript/scoped-key.ts) [Python](https://github.com/maritime-sh/maritime-sdk/blob/main/examples/python/scoped_key.py)

### Per-customer secrets

Set + hot-reload encrypted env vars

[TypeScript](https://github.com/maritime-sh/maritime-sdk/blob/main/examples/typescript/manage-secrets.ts) [Python](https://github.com/maritime-sh/maritime-sdk/blob/main/examples/python/manage_secrets.py)

The whole set lives in [github.com/maritime-sh/maritime-sdk/examples](https://github.com/maritime-sh/maritime-sdk/tree/main/examples).

## A note on billing

Agents you provision run on _your_ Maritime plan. Each one runs in an agent box, billed per second at $1 a month per 2 GB of memory, awake or asleep, from your plan's usage credit first. See the [billing page](/content/docs/billing/index.html). Idle agents auto-sleep and keep their state.