Korely Memory

Memory for AI agents that knows what is still true.

Korely stores what your agent learns as typed facts with a validity window. When something changes, the old fact is superseded instead of overwritten. Your agent reads the current truth, and you can still ask what was true on any past date.

import time
from korely_memory import Korely

korely = Korely()  # reads KORELY_API_KEY from the environment

korely.add("Maria is on the Pro plan, billed yearly.", user_id="maria")
korely.add("Maria downgraded to Free.", user_id="maria")

time.sleep(10)  # facts are extracted server-side; see "Writes settle asynchronously"

ctx = korely.get_context(query="what plan is Maria on?", user_id="maria")
print(ctx.context)
# ## Known facts
# - Maria downgraded_to Free (since 2026-09-08)
# - Maria billing_frequency yearly (since 2026-09-08)
#
# Pro is gone from the current facts. It was superseded, not deleted.

The exact predicate is chosen by the extractor, so downgraded_to here might be subscribes_to or plan on your run. What is guaranteed is the behaviour: the old value leaves the current set, and stays retrievable with its invalid_at.

Nothing was deleted. The Pro fact is still there, carrying invalid_at and a pointer to what replaced it:

korely.get_facts(user_id="maria", include_invalidated=True)
# Maria downgraded_to Free    valid_from=... invalid_at=None
# Maria plan Pro              valid_from=... invalid_at=2026-09-08T08:31:09Z

Time travel over real dates

Pass timestamp when the event happened in the past, and facts inherit it as valid_from. Then as_of answers over the world's timeline, not your ingestion order:

korely.add("Franco signed up on the Pro plan.", user_id="franco", timestamp="2026-01-15")
korely.add("Franco downgraded to Free.",        user_id="franco", timestamp="2026-06-20")

korely.get_facts(user_id="franco", as_of="2026-03-01")   # subscribes_to -> Pro plan
korely.get_facts(user_id="franco", as_of="2026-08-01")   # subscribes_to -> Free
korely.get_facts(user_id="franco")                       # subscribes_to -> Free

Without timestamp every fact starts being true the moment you write it, so as_of on an earlier date returns nothing. That is correct, and usually not what you want when you are importing history.

Writes settle asynchronously

add() returns as soon as the memory is stored, then extraction runs server-side. That means:

The time.sleep(10) above exists only so the snippet works when you paste it. You do not need it in production: an agent writes at the end of one turn and reads at the start of the next, and by then the facts are there. If you do need to read right after a write, poll get_facts() until it returns what you expect.

Install

pip install korely-memory      # Python, plus the `korely` CLI
npm install korely-memory      # Node / TypeScript

Both clients have zero runtime dependencies.

Get a key

The hobby tier is free and needs no signup form:

curl -X POST https://api.korely.ai/v1/agents/init \
  -H 'Content-Type: application/json' \
  -d '{"agent_caller": "your-name-here"}'

The response carries a kor_live_ key. Set it as KORELY_API_KEY and the SDK, the CLI, and the REST API all authenticate with it.

Or let the CLI do it for you. korely init saves the key to ~/.korely/config.json, and the SDK reads it from there when KORELY_API_KEY is not set, so this is enough to get going:

pip install korely-memory
korely init --agent --agent-caller your-name
python -c "from korely_memory import Korely; print(Korely().get_context(query='hi').tokens)"

TypeScript

import { Korely } from "korely-memory";

const korely = new Korely();

await korely.add("Maria downgraded to Free.", { user_id: "maria" });
const ctx = await korely.getContext({ query: "what plan is Maria on?", user_id: "maria" });

CLI

korely add "Maria downgraded to Free." --user-id maria
korely context "what plan is Maria on?" --user-id maria
korely facts --as-of 2026-03-01 --user-id maria

What Korely does

• Typed facts. Subject, predicate, object, extracted server-side. No prompt engineering on your side.

• Bi-temporal validity. Every fact carries valid_from and invalid_at, so the store separates when something was true from when it was recorded.

• Contradiction resolution. A new fact that conflicts with an old one supersedes it and records which fact replaced it. Nothing is silently dropped.

• Point-in-time queries. as_of answers what the store believed on any past date.

• Entity graph. Entities and relations are extracted automatically and available on every tier, including free.

• Hybrid retrieval. Keyword, vector, and graph signals fused for recall.

• Prompt-ready context. get_context() returns a block you can paste straight into a system prompt, with the token count.

• EU-hosted. Runs in Helsinki. End users can see, correct, and erase what agents remember about them.

Repository layout

MCP

Korely runs a hosted MCP server, so a coding agent can read and write memory without any package:

claude mcp add --transport http korely https://api.korely.ai/agent/mcp \
  --header "Authorization: Bearer kor_live_..."

Documentation

Full REST contract, concepts, and integration guides: korely.ai/agents/docs

License

MIT. These clients are open source; the hosted service they talk to is not.