attestant 0.23.0

Upload model data to Attestant for compliance analysis

Attestant

AI compliance for regulated lenders. Validate, approve, monitor, and defend AI-driven models and decisions.

Install

pip install attestant

Quick Start

import attestant
import pandas as pd

# Configure (or set ATTESTANT_API_KEY environment variable)
attestant.configure(api_key="pvt_live_...")

# 1. Declare data sources — provenance tracks automatically
data = attestant.source(pd.read_csv("applicants.csv"), "applicants")
demographics = attestant.source(
    pd.read_csv("demographics.csv"), "demographics",
    protected=["race", "gender", "age"],
)

# 2. Normal pandas — taint propagation happens behind the scenes
merged = data.merge(demographics, on="id")
X = merged[["income", "credit_score", "dti"]]
y = merged["approved"]

# 3. Validate before deployment
result = attestant.upload(
    model=model,
    X_test=X, y_test=y,
    protected_columns=["race", "gender", "age"],
    model_name="credit_approval",
    model_version="v2.1",
)
print(result.dashboard_url)

# 4. Gate in production (one line)
attestant.gate("credit_approval", "v2.1")

# 5. Log predictions for monitoring
attestant.log_predictions(
    model_name="credit_approval",
    model_version="v2.1",
    predictions=model.predict_proba(X_new)[:, 1],
    features=X_new,
    protected_data=demographics_new,
    protected_columns=["race", "gender", "age"],
    applicant_ids=df["application_id"].tolist(),
)

What It Does

• 41 automated compliance checks across ECOA/Reg B, SR 11-7, and EU AI Act
• Fairness analysis with disparate impact detection and SHAP-based adverse action reason codes
• Model gating -- block unapproved models from production with one line
• Inference monitoring -- track predictions, detect drift, generate alerts
• Decision defense -- reconstruct any individual decision for examiner review
• Data provenance -- automatic lineage tracking through pandas operations

Protected Columns

Mark columns containing protected attributes (race, gender, age, etc.) so Attestant can check for disparate impact and proxy discrimination:

data = attestant.source(df, "applicants", protected=["race", "gender", "age"])

Attestant automatically tracks whether protected data influences predictions -- even through indirect feature engineering.

Age Column Handling

Specify how age data is formatted:

result = attestant.upload(
    ...,
    age_column="applicant_age",
    age_format="years",  # or: "months", "days", "dob", "birth_year"
)

Vendor Models

Validate vendor/third-party models the same way -- just pass predictions instead of a model:

# Get predictions from vendor API
vendor_predictions = vendor_api.score(X_test)

# Validate with full compliance suite
result = attestant.upload(
    predictions=vendor_predictions,
    X_test=X_test, y_test=y_test,
    protected_columns=["race", "gender", "age"],
    model_name="vendor_credit_score",
    model_version="v3.2",
)

# Gate and monitor in production
attestant.gate("vendor_credit_score", "v3.2")
attestant.log_predictions(
    model_name="vendor_credit_score",
    model_version="v3.2",
    predictions=vendor_api.score(X_new),
    features=X_new,
    protected_data=demographics_new,
    protected_columns=["race", "gender", "age"],
)

All 41 compliance checks, fairness analysis, model gating, and inference monitoring work identically for vendor models.

CI/CD Integration

export ATTESTANT_API_KEY=pvt_live_...
attestant gate-check --model credit_approval --version v2.1
# Exit 0 = approved, 1 = blocked

Documentation

Full documentation at getattestant.com/docs

License

Apache 2.0