SDKs

Rekall provides first-class SDKs for TypeScript, Python, and Go. Choose the right SDK for your use case -- from a full offline-first agent SDK to a lightweight REST client.

Overview

All SDKs communicate with the Rekall API at https://api.rekall.ai/v1. The Agent SDKs (TypeScript, Python, Go) include local storage, cloud sync, and agent lifecycle management. The TypeScript Client is a thin REST wrapper for server-side or lightweight integrations that do not need local state.

Which SDK should I start with?

If you are building an AI agent that needs persistent memory across sessions, use one of the Agent SDKs. If you just need to call the API from a backend service or script, use the TypeScript Client or call the REST API directly.

SDK Comparison

FeatureTS Agent SDKTS ClientPython SDKGo SDK
Package@rekall/agent-sdk@rekall/clientrekall-agent-sdkrekall-agent-sdk
LanguageTypeScript / JavaScriptTypeScript / JavaScriptPython 3.9+Go 1.21+
Local StorageSQLiteNoneSQLiteSQLite
Cloud SyncYesN/A (API only)YesYes
Offline ModeYesNoYesYes
Agent LifecycleFullAPI callsFullFull
Memory OperationsFull + local cacheFull (remote)Full + local cacheFull + local cache
Entity ManagementYesYesYesYes
Bundle Size~120 KB (+ SQLite)~8 KBN/AN/A

When to Use Which SDK

memory

Agent SDKs (TypeScript, Python, Go)

Use an Agent SDK when you are building an AI agent that needs persistent memory, offline capability, and automatic cloud sync. The Agent SDKs manage local SQLite storage and handle sync conflicts transparently.

  • check_circleAutonomous agents with long-running sessions
  • check_circleOffline-first or intermittent connectivity environments
  • check_circleMulti-agent systems with shared hive memory
  • check_circleComplex agent lifecycle management (spawn, message, terminate)
code

TypeScript Client (@rekall/client)

Use the lightweight client when you need a thin, typed wrapper around the REST API without local storage overhead. Ideal for server-side services, scripts, or dashboards.

  • check_circleBackend services or API routes
  • check_circleAdmin dashboards and monitoring tools
  • check_circleOne-off scripts and data migrations
  • check_circleEnvironments where minimal bundle size matters

Installation Quick Reference

Install an SDK
npm install @rekall/agent-sdk
Initialize
import { RekallAgent } from '@rekall/agent-sdk';


const agent = new RekallAgent({
  apiKey: process.env.REKALL_API_KEY!,
  agentId: 'my-agent',
  storage: { path: './rekall.db' },
});


await agent.initialize();

SDK Documentation

memory

TypeScript Agent SDK

@rekall/agent-sdk

Full-featured agent SDK with local SQLite storage, cloud sync, agent lifecycle management, and offline-first architecture.

Local StorageSyncOffline-First
View docs
code

TypeScript Client

@rekall/client

Lightweight REST client. Thin wrapper around the Rekall API with full type safety. No local storage -- ideal for server-side and simple use cases.

RESTLightweightServer-Side
View docs
terminal

Python SDK

rekall-agent-sdk

Async-first Python SDK with agent lifecycle, memory operations, entity management, and full type hints.

Async/AwaitType HintsLocal Storage
View docs
speed

Go SDK

github.com/rekall-ai/rekall-go

Goroutine-safe Go SDK with context-based APIs, builder patterns, and struct-typed responses.

Goroutine-SafeContext APIBuilder Pattern
View docs
Rekall
rekall