arqera

Govern any AI action with one API call.

The official Python SDK for ARQERA -- AI governance as an API. Evaluate actions against governance policies, query trust scores, and maintain a tamper-evident audit trail, all from Python.

Installation

pip install arqera

Requirements: Python 3.9+. Zero required dependencies (uses only the standard library).

Quick start

from arqera import Arqera

client = Arqera(api_key="ak_live_...")

# Evaluate an action against governance policies
result = client.governance.evaluate(
    action="email.send",
    description="Send welcome email to new user",
)

print(result.verdict)     # "proceed", "review", or "deny"
print(result.confidence)  # 0.95
print(result.approved)    # True

Governance evaluation

Every AI action -- sending an email, deleting data, deploying a model -- can be evaluated against ARQERA's governance laws before execution:

from arqera import Arqera, ArqeraError

client = Arqera(api_key="ak_live_...")

# Simple evaluation
result = client.governance.evaluate(action="data.export")

# With full context
result = client.governance.evaluate(
    action="model.deploy",
    description="Deploy sentiment model to production",
    context={
        "model_id": "sentiment-v3",
        "environment": "production",
        "user_role": "ml-engineer",
    },
)

if result.approved:
    deploy_model()
else:
    print(f"Blocked: {result.reasons}")

Verdict object

The evaluate() method returns a Verdict with these fields:

Trust scores

Query the trust score for your account:

trust = client.governance.trust_score()
print(f"Overall: {trust.overall}")
print(f"Components: {trust.components}")

Evidence trail

Search and export the tamper-evident audit trail:

# Search recent evidence
artifacts = client.governance.search_evidence(
    artifact_type="governance_evaluation",
    start_date="2026-01-01",
    page_size=20,
)
for artifact in artifacts:
    print(f"{artifact.artifact_type}: {artifact.created_at}")

# Verify chain integrity
result = client.governance.verify_evidence(artifact_id=42)

# Export for compliance audit
export = client.governance.export_evidence(
    export_format="json",
    artifact_types=["governance_evaluation"],
)

Error handling

from arqera import Arqera, ArqeraError, RateLimitError, AuthenticationError

client = Arqera(api_key="ak_live_...")

try:
    result = client.governance.evaluate(action="email.send")
except AuthenticationError:
    print("Invalid API key")
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after}s")
except ArqeraError as e:
    print(f"API error ({e.status_code}): {e.message}")

Exception hierarchy

Configuration

client = Arqera(
    api_key="ak_live_...",                         # or set ARQERA_API_KEY env var
    base_url="https://api.arqera.com/api/v1",      # default
    timeout=30,                                     # seconds
    max_retries=2,                                  # retries on 429/5xx
)

The api_key parameter can be omitted if the ARQERA_API_KEY environment variable is set:

export ARQERA_API_KEY="ak_live_..."

client = Arqera()  # picks up ARQERA_API_KEY from env

Links

• Documentation
• API Reference
• Dashboard
• Changelog

License

Apache 2.0. See LICENSE for details.