Skip to main content

kormem

Local long-term memory for AI agents. kormem indexes everything you say to assistants and every file, folder or URL you add, files it into an Obsidian-compatible vault of linked notes, and answers questions with a small recall agent that returns dated findings and their sources.

The commands follow QMD: collection add, context add, search, vsearch, query, get, multi-get and ls work the same way.

pip install kormem            # or: uvx kormem …, npm install -g kormem, bunx kormem …
kormem init                   # key file, engine, background services, Claude Code plugin

kormem collection add ~/notes --name notes
kormem context add kormem://notes "Personal notes and ideas"
kormem search "project timeline"            # keyword search
kormem vsearch "how to deploy"              # semantic search
kormem query "what did we decide about X?"  # recall agent (best quality)
kormem get "#abc123"                        # open a source by docid
kormem remember "I prefer pnpm over npm"
kormem mcp                                  # MCP server for Claude Code, Claude Desktop, Cursor

kormem needs one key: put GEMINI_API_KEY in ~/.kormem/.env, which kormem init creates. It runs embeddings, extraction and the recall agent. Without it, kormem still indexes and searches locally. kormem doctor checks the setup.

Benchmark

LongMemEval-S, all 500 questions, scored by the official GPT-4o judge. Each question gets one answer from a curated context of about 19k tokens.

System Answer model Accuracy
Mastra Observational Memory gpt-5-mini 94.9%
Kormem Claude Sonnet 5.5 94.4%
Kormem GPT-6.1 Sol 94.0%
Mem0 platform GPT-5 (custom judge) 93.4–94.4%
gbrain Claude Sonnet 4.6 86.6%
Supermemory Gemini 3 Pro 85.2%
Zep GPT-4o 71.2%

Other systems' numbers are self-reported. Setups and caveats: full report.

Full documentation, diagrams and the Claude Code plugin: https://github.com/kushalsinha/kormem

Metadata

Release files for kormem 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kormem 0.1.1
File Size Uploaded Provenance
kormem-0.1.1.tar.gz 150.4 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for kormem 0.1.1
File Interpreter ABI Platform
kormem-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 318.3 kB

Release files / kormem-0.1.1.tar.gz

Download URL kormem-0.1.1.tar.gz
Size 150.4 kB
Tags Source
SHA-256 checksum
How to use checksums
c86989701e420bfe01c3309bcca5e86c48474776a5212d0eee0b84e695fd2d6b
BLAKE2b-256 checksum
How to use checksums
1bf49e69ed4019d4599cc4febea10e8aaacaeaf72d784a0484b202a91bfe2de9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / kormem-0.1.1-py3-none-any.whl

Download URL kormem-0.1.1-py3-none-any.whl
Size 167.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c178c34cdefa452eaaceddbc17e7d3c0cd0e9eaccd3ffbbd49dba51879fdd7bb
BLAKE2b-256 checksum
How to use checksums
349ee849ecbf9fd4e1cc93ebb945bddecbc93a23fd0a4b7485ac698ac9745097
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for kormem 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page