Audit LLM traces against regulatory compliance requirements (EU AI Act, NIST AI RMF)
Project description
AI Trace Auditor
Audit LLM traces against regulatory compliance requirements. Open-source CLI that sits between your observability stack (Langfuse, Arize, OTel) and regulatory frameworks (EU AI Act, NIST AI RMF).
Your observability tools collect traces. Your GRC platform manages policies. Nothing translates traces into compliance evidence. This tool does.
Install
pip install ai-trace-auditor
Or from source:
git clone https://github.com/BipinRimal314/ai-trace-auditor.git
cd ai-trace-auditor
pip install -e .
Quick Start
# Audit traces against all regulations
aitrace audit traces.json
# Audit against a specific regulation
aitrace audit traces.json -r "EU AI Act" -o report.md
# Inspect what requirements exist
aitrace requirements --show EU-AIA-12.1
# Just ingest and summarize traces
aitrace ingest traces.json --summary
What It Checks
EU AI Act Article 12 (Record-Keeping):
- Event timestamps, operation identification
- Risk situation logging (errors, failure modes)
- Model version tracking for post-market monitoring
- Resource consumption (tokens, latency)
- Content recording (opt-in)
- Tool/function call audit trails
- Trace linkage for multi-step operations
NIST AI RMF:
- Production monitoring (MEASURE 2.4)
- Transparency documentation (MEASURE 2.8)
- Model explainability (MEASURE 2.9)
- Risk tracking (MEASURE 3.1)
- Post-deployment monitoring (MANAGE 4.1)
- Incident communication (MANAGE 4.3)
Supported Trace Formats
| Format | Source |
|---|---|
| OTel OTLP JSON | OpenTelemetry GenAI semantic conventions |
| Langfuse JSON | Langfuse trace exports |
| Raw JSONL | Any provider's API logs |
Auto-detected. Use --format to override.
Example Output
Overall Compliance Score: 72.3%
| Status | Count |
|-----------|-------|
| Satisfied | 6 |
| Partial | 4 |
| Missing | 3 |
Top gaps:
1. Not logging: Error classification when operations fail
2. Incomplete: Input prompts/messages (0% coverage)
3. Not logging: Tools/functions available to the AI model
CI Integration
Exit code 0 = all satisfied, 1 = gaps found:
aitrace audit traces.json -r "EU AI Act" || echo "Compliance gaps detected"
Disclaimer
This tool provides automated compliance assessments based on its interpretation of regulatory requirements. It is not legal advice. Consult qualified legal counsel for compliance decisions.
License
Apache 2.0
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ai_trace_auditor-0.1.0.tar.gz.
File metadata
- Download URL: ai_trace_auditor-0.1.0.tar.gz
- Upload date:
- Size: 31.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ba80182e7be74a389c8ae89a8015e066250614cbb61b9aeed7f91c919b477937
|
|
| MD5 |
b716cd6f626912750814ff18c1d4d15f
|
|
| BLAKE2b-256 |
33ee5f17dc88ab423e42bcf56f2848d7f1a0c8e81d7fed20eea3473f88f22857
|
Provenance
The following attestation bundles were made for ai_trace_auditor-0.1.0.tar.gz:
Publisher:
publish.yml on BipinRimal314/ai-trace-auditor
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ai_trace_auditor-0.1.0.tar.gz -
Subject digest:
ba80182e7be74a389c8ae89a8015e066250614cbb61b9aeed7f91c919b477937 - Sigstore transparency entry: 1109448842
- Sigstore integration time:
-
Permalink:
BipinRimal314/ai-trace-auditor@359684620b41787b6b7deee540eaeaa4c66d4685 -
Branch / Tag:
refs/tags/0.1.0 - Owner: https://github.com/BipinRimal314
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@359684620b41787b6b7deee540eaeaa4c66d4685 -
Trigger Event:
release
-
Statement type:
File details
Details for the file ai_trace_auditor-0.1.0-py3-none-any.whl.
File metadata
- Download URL: ai_trace_auditor-0.1.0-py3-none-any.whl
- Upload date:
- Size: 30.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cc92fc2c6da2aea0b1293f69020a0f2d4ac0c93ada184c774008f8a646c87fdf
|
|
| MD5 |
187c926660d1e78fc286733adfac0cf6
|
|
| BLAKE2b-256 |
9dc37b902fdf465bc12a7133ae3142400c3cfa8867ff87acc03cbd6108ed80e6
|
Provenance
The following attestation bundles were made for ai_trace_auditor-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on BipinRimal314/ai-trace-auditor
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ai_trace_auditor-0.1.0-py3-none-any.whl -
Subject digest:
cc92fc2c6da2aea0b1293f69020a0f2d4ac0c93ada184c774008f8a646c87fdf - Sigstore transparency entry: 1109448847
- Sigstore integration time:
-
Permalink:
BipinRimal314/ai-trace-auditor@359684620b41787b6b7deee540eaeaa4c66d4685 -
Branch / Tag:
refs/tags/0.1.0 - Owner: https://github.com/BipinRimal314
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@359684620b41787b6b7deee540eaeaa4c66d4685 -
Trigger Event:
release
-
Statement type: