Anuma SDK

A TypeScript SDK for building AI-powered applications with streaming chat completions, long-term memory, tool calling, and end-to-end encryption.

To learn more, check out the Documentation.

Installation

npm install @anuma/sdk

Testing prereleases

Stable releases go to the default latest tag (the command above). Prerelease builds for trying out unreleased changes are published to the next tag — install them explicitly:

npm install @anuma/sdk@next

These carry a X.Y.Z-next.<timestamp> version and never affect latest. Maintainers publish them on demand via the Publish Next (prerelease) GitHub Actions workflow.

Getting Started

Create an app on the Anuma Dashboard to get your API key or configure Privy authentication.

Usage

React Hooks

import { useChat } from "@anuma/sdk/react";

const { sendMessage, isLoading, stop } = useChat({
  getToken: async () => token,
  onData: (chunk) => console.log(chunk),
});

await sendMessage({
  messages: [{ role: "user", content: [{ type: "text", text: "Hello!" }] }],
  model: "fireworks/accounts/fireworks/models/kimi-k2p5",
});

API Functions

import { postApiV1Responses } from "@anuma/sdk/client";

const response = await postApiV1Responses({
  body: {
    messages: [
      { role: "user", content: [{ type: "text", text: "Hello!" }] },
    ],
    model: "fireworks/accounts/fireworks/models/kimi-k2p5",
  },
  headers: {
    Authorization: `Bearer ${apiKey}`,
  },
});

Platforms

The SDK provides entry points for different platforms:

• @anuma/sdk/react — React hooks
• @anuma/sdk/expo — React Native / Expo
• @anuma/sdk/client — Generated API client and types

Features

The SDK gives you access to a unified API across multiple LLM providers through a single integration. Key capabilities include:

• Streaming chat completions with tool calling and auto-execution
• Extended thinking and reasoning support
• Long-term memory with semantic search and encrypted storage
• Best-effort client-side PII redaction (see PII_REDACTION.md)
• Voice recording and transcription via Whisper
• PDF and image text extraction (OCR)
• Phone call integration
• End-to-end encryption with wallet-based key management
• Credit and subscription management

Documentation

https://docs.anuma.ai/

Contributing

Contributions are welcome. Please open an issue or pull request on GitHub.