Metadata-Version: 2.4
Name: cerememory
Version: 0.2.1
Summary: Python HTTP client SDK for the Cerememory Protocol (CMP)
Project-URL: Homepage, https://github.com/co-r-e/cerememory
Project-URL: Documentation, https://github.com/co-r-e/cerememory/tree/main/bindings/python
Project-URL: Repository, https://github.com/co-r-e/cerememory
Author-email: "CORe Inc." <dev@core-inc.jp>
License: MIT
Keywords: ai,cerememory,cognitive,memory
Classifier: Development Status :: 4 - Beta
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: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: eval-type-backport>=0.2.0; python_version < '3.10'
Requires-Dist: httpx>=0.25
Requires-Dist: pydantic>=2.0
Provides-Extra: dev
Requires-Dist: mypy>=1.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# Cerememory Python SDK

Python bindings for Cerememory.

## Features

- Synchronous `Client` and asynchronous `AsyncClient`
- High-level `store()`, `recall()`, `forget()`, and `stats()` helpers
- Full CMP protocol access via the underlying transport clients
- `store()` supports `metadata`
- `recall()` supports `reconsolidate` and `activation_depth`
- Retries are opt-in; the default is `max_retries=0`
- Native package support via `cerememory_native`

## Example

```python
from cerememory import Client

client = Client("http://localhost:8420")

record_id = client.store(
    "Coffee chat with Alice",
    store="episodic",
    metadata={"source": "chat"},
)

memories = client.recall("coffee", reconsolidate=False, activation_depth=4)
```
