Metadata-Version: 2.4
Name: aletheiadb
Version: 0.1.1
Summary: Python SDK for AletheiaDB: The cognitive memory engine for AI agents with fact supersession, knowledge graphs, and temporal truth retrieval.
Author-email: AletheiaDB Systems <support@aletheiadb.com>
License: MIT
Project-URL: Homepage, https://aletheiadb.com
Project-URL: Documentation, https://aletheiadb.com/docs
Project-URL: Blog, https://aletheiadb.com/blog
Project-URL: Benchmarks, https://aletheiadb.com/platform/benchmarks
Project-URL: Signup, https://aletheiadb.com/signup
Project-URL: Source Code, https://github.com/SharjeelAbbas014/Aletheia
Keywords: memory,retrieval,sdk,temporal-memory,aletheiadb,ai-agents,knowledge-graph,vector-search
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Database
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Aletheia Python SDK

This package wraps the local Temporal Memory engine binary and the remote HTTP API with the same interface.

## Local-first flow

```python
from aletheia import AletheiaClient

client = AletheiaClient.from_local(auto_start=True)
client.ingest(entity_id="user-123", text="I prefer pourover coffee.")
hits = client.query("What coffee do I prefer?", entity_id="user-123")
```

## Cloud flow

```python
from aletheia import AletheiaClient

client = AletheiaClient.from_cloud(
    "http://143.110.246.15:3000",
    api_key="XXX1111AAA",
)
```

## Binary resolution

`from_local()` and `ensure_engine()` resolve the engine in this order:

1. Explicit `binary_path`
2. `ALETHEIA_ENGINE_BINARY` or `TEMPORAL_MEMORY_ENGINE_BINARY`
3. Repo-local `target/release/temporal_memory` or `target/debug/temporal_memory`
4. Cached binary in `ALETHEIA_ENGINE_CACHE_DIR`
5. Manifest download from `ALETHEIA_ENGINE_MANIFEST_URL`

## Sidecar environment

The SDK starts the Rust engine with:

- `TEMPORAL_MEMORY_HOST`
- `TEMPORAL_MEMORY_PORT`
- `TEMPORAL_MEMORY_DATA_DIR`
- `TEMPORAL_MEMORY_API_KEY` when a local key is configured
