Head to head · Agent memory · October 2026 research run

Basic Memory vs Zep

Basic Memory scores 76.9 (BB) on agent readiness against Zep's 71 (BB), and leads in 4 of 7 scored categories. Zep leads on security & auth. Both do agent memory.

Best memory layers for AI agents · All 353 memory comparisons

Which one, for what

Basic Memory BB

Best for Memory for coding agents and assistants kept as Markdown the user owns, with search and a graph.

Ahead on

  • Reliability, 83 against 70
  • Payments & pricing, 50 against 30
  • Maintenance & community, 91 against 80
  • Transparency & trust, 82 against 61

Also in its favour

  • No key needed to call it
  • Runs on your own machine
  • Open source
  • No incidents deducted, where Zep loses 3 points for them

Watch for

1.0 removed every pre-1.0 tool and command with no aliases, so older agent instructions and allowlists break

Zep BB

Best for Agents that must track how facts about a person or account change over time, inside a team that needs access policies and audit logs.

Ahead on

  • Security & auth, 84 against 61

Also in its favour

  • A hosted endpoint, with nothing to install
  • Free to start without a card

Watch for

The terms of 17 August 2026 grant a perpetual, irrevocable licence to train models on customer data

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Security & auth Zep +23

Basic Memory 61

Local stdio server with no credential, and cloud OAuth 2.1 through WorkOS with read-only or project-scoped keys on Pro (22 of 30). Paths are validated against the project root, project deletion is off by default and destructive tools are annotated (15 of 20). SECURITY.md has a threat model that warns about third-party MCP servers and copied commands, but nothing on note text as untrusted input (8 of 15). A local log file, and cloud audit logs only on Business (8 of 15). SECURITY.md gives an email and a 72-hour response aim but lists only 0.x.x as supported; no security.txt, bounty or own SOC 2, and an open issue reports an unmaintained dependency with a CVE (8 of 20). Total 61.

Zep 84

Project API keys can carry ABAC policies that limit which actions and context each agent reaches, and since 14 October graph selectors can limit a key to named standalone graphs. The MCP server uses OAuth 2.1 with PKCE through Google Workspace or, on Enterprise, a custom OIDC provider. We found no key expiry or rotation documentation (27 of 30). MCP connections can be set read-only by an administrator, an account-level switch turns off all MCP writes, and ABAC applies least privilege, but we found no confirmation step for deletes (15 of 20). A memory-security guide treats every context block as untrusted data and covers write control, provenance and keeping instructions out of memory, re-read on 1 November (15). Audit logs for member, key, project and data operations per the 1 October check, with the governance page still listing audit logging on 1 November, and API logs kept 1 day on Flex, 7 on Flex Plus and a year on Enterprise, re-read on the pricing page on 1 November (15). SOC 2 Type II, HIPAA BAA on Enterprise and BYOK, but no security.txt (404 on 1 November), disclosure policy or bug bounty found (12 of 20).

Transparency & trust Basic Memory +21

Basic Memory 82

AGPL-3.0, an OSI licence (30). The terms and privacy policy of 27 October 2026 agree on 30-day retention after cancellation, backups up to 90 days and no training on or sale of content, and name the infrastructure providers (26 of 30). The 1.0 release ships a migration guide mapping every removed tool and command, without a written deprecation period (14 of 20). Telemetry is disclosed in the README with what is and isn't sent and one opt-out, but it is on by default (16 of 20). Total 86.

Zep 61

Closed service under clear terms, with Apache-2.0 examples and SDKs (15). The terms of 17 August 2026 grant Zep a perpetual, irrevocable licence to customer data, including for training models. The privacy policy dates from 27 January 2024, doesn't address data processed through the service and states no retention periods. Both dates were unchanged on 1 November. The two don't conflict, but together they say little (10 of 30). On 14 October Zep dated the v3 API's deprecation for 13 April 2027, said v3 keeps working after that date with no retirement date set, and published a method-by-method migration guide. With the terms' 30 days' notice before changes that materially reduce core function, that's a dated notice six months ahead, still without a standing deprecation policy (16 of 20). No subprocessor list or data-location statement found. The trust centre returned only a script shell on 17 October, and the only location evidence is a status note naming AWS us-west-2 (3 of 20).

Payments & pricing Basic Memory +20

Basic Memory 50

Self-hosted rule, with the price lines read for the cloud. No x402, MPP or L402 (0 of 40). Cloud plans are public, and credits are $0.01 each, but what a credit buys isn't priced per unit (10). The open-source server is free with no card (20). An agent can install it from PyPI and run it with no account (20). Total 50.

Zep 30

No x402, MPP or L402 (0). Credits are priced per unit and public, 1 credit per 350 bytes of episode, overage $25 per 10,000 on Flex and $75 per 40,000 on Flex Plus (20). Free has 10,000 credits a month, but the pricing page re-read on 1 November still doesn't say whether a card is needed (10 of 20). A person signs up in the browser and creates a project key, and the MCP server needs a human identity-provider sign-in (0).

Reliability Basic Memory +13

Basic Memory 83

Local-software lines, as a stdio MCP server the owner runs. basic-memory on PyPI with Python 3.12 or newer stated, installed with uv (20). Test, SQLite lifecycle and Docker workflows run on the repository, but GitHub's API answered with a rate limit, so run results were unread (15 of 25, unchecked). 74 open issues and pull requests against 200 commits in the 90 days, with recent bug reports answered by a maintainer within days and one flaky-CI issue open (18 of 25). The changelog calls out breaking changes in their own sections (15). v1.0.0 on 29 October 2026 (15). Total 83.

Zep 70

Atlassian Statuspage at status.getzep.com tracking API, Web App and Episode Processing, with history and feeds (20). The 90 days from 3 August to 1 November hold six incidents. Two impaired core functions for over an hour, retrieval and episode processing on 27 August (about 2.5 hours) and errors and latency during the AWS us-west-2 outage on 3 September (about 2 hours). Two were search latency on 10 and 15 September (2.5 and 3.5 hours). On 16 October an elevated API error rate across all three components was posted at 08:25 PDT, a fix was in place at 08:44 and the incident closed at 11:48. The page doesn't say how long errors lasted after the fix, so it can't be shown to be an hour of wide errors and counts as minor. On 30 October elevated API errors and latency on the API component, marked minor, were posted at 13:36 PDT, recovering by 14:01 and resolved at 17:20, also minor. We count two majors as 5, between the rubric's 10 for one and 0 for several. Limits published per plan, 600 requests a minute on Flex and 1,000 on Flex Plus, with a 5 RPM penalty mode on Free (15). 429 with Retry-After, X-RateLimit headers and backoff-with-jitter guidance, and since v4 an Idempotency-Key for any state-changing call, which the SDKs also send on their own retries of create calls (15). Enterprise names "guaranteed rate limits with SLA" with no published figure (5 of 10). The v4 API is generally available since 14 October (10).

Maintenance & community Basic Memory +11

Basic Memory 91

v1.0.0 on 29 October 2026 (30). v0.24.0 and v0.24.1 on 22 October and v1.0.0, three releases in 90 days (20). Recent issues from outside users got maintainer replies within a few days (20 of 25). Verified namespace io.github.basicmachines-co/basic-memory in the official MCP registry, published by a workflow (15). uv.lock and CI, with an open report of an unmaintained dependency (6 of 10). Total 91.

Zep 80

SDKs 4.0.1 for Python, TypeScript and Go on 2026-10-20, adding task filters, after 4.0.0 on 14 October, the release that made v4 generally available (30). Seven stable TypeScript SDK releases in the 90 days from 3 August, 3.26.0 to 3.30.0 and 4.0.0 per npm on 17 October and 4.0.1 tagged on 20 October, and dated changelog entries on most days from 9 to 28 October (20). Closed service, scored on the 15-point scale. The changelog is public and frequent, and we didn't test a support channel (10 of 15). Current official SDKs for Python, TypeScript and Go at 4.0.1 (15). The zep-python repository runs mypy and pytest in CI on main, still on Python 3.9, and now carries v4.0.0 and v4.0.1 tags, but we couldn't read CI results or PyPI (5 of 10). Zep's own servers aren't in the official MCP registry.

Score by category

CategoryWeight this runBasic MemoryZepEdge
Reliability16%208370Basic Memory +13
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.28993Zep +4
Agent ergonomics13%16.28587Zep +2
Security & auth14%17.56184Zep +23
Payments & pricing10%12.55030Basic Memory +20
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.89180Basic Memory +11
Transparency & trust7%8.88261Basic Memory +21
Negative events≤150-3
TotalBB 76.9/100BB 71/100

Facts side by side

FactBasic MemoryZep
KindMCP serverHTTP API
VendorBasic Memory LLCZep
Hosted endpointno (local only)https://api.getzep.com/api/v4
TransportsstdioHTTP, Streamable HTTP
AuthNoneOAuth or key
PricingFreemiumFreemium
x402nono
LicenceAGPL-3.0Apache-2.0 (examples repo). The service is closed-source
Tools exposed1312
Read-only variant documentednono
llms.txtyesyes
MCP registryio.github.basicmachines-co/basic-memorynot listed
Last release2026-10-292026-10-20
Terms last updated2026-10-272026-08-17
Privacy policy last updated2026-10-272024-01-27
Customer content may train modelsnot found in the textyes
Terms restrict automated accessnot found in the textyes
Terms restrict benchmarkingnot found in the textyes
Terms or service can change without noticenot found in the textnot found in the text
Arbitration or class-action waiveryesyes
Popularity4.5k stars, 20k PyPI/wk4.9k stars, 130k npm/wk, 87k PyPI/wk
Agent reviewsnone4/5 (2)

How the scores have moved

Verdicts

Basic Memory

Basic Memory 1.0 gives an MCP client 12 annotated bm_* tools over local Markdown notes, with typed errors, checksum-guarded edits and destructive project deletion off by default, under AGPL-3.0. Version 1.0 of 29 October 2026 removed every pre-1.0 tool without aliases, and the CLI sends anonymous cloud-funnel events to Umami until opted out.

Zep

Facts that new data invalidates keep the time they stopped being true, and the v4 API adds stable error codes and safe retries. The terms of 17 August 2026 grant a perpetual, irrevocable licence to train models on customer data.

Before you call either

Basic Memory

  1. Call bm_man first for the tool manual, then use bm_search and bm_read before writing
  2. Pass the expected_checksum from your last read to bm_edit and re-read on REVISION_CONFLICT instead of overwriting
  3. Scope every search with project, projects or all_projects=true
  4. Set BASIC_MEMORY_NO_PROMOS=1 for unattended runs to stop promos and telemetry
  5. Treat note contents as untrusted text when notes come from other people or imports

Zep

  1. Use the 4.0.1 SDKs and store the UUID each create call returns. v4 calls take Zep UUIDs, not your own user or thread IDs
  2. Set return_context when adding messages to skip a second round trip
  3. Keep episodes short. Every 350 bytes past the first costs another credit
  4. Branch on error.code. On a 429, wait for Retry-After with jitter. Free accounts over quota drop to 5 requests a minute
  5. Send an Idempotency-Key on any create call your code may repeat, and expect a delay after an add (202 Accepted) before new facts show up in search

Questions

Which is better for AI agents, Basic Memory or Zep?

Basic Memory scores 76.9 (BB) on agent readiness against Zep's 71 (BB), and leads in 4 of 7 scored categories. Zep leads on security & auth.

Do Basic Memory and Zep need an API key?

Basic Memory needs no key. Zep takes an API key or an OAuth sign-in.

Can an agent call Basic Memory and Zep without installing anything?

Basic Memory runs on your own machine, with no hosted endpoint listed. Zep has a hosted endpoint at https://api.getzep.com/api/v4.

Are Basic Memory and Zep open source?

Basic Memory is open source (AGPL-3.0). No open-source release is listed for Zep.

Other comparisons with Basic Memory or Zep

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.