Metadata-Version: 2.4
Name: mnemo-db
Version: 0.4.1
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Rust
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Topic :: Database
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Requires-Dist: anthropic>=0.40 ; extra == 'anthropic-memory-tool'
Requires-Dist: datasets>=4.0 ; extra == 'benchmark'
Requires-Dist: claude-agent-sdk>=0.1 ; extra == 'claude'
Requires-Dist: watchdog>=4.0 ; extra == 'claude'
Requires-Dist: crewai>=0.40 ; extra == 'crewai'
Requires-Dist: pytest>=7.0 ; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23 ; extra == 'dev'
Requires-Dist: moto>=5.0 ; extra == 'dev'
Requires-Dist: langgraph-checkpoint>=0.2 ; extra == 'langgraph'
Requires-Dist: openai-agents>=0.1 ; extra == 'openai-agents'
Requires-Dist: boto3>=1.34 ; extra == 'openai-sandbox-r2'
Requires-Dist: cryptography>=42 ; extra == 'openai-sandbox-r2'
Requires-Dist: boto3>=1.34 ; extra == 'openai-sandbox-s3'
Requires-Dist: cryptography>=42 ; extra == 'openai-sandbox-s3'
Provides-Extra: anthropic-memory-tool
Provides-Extra: benchmark
Provides-Extra: claude
Provides-Extra: crewai
Provides-Extra: dev
Provides-Extra: langgraph
Provides-Extra: openai-agents
Provides-Extra: openai-sandbox-r2
Provides-Extra: openai-sandbox-s3
Summary: MCP-native memory database for AI agents
Keywords: mnemo,mcp,memory,ai,agent,llm,vector,embeddings,knowledge-graph,duckdb
License: Apache-2.0
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Bug Tracker, https://github.com/sattyamjjain/mnemo/issues
Project-URL: Changelog, https://github.com/sattyamjjain/mnemo/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/sattyamjjain/mnemo#readme
Project-URL: Homepage, https://github.com/sattyamjjain/mnemo
Project-URL: Repository, https://github.com/sattyamjjain/mnemo

# `mnemo-db`

PyPI distribution of [Mnemo](https://github.com/sattyamjjain/mnemo) — an MCP-native memory database for AI agents.

```bash
pip install mnemo-db
```

The package directory and import path are still `mnemo` — only the PyPI distribution name has the `-db` suffix because the unqualified `mnemo` is held by an unrelated 2021 notebook project. Your code keeps saying:

```python
from mnemo import MnemoClient
```

## Quick start

```python
from mnemo import MnemoClient

client = MnemoClient(db_path="agent.mnemo.db", agent_id="agent-1")

# Three primitives carry most workflows.
result = client.remember("The user prefers dark mode", tags=["preference"])
memories = client.recall("user preferences", limit=5)
client.forget([result["id"]])

# Mem0-compatible aliases also work:
# client.add(...), client.search(...), client.delete(...)
```

## What's in the box

| Surface | What |
| :-- | :-- |
| `MnemoClient` | Native PyO3 binding to the Rust engine — DuckDB storage, USearch HNSW vector index, Tantivy full-text index, hybrid retrieval, hash-chained audit log |
| `MnemoMemoryToolServer` | Anthropic `memory_20250818` 6-op handler. `pip install 'mnemo-db[anthropic-memory-tool]'` |
| `MnemoLettaShared` | Letta-style Conversations adapter for shared agent memory |
| `S3Workspace` / `CloudflareR2Workspace` | OpenAI Agents SDK GA snapshot store backends. `pip install 'mnemo-db[openai-sandbox-s3]'` or `[openai-sandbox-r2]` |
| `MnemoAgentMemory` (OpenAI), `Mem0Compat`, `ASMDCheckpointer` (LangGraph), 12 more | Drop-in framework integrations. Install the matching extra. |

## Optional extras

```bash
pip install 'mnemo-db[langgraph]'              # LangGraph checkpoint
pip install 'mnemo-db[crewai]'                 # CrewAI memory
pip install 'mnemo-db[openai-agents]'          # OpenAI Agents SDK
pip install 'mnemo-db[claude]'                 # Claude Agent SDK
pip install 'mnemo-db[anthropic-memory-tool]'  # memory_20250818
pip install 'mnemo-db[openai-sandbox-s3]'      # S3 workspace backend
pip install 'mnemo-db[openai-sandbox-r2]'      # Cloudflare R2 workspace backend
pip install 'mnemo-db[benchmark]'              # LoCoMo / LongMemEval harness
```

Each extra fails closed if not installed — `from mnemo import MnemoMemoryToolServer` will raise `ImportError` cleanly when `[anthropic-memory-tool]` isn't on the path.

## License + source

Source: <https://github.com/sattyamjjain/mnemo>. Apache-2.0.

Documentation: <https://github.com/sattyamjjain/mnemo#readme>.
Issues: <https://github.com/sattyamjjain/mnemo/issues>.

