Quickstart

$env:MEMORYOS_API_KEY="mem_live_your_key"

export MEMORYOS_API_KEY="mem_live_your_key"

pip install memoryo-sdk

npm install memoryo-sdk

import os
from memoryos import Memory

with Memory(api_key=os.environ["MEMORYOS_API_KEY"]) as memory:
    write = memory.add(
        messages=[
            {"role": "user", "content": "Please remember that I prefer concise Python examples."}
        ],
        external_user_id="customer-123",
    )

    if not write.job_id:
        raise RuntimeError(f"Memory write was not queued: {write.status}")

    job = memory.wait_for_job(write.job_id)
    if not job.succeeded:
        raise RuntimeError(f"Memory write failed: {job.error_summary or job.status}")

    result = memory.get(
        query="How should you explain technical topics to me?",
        external_user_id="customer-123",
    )
    print(result.system_prompt_addition)

import { MemoryOS } from "memoryo-sdk";

const memory = new MemoryOS(process.env.MEMORYOS_API_KEY!);

const write = await memory.add(
  [{ role: "user", content: "Please remember that I prefer concise TypeScript examples." }],
  "customer-123",
);

if (!write.jobId) {
  throw new Error(`Memory write was not queued: ${write.status}`);
}

const job = await memory.waitForJob(write.jobId);
if (!job.succeeded) {
  throw new Error(`Memory write failed: ${job.errorSummary ?? job.status}`);
}

const result = await memory.get({
  query: "How should you explain technical topics to me?",
  externalUserId: "customer-123",
});
console.log(result.systemPromptAddition);