Sovant Documentation

Sovant Documentation

Sovant is Memory-as-a-Service: a durable, queryable memory layer for AI apps with cross-model recall, hybrid (semantic + deterministic) retrieval, and simple SDKs.

Key Features

  • Memory API - Store, retrieve, and search contextual memories with CRUD operations
  • Chat + SSE - Real-time streaming chat with memory context via Server-Sent Events
  • Profile Recall - Extract and canonicalize user profile facts automatically

Quickstart JavaScript

npm install @sovant/sdk@1.1.1
import { Sovant } from '@sovant/sdk';

const client = new Sovant({
  apiKey: 'sk_live_your_api_key',
  baseUrl: 'https://sovant.ai' // default
});

// Create a memory
const memory = await client.memory.create({
  content: 'User prefers dark mode',
  type: 'preference',
  tags: ['ui', 'settings']
});

// Stream chat with memory context
const session = await client.chat.createSession({ title: 'Demo' });
const stream = await client.chat.sendMessage(session.id, {
  message: 'hello',
  provider: 'openai',
  model: 'gpt-4o-mini',
  stream: true,
  useMemory: true
});

for await (const ev of stream) {
  if (ev.type === 'delta') process.stdout.write(ev.data || '');
}

Quickstart Python

pip install sovant==1.0.6
from sovant import Sovant

client = Sovant(
    api_key="sk_live_your_api_key",
    base_url="https://sovant.ai"  # default
)

# Create a memory
memory = client.memory.create({
    "content": "User prefers dark mode",
    "type": "preference",
    "tags": ["ui", "settings"]
})

# Search memories
results = client.memory.search({
    "query": "user preferences",
    "limit": 10
})

Next Steps