lens-compliance 0.1.0

EU AI Act compliance assessment for AI model explanations via IEEE 2894-2024 XAI taxonomy

lens-compliance

EU AI Act compliance assessment for AI model explanations.

Maps XAI library outputs (SHAP, LIME) through the IEEE 2894-2024 architectural taxonomy to generate structured evidence for EU AI Act Article 13/14/15 requirements.

• Standard: IEEE 2894-2024 / EU AI Act Regulation 2024/1689
• Deadline: EU AI Act transparency provisions effective August 2, 2026
• Penalty: Up to €35M or 7% global turnover for non-compliance

Installation

pip install lens-compliance

Quick Start

from lens_compliance import assess

# With a SHAP explanation object
report = assess(
    explanation=shap_values,          # shap.Explanation, LIME, or dict
    model_name="CreditScore-v2",
    model_version="2.3.0",
    deployment_context="Consumer credit application scoring",
    high_risk_category="credit_scoring",
)

print(report.overall_status)         # COMPLIANT / PARTIAL / NON_COMPLIANT
report.save_markdown("report.md")
report.save_json("report.json")

REST API

pip install lens-compliance fastapi uvicorn
uvicorn lens_compliance.api:app --reload

POST /assess — full compliance assessment
GET /health — service status
GET /categories — EU AI Act Annex III high-risk categories
GET /articles — covered EU AI Act articles

EU AI Act Coverage

Article	Requirement	Quality Dimension
13(1)	Transparency — System Interpretability	Comprehensibility + Completeness
13(3)(b)	Output Interpretation Guidance	Comprehensibility + Compactness
14(4)	Human Oversight — Override Enablement	Faithfulness + Completeness
15(1)	Robustness — Explanation Stability	Stability across similar inputs
13(1) Annex III	Individual Explanation (High-Risk)	Local scope + Comprehensibility

IEEE 2894-2024 Taxonomy

Explanations are classified into four quadrants:

	Local	Global
Post-hoc	SHAP, LIME	Permutation importance
Ante-hoc	Decision tree path	Linear regression weights

High-Risk Categories (Annex III)

credit_scoring · hiring · insurance · medical_diagnosis · critical_infrastructure · education · law_enforcement · migration · administration_of_justice · biometric

License

Apache 2.0