Metadata-Version: 2.4
Name: madb-anthropic
Version: 0.1.0
Summary: Drop-in Anthropic client with MADB causal memory. One import, every turn persisted.
Author-email: Pushkar Singh <01@meta-agents.ai>
License: Meta-Agents.AI Proprietary License v1.0
Project-URL: Homepage, https://meta-agents.ai
Project-URL: Documentation, https://github.com/spshkar84/meta-agents-db
Project-URL: Repository, https://github.com/spshkar84/meta-agents-db
Keywords: anthropic,claude,memory,agent,madb,autonomous,causal
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
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 :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: anthropic>=0.40
Requires-Dist: meta-agents-db>=0.2

# madb-anthropic

> Drop-in Anthropic client with automatic MADB causal memory. **One import, every turn persisted.**

```python
# Before
# from anthropic import Anthropic

# After
from madb_anthropic import Anthropic

client = Anthropic(tenant_id="my-agent")
# Every client.messages.create() call now:
#   1. Recalls relevant prior memories (composite-scored),
#   2. Prepends them to the system prompt,
#   3. Calls Anthropic as usual,
#   4. Persists the turn with caused_by set to the strongest recalled memory.
```

No other code changes. See the monorepo's `examples/basic_usage.py` for a runnable demo.

## Install

```bash
pip install madb-anthropic
```

Depends on:
- `anthropic>=0.40`
- `meta-agents-db>=0.2` (the MADB engine wheel)

Both are pulled in automatically by pip.

## Environment variables

| Variable | Default | Purpose |
|---|---|---|
| `MADB_TENANT_ID` | `"default"` | Tenant isolation key. Use one tenant per long-running agent identity, not per session. |
| `MADB_DATA_DIR` | `~/.madb/data` | Local engine storage directory. |
| `MADB_API_ENDPOINT` | *(unset)* | *Reserved.* When the hosted MADB API launches, set to route writes/reads to the managed tier. Currently emits a one-shot warning and falls back to local mode. |
| `MADB_API_KEY` | *(unset)* | *Reserved.* Paired with `MADB_API_ENDPOINT` above. |

## License

[Meta-Agents.AI Proprietary License v1.0](https://github.com/spshkar84/meta-agents-db/blob/main/LICENSE).

- You may install and run this client in your own infrastructure for your own users.
- You may not redistribute, reverse-engineer, or offer it as a hosted service to third parties.
- Source code is not public. The wheel ships compiled binaries only.
- For source access, OEM / embed rights, or hosted-service rights: 01@meta-agents.ai.
