File size: 9,058 Bytes
625bd6a 943b798 2cf7040 943b798 1271f76 943b798 2cf7040 1271f76 943b798 b2101ae 943b798 2cf7040 1271f76 2cf7040 943b798 2cf7040 943b798 2cf7040 943b798 2cf7040 943b798 2cf7040 943b798 2cf7040 943b798 2cf7040 943b798 2cf7040 943b798 2cf7040 1271f76 943b798 2cf7040 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 | ---
license: mit
tags:
- agent-memory
- long-term-memory
- llm
- ai-agents
- mcp
- retrieval
- sqlite
- rag
---
> **Read-only mirror of [`Sibyl-Labs/Sibyl-Memory`](https://github.com/Sibyl-Labs/Sibyl-Memory).** The canonical source is on GitHub. Install from PyPI: `pip install -U sibyl-memory-cli` · Docs: https://docs.sibyllabs.org/memory/ · Product: https://sibyllabs.org/plugin · Benchmarks: https://blog.sibylcap.com/beta-analysis
<div align="center">
```
███████╗██╗██████╗ ██╗ ██╗██╗
██╔════╝██║██╔══██╗╚██╗ ██╔╝██║
███████╗██║██████╔╝ ╚████╔╝ ██║
╚════██║██║██╔══██╗ ╚██╔╝ ██║
███████║██║██████╔╝ ██║ ███████╗
╚══════╝╚═╝╚═════╝ ╚═╝ ╚══════╝
M E M O R Y
```
**agentic memory infrastructure · file-based · zero embeddings**
[](https://pypi.org/project/sibyl-memory-client/)
[](https://pypi.org/project/sibyl-memory-cli/)
[](https://pypi.org/project/sibyl-memory-hermes/)
[](https://pypi.org/project/sibyl-memory-mcp/)
[](./LICENSE)
[](https://www.python.org/downloads/)
[](https://blog.sibylcap.com/longmemeval-v2)
<sub><i>built by an autonomous agent · sibyl labs llc</i></sub>
</div>
---
## What this is
Four PyPI packages, one schema family, one architecture.
`sibyl-memory-client` is a local-first agentic memory SDK. SQLite-backed, five-tier hierarchical schema, FTS5 search, multi-tenant by design. No vector database. No embedding model. No external retrieval service. The memory lives on the agent's machine; the substrate is a single file on disk.
The other three packages ride on top: `sibyl-memory-cli` for activation and tier management, `sibyl-memory-hermes` for Hermes Agent integration, and `sibyl-memory-mcp` for any MCP-compatible client (Claude Code, Codex, Cursor, Continue).
The architecture was benchmarked publicly on [LongMemEval Oracle](https://blog.sibylcap.com/longmemeval-v2) (ICLR 2025, University of Michigan, 500 questions) and placed **#2 overall at 95.6%**, tied with Chronos (PwC), beating Mastra, MemMachine, Hindsight, Mem0, Supermemory, Zep, and the Oracle baseline. It is the only file-based system in the top tier: running on a single 4 vCPU / 16 GB box, no vector infrastructure, no embedding fees.
This is the entire stack as it ships to production agents today.
---
## Packages
| Package | PyPI | Description |
|---|---|---|
| [`sibyl-memory-client`](./sibyl-memory-client) | [](https://pypi.org/project/sibyl-memory-client/) | Local-first agentic memory SDK. SQLite-backed five-tier hierarchical schema, FTS5 search, multi-tenant, with self-learning skill detection and local memory linter. Foundation of the plugin family. |
| [`sibyl-memory-cli`](./sibyl-memory-cli) | [](https://pypi.org/project/sibyl-memory-cli/) | Command-line interface. `sibyl init` activates, `sibyl upgrade` runs the staker / subscription flow, `sibyl status` shows current tier and DB stats, `sibyl whoami`, `sibyl devices`. |
| [`sibyl-memory-hermes`](./sibyl-memory-hermes) | [](https://pypi.org/project/sibyl-memory-hermes/) | Bundled memory payload for Hermes Agent v0.13+ (and any other Python orchestration that wants direct SDK access). |
| [`sibyl-memory-mcp`](./sibyl-memory-mcp) | [](https://pypi.org/project/sibyl-memory-mcp/) | MCP server. Wraps the local SQLite + FTS5 memory engine and exposes it to MCP-compatible agents (Claude Code, Codex, Cursor, Continue, anything that speaks MCP). |
---
## Install
```bash
pip install sibyl-memory-cli
sibyl init
```
`sibyl init` opens a browser to activate your account, binds your wallet or email, and writes credentials to `~/.sibyl-memory/credentials.json`. Free tier is the default; staker and subscription tiers unlock self-learning, the memory linter, and remove the local cap.
For direct SDK use:
```bash
pip install sibyl-memory-client
```
For Hermes integration:
```bash
pip install sibyl-memory-hermes
sibyl-memory-hermes install-plugin
# then edit ~/.hermes/config.yaml:
# memory:
# provider: sibyl
```
For MCP (Claude Code, Codex, Cursor, Continue, ...):
```bash
pip install sibyl-memory-mcp
# then point your MCP client at the server entry point.
```
Full documentation at [docs.sibyllabs.org/memory](https://docs.sibyllabs.org/memory/).
---
## Architecture
```
┌─────────────────────────────────────────────────────────┐
│ sibyl-memory-cli sibyl-memory-mcp │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ sibyl init │ │ MCP server │ │
│ │ sibyl status │ │ (stdio) │ │
│ │ sibyl whoami │ └──────┬───────┘ │
│ └──────┬───────┘ │ │
│ │ sibyl-memory-hermes │
│ │ ┌──────────────┐ │
│ │ │ Hermes hook │ │
│ │ └──────┬───────┘ │
│ │ │ │
│ └──────┬─────┘ │
│ ▼ │
│ sibyl-memory-client (SDK) │
│ ┌────────────────────────┐ │
│ │ SQLite + FTS5 │ │
│ │ 5-tier schema │ │
│ │ self-learning skills │ │
│ │ multi-tenant │ │
│ └────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
```
Each package has its own `README.md` and `CHANGELOG.md` for the detail.
The five tiers, in case you're curious:
```
HOT state/ live working state, rewritten in place
WARM entities/ single source of truth per (category, name)
COLD journal/ append-only event log
REFERENCE reference/ static knowledge, rarely changes
ARCHIVE archive/ retired entities, kept for audit
```
Rule 43 (single source of truth per entity) is enforced at the schema level via a `UNIQUE (tenant_id, category, name)` constraint, not just a convention in the application code. Drift is impossible by construction.
---
## Provenance
Built by [SIBYL](https://x.com/sibylcap), the autonomous agent operating at [Sibyl Labs LLC](https://sibyllabs.org).
The agent has been operating in production since February 2026, ships code daily, holds an on-chain identity on Base (ERC-8004 agent ID 20880), runs an autonomous trading engine, an on-chain messaging protocol, an x402 payment rail, a token-gated chat demo, an advisory dashboard, and this memory product family. Everything verifiable on-chain.
Memory architecture is the proven core. Sibyl Labs LLC owns the IP, signs contracts, and holds the legal wrapper around the agent's work. The work itself is shipped by the agent, in sessions, through the operator (`@tradingtulips`). The PyPI releases, the CLI, the SDK, the CLI banner above: all of it is autonomous agent output.
The on-chain record is the resume. This repository is one chapter of it.
---
## License
MIT. See [LICENSE](./LICENSE).
Copyright (c) 2026 Sibyl Labs LLC.
|