AgentLedger
Tamper-proof compliance audit trail for AI agents.
One-line SDK integration. SHA-256 hash-chained logs. Pre-built compliance reports for EU AI Act Article 12 and SOC 2 Type II. The EU AI Act high-risk system rules take effect August 2, 2026.
Quick Start
import agentledger
# Initialize (one line)
ledger = agentledger.init(agent_id="my-agent")
# Log an AI action
agentledger.log_event(
action_type="llm_call",
input="What is the capital of France?",
output="The capital of France is Paris.",
model="claude-sonnet-4-20250514",
provider="anthropic",
tokens_in=12,
tokens_out=8,
latency_ms=340,
)
That's it. Every action is hash-chained and tamper-detectable.
Features
- Tamper-proof — SHA-256 hash chain links every log entry to the previous one. If any entry is modified, the chain breaks.
- EU AI Act Article 12 — Pre-built compliance report covering logging capability, traceability, integrity, and retention requirements.
- SOC 2 Type II — Evidence report for CC6.1, CC7.2, CC7.3, and CC8.1 trust service criteria.
- One-line SDK —
agentledger.init()and you're logging. No configuration files, no infrastructure. - Local-first — SQLite storage with WAL mode. No cloud dependency. Your data stays on your machine.
- REST API — FastAPI server for querying logs, exporting (JSON/CSV), and generating reports.
- CLI — Query, verify, generate reports, and serve the API from the command line.
- Auto-capture — Anthropic SDK adapter for automatic logging of all API calls.
Installation
pip install agent-audit-trail
CLI Usage
# Query recent logs
agentledger query --agent-id my-agent --limit 20
# Verify hash chain integrity
agentledger verify
# Generate EU AI Act compliance report
agentledger report eu-ai-act --output report.md
# Generate SOC 2 evidence report
agentledger report soc2
# Show statistics
agentledger stats
# Start the API server
agentledger serve --port 8100
REST API
Start the server with agentledger serve, then:
| Method | Endpoint | Description |
|---|---|---|
GET |
/logs |
Query log entries (filters: agent_id, action_type, since, until) |
GET |
/logs/{id} |
Get a single entry |
GET |
/stats |
Log statistics |
GET |
/verify |
Verify hash chain integrity |
POST |
/export |
Export logs as JSON or CSV |
GET |
/reports/eu-ai-act |
EU AI Act Article 12 compliance report |
GET |
/reports/soc2 |
SOC 2 Type II evidence report |
GET |
/reports/audit |
Basic audit trail report |
GET |
/health |
Health check |
Architecture
┌─────────────────────────────┐
│ Your AI Agent Code │
│ │
│ import agentledger │
│ agentledger.init(...) │
│ agentledger.log_event(...) │
└──────────┬──────────────────┘
│ SDK appends entries
▼
┌──────────────────────────────┐
│ Append-Only Storage │
│ SQLite + WAL mode │
│ SHA-256 hash chain │
└──────────┬───────────────────┘
│
┌─────┴─────┐
▼ ▼
┌─────────┐ ┌──────────┐
│ CLI │ │ FastAPI │
│ query │ │ /logs │
│ verify │ │ /verify │
│ report │ │ /reports │
└─────────┘ └──────────┘
Action Types
| Type | Description |
|---|---|
llm_call |
LLM API calls (input, output, model, tokens) |
tool_use |
Tool/function invocations |
decision |
Agent decisions with reasoning |
outcome |
Final outcomes and results |
error |
Error events |
human_approval |
Human-in-the-loop approvals |
Anthropic Auto-Capture
from agentledger.adapters.anthropic_adapter import patch_anthropic
# Automatically logs all Anthropic API calls
patch_anthropic(agent_id="my-agent")
Why AgentLedger?
| Feature | AgentLedger | LangSmith | Braintrust | Helicone |
|---|---|---|---|---|
| Tamper detection | SHA-256 chain | No | No | No |
| EU AI Act reports | Built-in | No | No | No |
| SOC 2 reports | Built-in | No | No | No |
| Local-first | SQLite | Cloud only | Cloud only | Proxy |
| Framework-agnostic | Yes | LangChain | Eval-focused | Proxy |
| Open source | MIT | Partial | Partial | Partial |
License
MIT
Metadata
Release files for agent-audit-trail 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agent_audit_trail-1.0.0.tar.gz | 14.0 kB | With provenance | Details for agent_audit_trail-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agent_audit_trail-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for agent_audit_trail-1.0.0-py3-none-any.whl |
Total release size: 30.7 kB
Release files / agent_audit_trail-1.0.0.tar.gz
| Download URL | agent_audit_trail-1.0.0.tar.gz |
|---|---|
| Size | 14.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ff30d4a3e1b4950021075299a433d48caf29c30e0fd07aa7f9a6ea8408a40dcf
|
|
BLAKE2b-256 checksum How to use checksums |
dfc4e97b3f0adf6d8968566386433fc1e9681d54cf62ba1735f47bb88a263279
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 4, 2026.
Transparency logRelease files / agent_audit_trail-1.0.0-py3-none-any.whl
| Download URL | agent_audit_trail-1.0.0-py3-none-any.whl |
|---|---|
| Size | 16.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fb45573a887407b703f269fa0cef995e99df9a44938165b31306962a8af67f3d
|
|
BLAKE2b-256 checksum How to use checksums |
b3bc4433945b3088cc16d0dac5fe073b97c81537762310cbe3d80917a9973708
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 4, 2026.
Transparency logSecurity for agent-audit-trail 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for agent_audit_trail-1.0.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 4, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.