Metadata-Version: 2.4
Name: signalvault
Version: 0.1.0
Summary: SignalVault Python SDK — AI audit logs and guardrails for OpenAI applications
Author-email: SignalVault <support@signalvault.io>
License-Expression: MIT
Project-URL: Homepage, https://signalvault.io
Project-URL: Documentation, https://signalvault.io/docs
Project-URL: Repository, https://github.com/signalvaultio/signalvault-python
Project-URL: Issues, https://github.com/signalvaultio/signalvault-python/issues
Keywords: ai,audit,guardrails,openai,llm,compliance,security
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: openai>=1.0
Requires-Dist: httpx>=0.24
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"

# signalvault

AI audit logs and guardrails for your OpenAI Python applications.

## Installation

```bash
pip install signalvault openai
```

## Quick Start

```python
import os
from signalvault import SignalVaultClient

client = SignalVaultClient(
    api_key="sk_live_your_signalvault_key",
    openai_api_key=os.environ["OPENAI_API_KEY"],
    base_url="https://api.signalvault.io",
    environment="production",
)

# Use exactly like OpenAI SDK
response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)
```

## Mirror Mode

Monitor without blocking — requests go directly to OpenAI and are audited asynchronously:

```python
client = SignalVaultClient(
    api_key="sk_live_...",
    openai_api_key=os.environ["OPENAI_API_KEY"],
    mirror_mode=True,
)
```

## Features

- **Automatic Logging** — Every request and response is recorded
- **Pre-flight Guardrails** — Block or redact requests before OpenAI
- **PII Detection** — Detect emails, phone numbers, SSNs
- **Secret Detection** — Block API keys and tokens
- **Token Limits** — Enforce cost controls
- **Model Allowlists** — Restrict which models can be used
- **Mirror Mode** — Observe without blocking

## License

MIT
