Metadata-Version: 2.4
Name: agentmesh_memory
Version: 3.6.0
Summary: Public Preview — Episodic Memory Kernel for AI agent experience storage
Author-email: Microsoft Corporation <agentgovtoolkit@microsoft.com>
License: MIT
Project-URL: Homepage, https://github.com/microsoft/agent-governance-toolkit
Project-URL: Repository, https://github.com/microsoft/agent-governance-toolkit
Project-URL: Documentation, https://github.com/microsoft/agent-governance-toolkit#readme
Project-URL: Issues, https://github.com/microsoft/agent-governance-toolkit/issues
Project-URL: Changelog, https://github.com/microsoft/agent-governance-toolkit/releases
Keywords: ai,agents,memory,episodic-memory,llm,autonomous-agents,vector-store,append-only,immutable
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
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: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic<3.0,>=2.4.0
Requires-Dist: numpy<2.0,>=1.20.0
Provides-Extra: chromadb
Requires-Dist: chromadb<1.0,>=0.4.0; extra == "chromadb"
Provides-Extra: huggingface
Requires-Dist: huggingface_hub<1.0,>=0.19.0; extra == "huggingface"
Provides-Extra: all
Requires-Dist: chromadb<1.0,>=0.4.0; extra == "all"
Requires-Dist: huggingface_hub<1.0,>=0.19.0; extra == "all"
Provides-Extra: dev
Requires-Dist: pytest<8.0,>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov<5.0,>=4.0.0; extra == "dev"
Requires-Dist: black<27.0,>=26.3.1; extra == "dev"
Requires-Dist: ruff<1.0,>=0.1.0; extra == "dev"
Requires-Dist: mypy<2.0,>=1.0.0; extra == "dev"
Requires-Dist: pre-commit<4.0,>=3.0.0; extra == "dev"
Dynamic: license-file

# emk - Episodic Memory Kernel — Public Preview

> **Part of [Agent OS](https://github.com/microsoft/agent-governance-toolkit)** - Kernel-level governance for AI agents

[![PyPI](https://img.shields.io/pypi/v/emk)](https://pypi.org/project/emk/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Episodic memory storage for AI agents.**

emk provides a simple append-only store for recording agent experiences. Episodes are immutable once written, giving you a reliable audit trail of what your agent did and learned.

## Installation

```bash
pip install agent-os-kernel[full]  # emk is included as a submodule
```

## Quick Start

```python
from emk import Episode, FileAdapter

store = FileAdapter("agent_memory.jsonl")
episode = Episode(goal="Query user data", action="SELECT * FROM users",
                  result="200 rows", reflection="Query was fast")
store.store(episode)
```

## Features

- Immutable, append-only episode storage
- JSONL file-based persistence
- Episode retrieval and querying
- Pluggable storage adapters

## License

MIT License - see [LICENSE](LICENSE) for details.
