Repository navigation
Releases
Releases · fadymondy/zekra
v0.1.0: first public release
Zekra (ذكرى) is shared long-term memory for AI agents. Claude Code, Codex, Gemini, Cursor or your own agents connect to it over MCP. What one session learns, the next one already knows. Recall comes back with citations.
This is the first tagged release.
Highlights
- Retain / recall: hybrid retrieval (dense vectors + multilingual BM25 fused with RRF, reranking, 1-hop entity expansion). A write-decision step (ADD / UPDATE / INVALIDATE / NOOP) updates contradicted facts instead of duplicating them. Nothing is hard-deleted.
- Many brains: one namespace per project or team, with per-agent grants and access tokens enforced server-side.
- Knowledge graph: entities and typed relations with traverse / neighbors / path / ontology queries.
- Data sources:
text,markdown,crawler,github,sqlandwebhookconnectors feed the same write pipeline. - Media memories: OCR, speech and live camera, plus phone camera pairing over QR.
- Web console rebuilt on Nasaq: home dashboard, search, notes workspace, memory graph and admin pages.
- MCP registry ready:
server.json(io.github.fadymondy/zekra) andglama.jsonadded. - Hardening: stricter OAuth dynamic client registration, security headers on every response, vault refs protected from secret capture, and dependency upgrades for reachable advisories.
- License: AGPL-3.0-only.
Quick start
curl -fsSL https://app.zekra.dev/install.sh | sh # installs the `zekra` CLI
zekra auth login --token <cbt_…>
zekra mcp:install claude-code # or claude-desktop | codex | gemini | cursorHosted MCP endpoint: https://mcp.zekra.dev. To self-host, see the self-hosting guide.
Links
- Docs: https://zekra.dev/en/docs
- Console + API: https://app.zekra.dev
- CLI: https://github.com/fadymondy/zekra-cli
- Discussions: https://github.com/fadymondy/zekra/discussions
⭐ Useful? Star the repo so other agent builders can find it.