Metadata-Version: 2.4
Name: truthlocks-llamaindex
Version: 1.0.1
Summary: Truthlocks MAIP integration for LlamaIndex — auto-generate cryptographic receipts for every query and retrieval
Project-URL: Homepage, https://truthlocks.com
Project-URL: Documentation, https://docs.truthlocks.com/sdk/llamaindex
Project-URL: Repository, https://github.com/truthlocks/maip
Author-email: Truthlocks Inc <support@truthlocks.com>
License-Expression: Apache-2.0
Keywords: ai-provenance,llamaindex,machine-identity,maip,receipts,truthlocks
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Security :: Cryptography
Requires-Python: >=3.9
Requires-Dist: maip-ai-connectors[llamaindex]>=1.0.0
Description-Content-Type: text/markdown

# truthlocks-llamaindex

Cryptographic receipt generation for every LlamaIndex query, retrieval, and synthesis step. Part of the [Truthlocks MAIP](https://truthlocks.com) (Machine-Attested Identity Protocol) ecosystem.

## Installation

```bash
pip install truthlocks-llamaindex
```

## Quick Start

```python
from truthlocks_llamaindex import MAIPLlamaIndexHandler

# Create the receipt handler
handler = MAIPLlamaIndexHandler()

# Attach to your query engine or index
# Every query and retrieval now produces a cryptographic receipt
```

## API

| Class | Description |
|---|---|
| `MAIPLlamaIndexHandler` | Event handler that auto-generates MAIP receipts for every LlamaIndex event |
| `MAIPQueryEngineWrapper` | Wraps any LlamaIndex `QueryEngine` to emit receipts on `.query()` |

## What You Get

- **Tamper-proof audit trail** for every query, retrieval, and response synthesis
- **Cryptographic receipts** anchored to a transparency log with sub-40 ms latency
- **Zero-config** drop-in integration -- add the handler and receipts flow automatically
- **Compliance-ready** evidence packages for SOC 2 Type II, ISO 27001, and EU AI Act

## How It Works

`truthlocks-llamaindex` is a thin wrapper around [`maip-ai-connectors`](https://pypi.org/project/maip-ai-connectors/), the core Truthlocks MAIP SDK for Python. It re-exports the LlamaIndex-specific classes so you can install only what you need.

## Requirements

- Python >= 3.9
- A Truthlocks API key ([get one free](https://truthlocks.com/get-started))

## Documentation

Full guides, API reference, and examples: **[docs.truthlocks.com/sdk/llamaindex](https://docs.truthlocks.com/sdk/llamaindex)**

## License

Apache 2.0 -- see [LICENSE](https://github.com/truthlocks/maip/blob/main/LICENSE).
