Skip to main content

Python SDK for the Aethelgard AI Compliance & Fairness Verification Engine — formal proofs, not statistical guesses.

Project description

Aethelgard Python SDK

Enterprise AI Compliance & Fairness Verification — Formal Proofs, Not Statistical Guesses.

PyPI version Python 3.9+ License: Apache 2.0

Aethelgard is the only AI governance engine that uses Z3 SMT formal verification to mathematically prove fairness compliance — not merely estimate it statistically. This SDK provides a Python client for the Aethelgard Engine API.

Why Aethelgard?

Capability Fairlearn / AIF360 Aethelgard
Evidence Type Statistical p-values Z3 formal proofs (deterministic)
Intersectional Analysis Manual specification Exhaustive automatic discovery
Regulations None built-in 6 frameworks (LL144, EU AI Act, SR 11-7, Colorado, FDA, Texas TRAIGA)
Confidence Intervals Wilson CI only Wilson CI + Z3 uncertainty-aware verification
Remediation None Automated minimum-cost remediation plans
Monitoring None Real-time drift detection with breach forecasting
Legal Protection None Attorney-client privilege safe harbor
Throughput ~100 rec/s (Python) 1.23 billion rec/s (Rust engine)

Installation

pip install aethelgard-ai

For benchmarking utilities:

pip install aethelgard-ai[benchmarks]

Quick Start

from aethelgard import AethelgardClient

client = AethelgardClient(
    base_url="http://localhost:8080",
    api_key="your-api-key",
)

# Run a bias audit (NYC LL144 / EEOC Four-Fifths Rule)
result = client.audit_ll144(
    model_name="hiring-model-v2",
    groups=[
        {"category": {"category_type": "Race", "value": "White"}, "total_candidates": 1000, "selected_candidates": 600},
        {"category": {"category_type": "Race", "value": "Black"}, "total_candidates": 800, "selected_candidates": 440},
        {"category": {"category_type": "Race", "value": "Hispanic"}, "total_candidates": 600, "selected_candidates": 300},
    ],
)

for group in result["group_results"]:
    print(f"{group['group']:20s}  IR={group['impact_ratio']:.4f}  Z3={group['z3_verified']}")

Supported Regulations

Regulation Method Jurisdiction
NYC Local Law 144 client.audit_ll144() New York City
EU AI Act (Art 9-15) client.audit_eu_ai_act() European Union
Federal Reserve SR 11-7 client.audit_sr117() US Banking
Colorado AI Act (SB 205) client.audit_colorado() Colorado
FDA 21 CFR 820 client.audit_fda() US Medical Devices
Texas TRAIGA (HB 149) client.audit_texas_traiga() Texas

Key Features

Formal Verification (Z3 SMT Proofs)

Every audit produces machine-checkable mathematical proofs — not statistical estimates.

Intersectional Analysis

Automatically discovers and tests all combinatorial demographic intersections.

Multi-Regulation Crosswalk

Map compliance findings across frameworks (e.g., LL144 → EU AI Act → NIST AI RMF).

Zero-Knowledge Proofs

Prove fairness compliance without revealing model weights or training data.

Continuous Monitoring

Real-time drift detection with confidence-weighted alerts and breach forecasting.

API Reference

See the full documentation.

Benchmarks

Reproducible benchmarks comparing Aethelgard to Fairlearn, AIF360, and manual auditing across 10 real-world datasets (40K+ to 2.5M+ records):

pip install aethelgard-ai[benchmarks]
python -m aethelgard.benchmarks

Citation

@software{aethelgard2026,
  author = {Ashuraliyev, Abduxoliq},
  title = {Aethelgard: Formal Verification for AI Fairness Compliance},
  year = {2026},
  url = {https://github.com/ProgrmerJack/Aethelgard},
}

License

Apache License 2.0. See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aethelgard_ai-1.2.0.tar.gz (23.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aethelgard_ai-1.2.0-py3-none-any.whl (26.4 kB view details)

Uploaded Python 3

File details

Details for the file aethelgard_ai-1.2.0.tar.gz.

File metadata

  • Download URL: aethelgard_ai-1.2.0.tar.gz
  • Upload date:
  • Size: 23.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for aethelgard_ai-1.2.0.tar.gz
Algorithm Hash digest
SHA256 8eabeaf32128d638b0465eb87015de19db7155b72ebe1dbb0b02f0e0cb26e27c
MD5 c1e0f099ea5802cf197a822ca20fafa0
BLAKE2b-256 d02c514da2d501392f9ef9e35f8623567cfd56687dd8d064c26c8f7c931391d3

See more details on using hashes here.

File details

Details for the file aethelgard_ai-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: aethelgard_ai-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 26.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for aethelgard_ai-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9e373c62152cf87e489b1a94bcbfd0dc223882ead782cd4a3b31c685968f3e8b
MD5 600e4ac2e0ddc16cbee17d80a0e66e54
BLAKE2b-256 f3120abc32ff46781fb5cb54b226f63503e3e931af5ba02bc4b59a1a79ba3f48

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page