Metadata-Version: 2.4
Name: mayamemo
Version: 0.1.1
Summary: MayaMemo Python SDK — evidence-backed context, memories and cross-agent checkpoints for AI coding agents. Zero dependencies.
Author: MayaMemo
License: MIT
Project-URL: Homepage, https://mayamemo.com
Project-URL: Documentation, https://mayamemo.com/docs
Project-URL: Repository, https://github.com/Coin1511/mayamemo
Keywords: mayamemo,ai-agents,memory,context,checkpoints,mcp
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.2; extra == "langchain"
Dynamic: license-file

# MayaMemo — Python SDK

Zero-dependency Python client for the [MayaMemo](https://mayamemo.com) API:
projects, memories (with tags), semantic search, the context compiler,
checkpoints and cross-agent resume.

```bash
pip install mayamemo            # or: pip install "mayamemo[langchain]"
```

## Quickstart

```python
from mayamemo import MayaMemo

client = MayaMemo(api_key="mm_sk_...", api_url="https://api.mayamemo.com")

project = client.create_project("my-app")

client.add_memory(
    project["id"],
    "Checkout retries go through an idempotency table keyed by cart_id + attempt",
    type="decision",
    tags=["checkout", "billing"],
)

hits = client.search_memories(project["id"], "how do we avoid double charges?")
print(hits[0]["statement"], hits[0]["score"])

checkpoint = client.create_checkpoint(
    project["id"], "billing groundwork",
    "Idempotency decision captured; outbox worker noted.",
    next_steps=["wire refund metrics"], agent="my-agent",
)

briefing = client.resume_checkpoint(checkpoint["id"], agent="another-agent")["briefing_markdown"]
print(briefing)
```

Environment defaults: `MAYAMEMO_API_KEY` (or `MAYAMEMO_TOKEN`) and `MAYAMEMO_API_URL`.

Get an API key in the MayaMemo dashboard → **Developers**. Docs: https://mayamemo.com/docs

## Development

```bash
pip install -e "sdk/python[langchain]"    # from a checkout
python -m pytest sdk/python/tests
```
