primitive

What is primitive?

Primitive is an inbound and outbound email platform with SDKs for Node.js, Python, and Go. It centers on a small default workflow: receive an inbound email, inspect a normalized email object, and send, reply, or forward synchronously. The SDKs also include a non-custodial x402 payments client for USDC transactions.

How to use primitive?

Install the SDK for your language (npm install @primitivedotdev/sdk, pip install primitivedotdev, or go get github.com/primitivedotdev/sdks/sdk-go@latest). Use receive(...) to parse an incoming email, client(...) to create an outbound client with an API key, and then send(...), reply(...), or forward(...) to act on the email.

Key features of primitive

• Inbound email parsing and synchronous outbound sending
• Non-custodial x402 payments on Base and Base-Sepolia
• SDKs for Node.js, Python, and Go
• Webhook verification and MIME parsing helpers
• Low-level generated APIs and OpenAPI exports
• Primitive Memories key-value store operations

Use cases of primitive

• Automate email replies from a webhook endpoint
• Send, reply, or forward emails programmatically
• Accept USDC micro‑payments before processing an email action
• Build custom email workflows with raw MIME or API access

FAQ from primitive

What languages does the primitive SDK support?

Node.js (npm), Python (pip), and Go (go get) are officially supported.

How does x402 payments work in primitive?

One party registers a payout address and requests a USDC payment; the paying agent signs locally with its own key. Keys never leave the caller, and settlement occurs on the chosen network (base or base-sepolia).

Do I need an API key to use primitive?

Yes. The outbound client requires a PRIMITIVE_API_KEY, and webhook verification uses a PRIMITIVE_WEBHOOK_SECRET.

Are there lower-level APIs beyond the default workflow?

Yes. The SDKs also expose raw webhook parsing, generated HTTP API packages, MIME parsing, and a CLI for advanced use cases.

Where is email data stored?

Primitive provides a key‑value store called Primitive Memories for custom data, but the README does not specify where email payloads themselves are stored.