Perseus

Perseus

Local-first memory and context layer that loads only the context AI agents need

Open Source
3.6 (8 reviews)

Gallery

About Perseus

Perseus is a memory and context layer for AI agents, built by Perseus Computing LLC, that tries to fix a mundane and expensive habit. An agent with no memory layer reloads its entire working set on every turn, meaning all its tools, the whole history, and every document, and the model gets billed for every token every time. Perseus resolves the workspace into verified facts before the context window opens, then retrieves only the memory a given task actually needs.

It ships as two products that sit on one layer. The first is the Perseus context engine, installed with pip install perseus-ctx, which resolves live state from git, services, tests, and the workspace into verified facts before a session opens, so agents don't burn turns re-orienting themselves. It exposes 33 MCP tools that resolve state at call time. The published numbers come from a 200-request live A/B where average prompt size fell from 488 tokens to 27, a 94 percent cut, with the tool manifest shrinking from 171 advertised schemas to 57 because each tool gets advertised once instead of three times under aliases. The site reports zero milliseconds of added P99 latency. The claim underneath all of it is that most of what an agent re-reads on each turn was never relevant to the task in front of it, and that resolving state once, up front, is simply cheaper than rediscovering it on every call.

The second product is Perseus Vault, a persistent encrypted memory engine that arrives as a single Rust binary of roughly eight megabytes, installed through a shell script. There's no Docker, no Postgres, and no cloud service behind it, which is the whole point. It exposes more than 55 MCP tools and works with any MCP host. Recall is hybrid, combining full-text search through FTS5 with dense embeddings and reciprocal rank fusion, and the embeddings ship inside the binary so it still works offline. Vault scores 73.8 percent on LongMemEval QA against the official harness, compared to 63.8 for Zep and 49.0 for Mem0. The one-file posture is doing real work here. Anything that needs Docker and a Postgres instance turns into a deployment negotiation, while a single binary is just a file you copy, which is often the difference between memory a team actually adopts and memory a team keeps meaning to adopt.

Vault exists because of a specific failure its creator, Thomas Connally, wrote about. A 2,000-note Obsidian vault stopped working as agent memory once it got large. Search degraded to unusable, the agent started hallucinating file contents, and context windows filled with irrelevant markdown. The diagnosis was that note-taking apps organize content for people to read, not for machines to retrieve, and that agents need structured machine-readable memory instead of human prose. On that hybrid recall, Vault reports 91.7 percent Recall@1 where keyword-only search managed 4.2 percent. It also does importance weighting, temporal decay, content-aware deduplication, and bi-temporal history, so you can ask what was true and when it was true. Those extras matter more than the list makes them sound. Weighting and decay keep a throwaway note from March from carrying the same force as a standing architectural decision, and dedup stops one fact from being stored twenty times over in slightly different words.

The security and sovereignty posture is where Perseus separates itself from the hosted memory services it competes with. Everything runs on your machine. Records are encrypted with AES-256-GCM at rest, there's an immutable crypto-chained audit journal, and the project advertises zero telemetry, no API keys, and no cloud calls at all. It's MIT licensed rather than GPL or AGPL, which the site points out means no copyleft and no lock-in. There's an SBOM per EO 14028, alignment with the NIST AI RMF, and an EAR99 classification, which together tell you exactly who this is courting, namely regulated, air-gapped, classified, and sovereign deployments that hosted tools can't legally reach. Zero telemetry is also the rare claim that's cheap for a buyer to verify, and the local-first design means there's no service sitting in the middle that could quietly start collecting later on.

It's worth being clear-eyed about the numbers. The benchmarks are measured on named hardware with rerunnable scripts, and the site is unusually careful to distinguish those from its value calculator, which lets you plug in fleet size and model tier to estimate token savings and is explicitly labeled an illustrative economic model rather than a measured result for your workload. That labeling is a good sign in a category where inflated savings claims are routine, though the token-savings framing still excludes output tokens and infrastructure.

Perseus is free and open source under MIT, with both products on GitHub under the Perseus-Computing-LLC organization and the context engine on PyPI. There's no subscription tier and no hosted service to sign up for, because a hosted service would defeat the local-first premise. A provisional patent is pending on the approach. The natural fit is anyone running a fleet of agents where token spend has become a real line item, or anyone who needs durable agent memory inside a boundary that nothing is allowed to leave. If you've watched an agent re-read the same notebook on every call and quietly resented the bill, this is the layer aimed squarely at that.

Key Features

  • Pre-session workspace state resolution
  • Single-binary encrypted memory engine
  • Hybrid BM25 and dense recall fusion
  • 88 MCP tools across both products
  • Bi-temporal fact history and decay
  • Air-gapped operation with zero telemetry

Pros & Cons

What we like

  • Cuts measured prompt tokens by 94 percent with no added P99 latency
  • Runs fully offline with no cloud dependency or API keys
  • MIT licensed with no copyleft or vendor lock-in
  • Benchmarks are reproducible and economic models are labeled as estimates

Room for improvement

  • Requires technical setup through pip and a shell installer
  • No hosted option if you'd rather not self-manage it
  • Value depends on running enough agents for token spend to matter
  • Younger project with a smaller community than hosted rivals

Frequently Asked Questions

What is Perseus?
Perseus is a local-first memory and context layer for AI agents from Perseus Computing LLC. It resolves workspace state into verified facts before the context window opens and retrieves only the memory a task needs, rather than letting an agent reload its whole working set on every call.
What's the difference between Perseus and Perseus Vault?
They're two halves of one layer. The Perseus context engine installs with pip and resolves live state from git, services, tests, and the workspace into facts at session start, exposing 33 MCP tools. Perseus Vault is a single Rust binary that stores persistent encrypted memory across sessions with 55 or more MCP tools and hybrid recall.
Is Perseus free?
Yes. Both products are open source under the MIT license, with the context engine on PyPI and both repositories on GitHub. There's no subscription and no hosted service, which follows from the local-first design. A provisional patent is pending on the approach.
Who is Perseus for?
It suits teams running enough agents that token spend has become a real cost, and anyone who needs agent memory that stays inside a boundary. The air-gapped posture, AES-256-GCM encryption, audit journal, SBOM per EO 14028, and EAR99 classification point it at regulated, sovereign, and classified deployments that hosted memory services can't serve.

Best For

Cutting the token bill across a fleet of agentsGiving agents durable memory between sessionsDeploying agent memory in air-gapped environmentsReplacing a note vault that agents can't search

Featured in

Alternatives to Perseus

View all

Reviews (8)

N
Nadia Singh

Powerful once it clicks

Tried Perseus on a side project first, then rolled it out everywhere. Got real value out of single-binary encrypted memory engine. It has shaved real time off my week. Mostly using it for replacing a note vault that agents can't search. The catch is no hosted option if you'd rather not self-manage it. Worth it for what I get out of it.

4/28/2026 15 found this helpful
J
Javier Weber

Worth a look

Perseus has quietly become part of my daily flow. The air-gapped operation with zero telemetry is more useful than I expected. It has shaved real time off my week. Found it works best for giving agents durable memory between sessions. It earns its place in my stack.

5/23/2026 12 found this helpful
S
Sebastian Nakamura Verified

Decent with some rough edges

Have been running Perseus for a while, here is where I land. Where it really wins is pre-session workspace state resolution. It just works, day after day, without surprises. Mostly using it for deploying agent memory in air-gapped environments. It would be a five if not for value depends on running enough agents for token spend to matter.

6/12/2026 3 found this helpful
T
Tunde Khouri Verified

Pulled its weight from week one

Hadn't planned on switching, but Perseus was hard to ignore. Where it really wins is benchmarks are reproducible and economic models are labeled as estimates. Mostly using it for replacing a note vault that agents can't search. It earns its place in my stack.

5/13/2026 3 found this helpful
R
Ren Pereira Verified

Powerful once it clicks

Perseus has quietly become part of my daily flow. What stands out is how it handles 88 mcp tools across both products. It slotted into my routine without much fuss. Found it works best for deploying agent memory in air-gapped environments. It would be a five if not for younger project with a smaller community than hosted rivals.

7/4/2026 1 found this helpful
K
Karim Larsen

Two months in, no regrets

Hadn't planned on switching, but Perseus was hard to ignore. It has shaved real time off my week. It earns its place in my stack.

5/3/2026 1 found this helpful
K
Kabir Martin Verified

Quietly excellent

Have been running Perseus for a while, here is where I land. Got real value out of bi-temporal fact history and decay. The defaults are sensible, so I was not fighting settings on day one. Recommending it to people in a similar spot.

5/1/2026 1 found this helpful
E
Emerson Perez Verified

Pulled its weight from week one

Picked Perseus for the price, stayed for the quality. Got real value out of bi-temporal fact history and decay. The interface stays out of my way, which I appreciate. Found it works best for cutting the token bill across a fleet of agents. No regrets so far.

6/10/2026