SDKs

npm install ultracontext

yarn add ultracontext

pnpm add ultracontext

bun add ultracontext

pip install ultracontext

import { UltraContext } from 'ultracontext';
const uc = new UltraContext({ apiKey: process.env.ULTRACONTEXT_API_KEY });
const ctx = await uc.create();

// append messages
await uc.append(ctx.id, { role: 'system', content: 'You are a helpful assistant.' }); // v0
await uc.append(ctx.id, { role: 'user', content: 'Hello!' }); // v0

// update and delete messages
await uc.update(ctx.id, { index: 0, content: 'New system prompt.' }); // v1
await uc.delete(ctx.id, -1); // v2

// context is automatically versioned — fetch with history
const { data, versions } = await uc.get(ctx.id, { history: true });
// → versions: [
//     { version: 0, operation: 'create', affected: null },
//     { version: 1, operation: 'update', affected: ['msg_a'] },
//     ...
// ]

// use it with your favorite LLM framework
const response = await generateText({ model, messages: data });

import os
from ultracontext import UltraContext
uc = UltraContext(api_key=os.environ["ULTRACONTEXT_API_KEY"])
ctx = uc.create()

# append messages
uc.append(ctx["id"], {"role": "system", "content": "You are a helpful assistant."})  # v0
uc.append(ctx["id"], {"role": "user", "content": "Hello!"})  # v0

# update and delete messages
uc.update(ctx["id"], {"index": 0, "content": "New system prompt."})  # v1
uc.delete(ctx["id"], -1)  # v2

# context is automatically versioned — fetch with history
result = uc.get(ctx["id"], history=True)
# → result["versions"]: [
#     {"version": 0, "operation": "create", "affected": None},
#     {"version": 1, "operation": "update", "affected": ["msg_a"]},
#     ...
# ]

# use it with your favorite LLM framework
response = generate_text(model=model, messages=result["data"])

await uc.append(ctx.id, {
    role: 'user',
    content: 'Hello!',
    model: 'gpt-4o',
    tokens: 150,
    custom_field: 'anything',
});

uc.append(ctx["id"], {
    "role": "user",
    "content": "Hello!",
    "model": "gpt-4o",
    "tokens": 150,
    "custom_field": "anything"
})