aegis-governance 0.3.0

Python client for the AEGIS Governance API — quantitative decision governance for engineering teams

AEGIS Python SDK

Quantitative decision governance for engineering teams.

AEGIS evaluates engineering proposals through 6 mathematical gates — risk, profit, novelty, complexity, quality, and utility — using Bayesian posterior analysis and KL divergence drift detection. This SDK is the Python client for the AEGIS Governance API.

Installation

pip install aegis-governance

Quick Start

from aegis import Aegis

client = Aegis(api_key="uk_live_xxx")  # or set AEGIS_API_KEY env var

decision = client.evaluate(
    proposal_summary="Add Redis caching layer to reduce API latency",
    estimated_impact="medium",
    risk_baseline=0.02,
    risk_proposed=0.05,
    novelty_score=0.75,
    complexity_score=0.8,
    quality_score=0.9,
)

print(decision.status)       # "proceed" | "pause" | "halt" | "escalate"
print(decision.confidence)   # 0.87
print(decision.rationale)    # "All 6 gates passed. Proposal approved."

Features

Feature	Description
6 Bayesian gates	Risk, profit, novelty, complexity, quality, utility
KL divergence drift	Detects when your risk baseline shifts
Shadow mode	Evaluate without enforcing (calibration)
Typed responses	Full dataclass types with IDE autocomplete
Async support	AsyncAegis with identical API surface
Retry + backoff	Automatic retry on transient failures (429, 5xx)
Idempotency	Safe retries with auto-generated idempotency keys
TLS enforced	HTTPS always on, no opt-out

Quick Risk Check

result = client.risk_check(
    risk_score=0.15,
    threshold=0.3,
    action_description="Deploy to production",
)
print(result.safe)  # True

Async Usage

from aegis import AsyncAegis

async with AsyncAegis() as client:
    decision = await client.evaluate(
        proposal_summary="Migrate database to Postgres 17",
        estimated_impact="high",
    )

Gate Results

Access individual gate evaluations:

decision = client.evaluate(proposal_summary="...")

if decision.gates:
    print(decision.gates.risk)        # GateResult(passed=True, value=0.05, ...)
    print(decision.gates.novelty)     # GateResult(passed=True, value=0.75, ...)
    print(decision.gates.complexity)  # GateResult(passed=True, value=0.80, ...)

Error Handling

import aegis

try:
    decision = client.evaluate(proposal_summary="...")
except aegis.AuthenticationError:
    print("Invalid API key")
except aegis.RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after}s")
except aegis.ValidationError as e:
    print(f"Bad request: {e.message}")
except aegis.AegisError as e:
    print(f"API error: {e.message} (request_id={e.request_id})")

Configuration

client = Aegis(
    api_key="uk_live_xxx",       # or AEGIS_API_KEY env var
    base_url="https://...",      # or AEGIS_BASE_URL env var
    timeout=60.0,                # seconds (default: 30)
    max_retries=3,               # retry attempts (default: 2)
)

Customer Management

profile = client.get_profile()
print(profile.tier)              # "professional"

usage = client.get_usage()
print(usage.total_evaluations)   # 847

keys = client.list_keys()
new_key = client.create_key("CI Pipeline")

Get Your API Key

1. Sign up at portal.veiltide.com
2. Create an API key in the dashboard
3. Set AEGIS_API_KEY in your environment

Pricing

Tier	Monthly	Evaluations	Rate Limit
Community	Free	100/month	10/min
Professional	$3,500	10,000/month	100/min
Enterprise	$18,000	100,000/month	1,000/min

Full pricing details

Links

• Documentation
• Portal
• API Reference
• Getting Started

License

Apache 2.0 - see LICENSE for details.