Sapiom SDK

⚠️ Beta Status: Currently in v0.x (beta). API may change before v1.0.0. Production-ready and actively maintained.

TypeScript SDK for building AI agents and applications with the Sapiom API. Provides seamless payment handling, authorization flows, and framework integrations.

📦 Packages

This is a monorepo containing multiple focused packages. Install only what you need:

Core Package

HTTP Client Integrations

Framework Integrations

Coming Soon

• @sapiom/mastra - Mastra framework integration
• @sapiom/langgraph - LangGraph integration
• @sapiom/openai - OpenAI SDK integration

🚀 Quick Start

New to Sapiom? Check out the examples folder for complete setup instructions and working demos.

For Axios Users

npm install @sapiom/axios axios

import axios from 'axios';
import { createSapiomClient } from '@sapiom/axios';

const client = createSapiomClient(axios.create({
  baseURL: 'https://api.example.com'
}));

const response = await client.get('/premium-endpoint');

For Fetch Users

npm install @sapiom/fetch

import { createSapiomFetch } from '@sapiom/fetch';

const fetch = createSapiomFetch();
const response = await fetch('https://api.example.com/data');

For LangChain v1.x Users

npm install @sapiom/langchain langchain

import { createAgent } from "langchain";
import { createSapiomMiddleware } from "@sapiom/langchain";

const agent = createAgent({
  model: "gpt-4",
  tools: [getWeather, sendEmail],
  middleware: [
    createSapiomMiddleware({
      apiKey: process.env.SAPIOM_API_KEY,
    }),
  ],
});

const result = await agent.invoke({
  messages: [{ role: "user", content: "What's the weather?" }],
});

For LangChain v0.x Users (Legacy)

npm install @sapiom/langchain-classic

import { createSapiomReactAgent } from '@sapiom/langchain-classic';

const agent = await createSapiomReactAgent(
  { llm: new ChatOpenAI({ model: "gpt-4" }), tools: [...] },
  { apiKey: process.env.SAPIOM_API_KEY }
);

const response = await agent.invoke({ messages: [...] });

For Direct API Access

If you only need the transaction client without HTTP integrations:

npm install @sapiom/core

import { SapiomClient } from '@sapiom/core';

const client = new SapiomClient({
  apiKey: process.env.SAPIOM_API_KEY
});

const transaction = await client.transactions.create({
  service: 'api',
  action: 'call',
  resource: 'completion'
});

📚 Documentation

• Examples - Getting started with working examples

... View full README on GitHub