Metadata-Version: 2.4
Name: truthlocks-openai
Version: 1.0.1
Summary: Truthlocks MAIP wrapper for OpenAI — auto-generate cryptographic receipts for every API call
Project-URL: Homepage, https://truthlocks.com
Project-URL: Documentation, https://docs.truthlocks.com/sdk/openai
Project-URL: Repository, https://github.com/truthlocks/maip
Author-email: Truthlocks Inc <support@truthlocks.com>
License-Expression: Apache-2.0
Keywords: ai-provenance,machine-identity,maip,openai,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[openai]>=1.0.0
Description-Content-Type: text/markdown

# truthlocks-openai

Cryptographic receipt generation for every OpenAI API call. Part of the [Truthlocks MAIP](https://truthlocks.com) (Machine-Attested Identity Protocol) ecosystem.

## Installation

```bash
pip install truthlocks-openai
```

## Quick Start

```python
from truthlocks_openai import MAIPOpenAIWrapper

# Create the receipt-generating wrapper
wrapper = MAIPOpenAIWrapper()

# Make API calls -- receipts are generated automatically
response, receipt = wrapper.chat_completions_create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello"}],
)

# receipt contains a cryptographic proof of the API call
print(receipt.receipt_id)
```

## API

| Class | Description |
|---|---|
| `MAIPOpenAIWrapper` | Drop-in wrapper for the OpenAI client that auto-generates MAIP receipts for every API call |

## What You Get

- **Tamper-proof audit trail** for every chat completion, embedding, and moderation call
- **Cryptographic receipts** anchored to a transparency log with sub-40 ms latency
- **Zero-config** drop-in wrapper -- swap one line and receipts flow automatically
- **Compliance-ready** evidence packages for SOC 2 Type II, ISO 27001, and EU AI Act

## How It Works

`truthlocks-openai` 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 OpenAI-specific wrapper 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/openai](https://docs.truthlocks.com/sdk/openai)**

## License

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