Get started with Illumina

curl -X POST "https://api.illumina.sh/v1/default/namespaces/demo/memories" \
  -H "Authorization: Bearer $ILLUMINA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"content":"Ada shipped the payments rewrite in Q3 2025."}]}'

curl -X POST "https://api.illumina.sh/v1/default/namespaces/demo/memories/recall" \
  -H "Authorization: Bearer $ILLUMINA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"who shipped payments?","budget":"mid"}'

from illumina_client import Illumina

client = Illumina(
    base_url="https://api.illumina.sh",
    api_key="sub_live_...",
)

client.retain(
    namespace_id="demo",
    content="Ada shipped the payments rewrite in Q3 2025.",
)

results = client.recall(
    namespace_id="demo",
    query="who shipped payments?",
    budget="mid",
)

import { IlluminaClient } from "@illumina/client";

const client = new IlluminaClient({
  baseUrl: "https://api.illumina.sh",
  apiKey: "sub_live_...",
});

await client.retain("demo", "Ada shipped the payments rewrite in Q3 2025.");

const results = await client.recall("demo", "who shipped payments?", {
  budget: "mid",
});