Metadata-Version: 2.5
Name: occludra
Version: 0.1.0
Summary: Occludra — AI Security Gateway Python SDK: PII redaction, prompt-injection defense, recursive-loop protection, and smart routing for any LLM.
Project-URL: Homepage, https://occludra.ai
Project-URL: Documentation, https://occludra.ai/docs
Project-URL: Repository, https://github.com/occludra/gateway
Project-URL: Issues, https://github.com/occludra/gateway/issues
Author-email: Datum Fuse LLC <contact@occludra.ai>
License-Expression: Apache-2.0
Keywords: ai,dlp,gateway,governance,llm,mcp,openai,pii,proxy,redaction,security
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software 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 :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: aisg<1.0.0,>=0.1.1
Description-Content-Type: text/markdown

# Occludra — AI Security Gateway (Python SDK)

**Occludra** is a drop-in security proxy for LLM API calls: **PII/DLP redaction**,
**prompt-injection defense**, **recursive-loop protection**, **hard budget caps**, and
**smart routing** across 600+ models — plus enterprise controls (SSO, RBAC, SIEM,
Hybrid VPC, and the MCP Gateway for the agent tool plane).

```bash
pip install occludra
```

```python
from occludra import Occludra

client = Occludra(api_key="oah_...")

res = client.chat.create(
    model="oah/llama-4-maverick",
    messages=[{"role": "user", "content": "My email is test@example.com"}],
)
print(res.content)
print(res.aisg_metadata.pii_detected)           # True
print(res.aisg_metadata.entity_types_detected)  # ["EMAIL_ADDRESS"]
```

Prefer the OpenAI SDK? Point its base URL at the gateway — no new dependency:

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.aisecuritygateway.ai/v1",
    api_key="oah_...",
)
```

## Stable identifiers (unchanged by design)

Occludra is the officially branded distribution of the SDK — it re-exports the
stable `aisg` client, so this package is fully functional today. A few identifiers
stay unchanged because they are permanent wire/product contracts that existing
integrations depend on:

- Proxy base URL: `https://api.aisecuritygateway.ai/v1`
- Response field: `response.aisg_metadata`
- Environment variables: `AISG_API_KEY`, `AISG_BASE_URL`

Both client names work: `Occludra` is the branded name; `AISG` is kept for
backward compatibility.

## Links

- Docs: https://occludra.ai/docs
- Homepage: https://occludra.ai
- Source: https://github.com/occludra/gateway
