Metadata-Version: 2.4
Name: koru-delta
Version: 2.0.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Rust
Classifier: Topic :: Database
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Dist: typing-extensions>=4.0 ; python_full_version < '3.10'
Requires-Dist: numpy>=1.20
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: pytest-asyncio ; extra == 'dev'
Requires-Dist: mypy ; extra == 'dev'
Requires-Dist: black ; extra == 'dev'
Requires-Dist: ruff ; extra == 'dev'
Requires-Dist: nest-asyncio>=1.5.0 ; extra == 'dev'
Requires-Dist: langchain>=0.1.0 ; extra == 'frameworks'
Requires-Dist: langchain-core>=0.1.0 ; extra == 'frameworks'
Requires-Dist: llama-index>=0.10.0 ; extra == 'frameworks'
Requires-Dist: llama-index-core>=0.10.0 ; extra == 'frameworks'
Requires-Dist: langchain>=0.1.0 ; extra == 'langchain'
Requires-Dist: langchain-core>=0.1.0 ; extra == 'langchain'
Requires-Dist: llama-index>=0.10.0 ; extra == 'llamaindex'
Requires-Dist: llama-index-core>=0.10.0 ; extra == 'llamaindex'
Requires-Dist: openai>=1.0 ; extra == 'openai'
Requires-Dist: openai>=1.0 ; extra == 'rag'
Requires-Dist: tiktoken>=0.5 ; extra == 'rag'
Provides-Extra: dev
Provides-Extra: frameworks
Provides-Extra: langchain
Provides-Extra: llamaindex
Provides-Extra: openai
Provides-Extra: rag
Summary: The database for AI agents - zero-config, causal, edge-ready
License: MIT OR Apache-2.0
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Documentation, https://docs.korudelta.dev
Project-URL: Homepage, https://github.com/swyrknt/koru-delta
Project-URL: Issues, https://github.com/swyrknt/koru-delta/issues
Project-URL: Repository, https://github.com/swyrknt/koru-delta

# KoruDelta Python Bindings

Python bindings for KoruDelta - The Causal Database.

## Installation

```bash
pip install koru-delta
```

Or install from source:

```bash
git clone https://github.com/swyrknt/koru-delta.git
cd koru-delta/bindings/python
pip install maturin
maturin develop
```

## Quick Start

```python
import asyncio
from koru_delta import Database

async def main():
    async with Database() as db:
        # Store data
        await db.put("users", "alice", {"name": "Alice"})
        
        # Retrieve
        user = await db.get("users", "alice")
        print(user["name"])  # "Alice"

asyncio.run(main())
```

## Run the Examples

```bash
# Quick start - basic operations
python examples/01_quickstart.py

# AI Agent - semantic memory with vectors
python examples/02_ai_agent.py

# Audit Trail - fraud detection with time-travel
python examples/03_audit_trail.py

# Config Management - incident post-mortem
python examples/04_config_management.py
```

## Features

- **Causal Storage**: Every change is versioned and auditable
- **Time-Travel**: Query any historical state with `get_at()`
- **Vector Search**: Built-in semantic search with embeddings
- **Natural Lifecycle**: Hot→Warm→Cold→Deep memory tiers
- **Edge-Ready**: 8MB binary, runs anywhere

## Documentation

See the [main repository](https://github.com/swyrknt/koru-delta) for full documentation.

