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 Python

Express / FastAPI chat API

An endpoint that provisions + chats

TypeScript Python

Next.js route handler

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

Webhook receiver

Verify the HMAC signature, handle events

TypeScript Python

Scoped worker key

Mint a deploy-only key for a subsystem

TypeScript Python

Per-customer secrets

Set + hot-reload encrypted env vars

TypeScript Python

The whole set lives in github.com/maritime-sh/maritime-sdk/examples.

A note on billing

Agents you provision run on your Maritime plan. Each one is billed per second while awake and for its disk while asleep, from your plan's usage credit first. See the billing page. Idle agents auto-sleep and keep their state, so an agent nobody talks to costs only its disk.