Metadata-Version: 2.4
Name: engram-ms
Version: 0.0.2
Summary: Engram memory system for AI agents — engram-named distribution backed by memorytrace.
Project-URL: Homepage, https://github.com/aop60003/default
Project-URL: Issues, https://github.com/aop60003/default/issues
License-Expression: MIT
Keywords: agent,ai,engram,fts5,llm,mcp,memory,sqlite
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Requires-Dist: memorytrace>=0.5.0
Provides-Extra: full
Requires-Dist: memorytrace[full]>=0.5.0; extra == 'full'
Provides-Extra: llm
Requires-Dist: memorytrace[llm]>=0.5.0; extra == 'llm'
Provides-Extra: mcp
Requires-Dist: memorytrace[mcp]>=0.5.0; extra == 'mcp'
Provides-Extra: semantic
Requires-Dist: memorytrace[semantic]>=0.5.0; extra == 'semantic'
Description-Content-Type: text/markdown

# engram-ms

[![PyPI](https://img.shields.io/pypi/v/engram-ms.svg)](https://pypi.org/project/engram-ms/)
[![Python](https://img.shields.io/pypi/pyversions/engram-ms.svg)](https://pypi.org/project/engram-ms/)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)

The **engram-named distribution** of the engram memory system for AI agents
— SQLite + FTS5 backend with optional MCP, LLM, and semantic-search
integrations.

`engram-ms` is a thin alias on top of [`memorytrace`](https://pypi.org/project/memorytrace/),
which carries the real engine code. Installing `engram-ms` automatically
pulls in `memorytrace`, so both names give you the same engine.

## Install

```bash
pip install engram-ms
```

Optional extras (forwarded to the corresponding `memorytrace` extras):

```bash
pip install "engram-ms[llm]"        # Anthropic + OpenAI clients
pip install "engram-ms[semantic]"   # numpy + embeddings
pip install "engram-ms[mcp]"        # Model Context Protocol server
pip install "engram-ms[full]"       # everything above
```

Requires Python 3.9+.

## Usage

```python
from engram_ms import MemoryEngine, EngramConfig

with MemoryEngine(EngramConfig()) as engine:
    engine.create_entity("Alice", entity_type="person")
    engine.add_fact("Alice", "role", "engineer")
    print(engine.timeline("Alice"))
```

The full API lives under the canonical `engram` namespace:

```python
from engram.engine import MemoryEngine
from engram.integrations.sdk import EngramSDK
```

## Relationship to `memorytrace`

Same engine, two distribution names:

| Distribution | Role |
|---|---|
| `engram-ms` | Engram-named alias (preferred going forward) |
| `memorytrace` | Original/legacy distribution; still maintained |

Either install gives you the `engram` import path, the `engram` /
`engram-advanced` CLIs, and the same SDK. Pick whichever name you prefer
in `requirements.txt`.

## License

Released under the [MIT License](https://opensource.org/licenses/MIT).
