Metadata-Version: 2.4
Name: ctxvault-sdk
Version: 0.1.1
Summary: Python SDK for CtxVault — Persistent Memory for AI
License: MIT
Project-URL: Homepage, https://ctxvault.dev
Project-URL: Repository, https://github.com/ajibadedapo/ctxvault
Keywords: ai,llm,memory,context,vector-search
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0

# ctxvault

Python SDK for [CtxVault](https://ctxvault.dev) — Persistent Memory for AI.

## Install

```bash
pip install ctxvault
```

## Usage

```python
from ctxvault import CtxVault

vault = CtxVault(
    api_key="cv_your_key",
    project="your-project",
    base_url="https://ctxvault.dev",
)

# Store a memory
vault.remember(
    type="decision",
    title="Use PostgreSQL for persistence",
    content="Chose PostgreSQL with pgvector for vector search support.",
    tags=["database", "architecture"],
)

# Search memories
results = vault.recall("database decisions")

# Get context pack
pack = vault.context_pack("project architecture")
print(pack["pack"])

# List all memories
items = vault.list(status="verified")
```

## API

### `CtxVault(api_key, project, base_url=None)`

### `vault.remember(type, title, content, importance=5, tags=None)` — Store a memory
### `vault.recall(query, k=5)` — Search memories
### `vault.context_pack(query, max_tokens=2000)` — Generate context pack
### `vault.list(status=None, type=None)` — List memory items
### `vault.verify(id)` — Verify a candidate
### `vault.pin(id)` — Pin a verified item
### `vault.deprecate(id, reason)` — Deprecate an item

## License

MIT
