crp-comply-sdk

Python SDK for CRP-Comply — EU AI Act & GDPR compliance automation. A thin, typed HTTP client covering every user-facing endpoint of the CRP-Comply REST API, including the local LLM worker relay for private, on-premise inference.

Install

pip install crp-comply-sdk

# If you are running the local LLM worker relay, install the worker extra:
pip install 'crp-comply-sdk[worker]'

Quick Start

from crp_comply_sdk import CRPComply

with CRPComply(api_key="crp_...") as client:
    # Account
    me = client.me()
    usage = client.usage()

    # EU AI Act Article 6 risk classification
    risk = client.risk_assessment(
        system_name="Hiring Assistant",
        category="employment",
        affects_fundamental_rights=True,
    )

    # GDPR Article 35 DPIA
    dpia = client.dpia(
        system_name="Hiring Assistant",
        data_subjects=["candidates", "employees"],
        makes_automated_decisions=True,
    )

    # Full conformity evidence pack (zip with manifest + HMAC)
    pack = client.evidence_pack(system_name="Hiring Assistant", category="employment")
    zip_bytes = client.download_evidence_pack(pack["pack_id"])
    with open("evidence.zip", "wb") as f:
        f.write(zip_bytes)

API Surface

All methods are keyword-only. Every call is tier-gated server-side — a CRPComplyTierError is raised with an upgrade_url when a feature isn't available on your plan.

Compliance generation

Evidence packs

Persisted reports

SDK gateway (realtime checks)

Account

Configuration

import os
os.environ["CRP_COMPLY_API_KEY"] = "crp_..."
os.environ["CRP_COMPLY_BASE_URL"] = "https://comply.crprotocol.io/api/v1"

from crp_comply_sdk import CRPComply
client = CRPComply()  # picks up env vars

LLM Backends

CRP-Comply is LLM-agnostic. Configure your preferred backend server-side at Settings → LLM Provider. Supported:

Exception Hierarchy

CRPComplyError              # base — all SDK errors
├── CRPComplyAuthError      # 401, 403 — invalid / missing API key
├── CRPComplyQuotaError     # 429 — monthly quota exhausted (has .upgrade_url)
├── CRPComplyTierError      # 402 — feature not in tier (has .upgrade_url,
│                           #       .feature, .current_tier, .required_tier)
└── CRPComplyServerError    # 5xx — server-side failure

from crp_comply_sdk import CRPComply, CRPComplyTierError, CRPComplyQuotaError

try:
    pack = client.evidence_pack(system_name="X", category="y")
except CRPComplyTierError as exc:
    print(f"Upgrade required: {exc.upgrade_url}")
except CRPComplyQuotaError as exc:
    print(f"Quota exhausted. Upgrade at {exc.upgrade_url}")

License

Apache-2.0 — see LICENSE.