arqera 0.3.0

Python SDK for ARQERA -- AI governance as an API

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:

Field	Type	Description
verdict	str	"proceed", "review", or "deny"
action	str	The action that was evaluated
confidence	float	Confidence score (0.0 -- 1.0)
reasons	list[str]	Reasons supporting the decision
laws_evaluated	list[str]	Which governance laws were checked
approved	bool	Shorthand for verdict == "proceed"

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

Exception	HTTP Status	When
AuthenticationError	401	Invalid or missing API key
AuthorizationError	403	Key lacks required permissions
NotFoundError	404	Resource does not exist
ValidationError	422	Invalid request payload
RateLimitError	429	Rate limit exceeded
ServerError	5xx	ARQERA server error
NetworkError	--	DNS, timeout, connection refused
ArqeraError	any	Base class for all SDK errors

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.