Metadata-Version: 2.4
Name: hmc-memory
Version: 0.2.0
Summary: Cortex Memory — Persistent AI memory as a service
License: MIT
Project-URL: Homepage, https://github.com/your-org/cortex-memory
Project-URL: Documentation, https://github.com/your-org/cortex-memory/tree/main/docs
Project-URL: Repository, https://github.com/your-org/cortex-memory
Keywords: ai,memory,llm,context,embeddings
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.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"

# Cortex Memory — Python SDK

Persistent memory for AI agents. Store, recall, and manage context across sessions.

## Install

```bash
pip install cortexmemory
```

## Quick Start

```python
from cortexmemory import HybridMemory

mem = HybridMemory(api_key="hm_sk_...", base_url="https://cortex-memory.com")

# Store
mem.store("User prefers dark mode", tags=["preferences"], priority="hot")

# Recall
for r in mem.recall("user preferences"):
    print(f"[{r.score:.0%}] {r.content}")

# Compact session
mem.compact("Session transcript...", task_context="Refactoring auth")

mem.close()
```

## Async

```python
from cortexmemory import AsyncHybridMemory

async with AsyncHybridMemory(api_key="hm_sk_...", base_url="https://cortex-memory.com") as mem:
    await mem.store("Important context", tags=["project"])
    results = await mem.recall("project context")
```

## Get an API Key

```bash
curl -X POST https://cortex-memory.com/v1/admin/provision \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent", "tos_accepted": true}'
```

## Links

- Website: https://cortex-memory.com
- MCP Server: Works with Cursor, VS Code, Claude Desktop, Windsurf
