Metadata-Version: 2.4
Name: mnemix-ai
Version: 0.1.0
Summary: Official Python client for Mnemix — real-time memory and enrichment API for AI agents. One call before every interaction: your agent knows who they're talking to.
Project-URL: Homepage, https://mnemix.ai
Project-URL: Documentation, https://mnemix.ai/docs
Author-email: Mnemix <hello@mnemix.ai>
License-Expression: MIT
Keywords: ai-agents,bland,caller-id,enrichment,memory,retell,vapi,voice-ai
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: httpx>=0.24
Description-Content-Type: text/markdown

# mnemix-ai

Official Python client for [Mnemix](https://mnemix.ai) — real-time memory and enrichment API for AI agents. One call before every interaction: your agent knows who they're talking to.

Designed for voice workflows (Retell, Vapi, Bland, LiveKit) where phone-native caller identity matters, with background enrichment filling in contact data asynchronously.

## Install

```bash
pip install mnemix-ai
```

## Quickstart

```python
from mnemix_ai import MnemixClient

client = MnemixClient(api_key="mx_...")  # or set MNEMIX_API_KEY

# At the start of every call / interaction:
memory = client.recall_and_enrich(phone_number="+15551234567")

# Look up a caller directly:
profile = client.get_caller("+15551234567")

# After hangup, persist the interaction:
client.end_call(call_id="...", transcript="...")
```

## API surface

| Method | Endpoint |
|---|---|
| `recall_and_enrich(phone_number, **kwargs)` | `POST /v1/recall_and_enrich` |
| `end_call(**kwargs)` | `POST /v1/calls/end` |
| `get_caller(phone_number)` | `GET /v1/caller/{phone_number}` |

Get an API key at [mnemix.ai](https://mnemix.ai). Hobby tier is free.

## Note on naming

This is the official package for the Mnemix platform (mnemix.ai). It is unrelated to the `mnemix` package on PyPI, which is a different project by a different author.

## License

MIT
