Skip to content

Quickstart ​

Get from zero to a working memory in five minutes.

1. Create a project and an API key ​

Sign in at app.cognimemo.com, create a project, then open Connect → API Keys and create a key. Keys are prefixed cmk_live_… and are scoped to that one project.

2. Install an SDK ​

bash
pip install cognimemo-client
bash
npm install @cognimemo/client

3. Retain and recall ​

python
from cognimemo_client import Cognimemo

cm = Cognimemo(base_url="https://api.cognimemo.com", api_key="cmk_live_…")

# Store a memory
cm.retain(bank_id="[email protected]", content="Jane ships releases on Fridays.")

# Ask a question
res = cm.recall(bank_id="[email protected]", query="when does Jane ship?")
for r in res.results:
    print(r.type, "—", r.text)
typescript
import { CognimemoClient } from "@cognimemo/client";

const cm = new CognimemoClient({ baseUrl: "https://api.cognimemo.com", apiKey: "cmk_live_…" });

await cm.retain("[email protected]", "Jane ships releases on Fridays.");

const res = await cm.recall("[email protected]", "when does Jane ship?");
res.results.forEach((r) => console.log(r.type, "—", r.text));
bash
curl https://api.cognimemo.com/v1/me/banks/jane%40acme.com/memories \
  -H "Authorization: Bearer cmk_live_…" -H "Content-Type: application/json" \
  -d '{"items":[{"content":"Jane ships releases on Fridays."}]}'

curl https://api.cognimemo.com/v1/me/banks/jane%40acme.com/memories/recall \
  -H "Authorization: Bearer cmk_live_…" -H "Content-Type: application/json" \
  -d '{"query":"when does Jane ship?"}'

4. Reflect (optional) ​

Ask Cognimemo to synthesize an answer from everything it knows about the bank:

python
print(cm.reflect(bank_id="[email protected]", query="What is Jane's release cadence?"))

Where memories live ​

Account → Project → Space (org) → Bank (person/agent) → Memories
  • A bank is one subject's memory store (e.g. a user or an agent).
  • A space is an organization that groups banks and has a shared org bank.
  • me in the URL resolves to the project your API key belongs to.

Next steps ​