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.
  TypeScript
• 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 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. Idle agents auto-sleep and keep their state.