Metadata-Version: 2.4
Name: clawdb
Version: 0.1.3
Summary: Zero-config database for AI agents.
License: MIT
Keywords: agents,ai,clawdb,database,grpc,langchain,memory,openai
Classifier: Development Status :: 3 - Alpha
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 :: Database
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: grpcio-tools>=1.60.0
Requires-Dist: grpcio>=1.60.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: protobuf>=4.25.0
Requires-Dist: pydantic-settings>=2.3
Requires-Dist: pydantic>=2.7
Requires-Dist: structlog>=24.2
Requires-Dist: tenacity>=8.2.0
Provides-Extra: async
Requires-Dist: grpcio>=1.64; extra == 'async'
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.2; extra == 'langchain'
Provides-Extra: openai
Requires-Dist: openai>=1.30; extra == 'openai'
Description-Content-Type: text/markdown

# clawdb

Official Python client for ClawDB with sync and async APIs.

## Install

```bash
pip install clawdb
```

Optional async extras:

```bash
pip install "clawdb[async]"
```

## Quick Start

```python
from clawdb import ClawDB

db = ClawDB(endpoint="http://localhost:50050", agent_id="py-agent")

memory_id = db.remember_typed("Customer prefers weekly updates", type="context", tags=["customer"])
hits = db.search("weekly updates", top_k=5, semantic=True)
branch = db.branch("customer-experiment")

print(memory_id, len(hits), branch.id)
```

## Client Variants

- `ClawDB` for synchronous code
- `AsyncClawDB` for asyncio applications
- `clawdb()` helper for environment-aware client creation

## API Surface

The Python SDK covers:
- health and readiness
- session lifecycle
- memory CRUD, search, recall, and listing
- branch fork, inspect, diff, merge, discard, and archive
- sync run, push, pull, reconcile, and status
- reflection run, jobs, facts, preferences, contradictions, and resolution
- transaction begin, remember, typed remember, commit, and rollback
