Skip to main content

AgentLedger

Tamper-proof compliance audit trail for AI agents.

PyPI Python 3.11+ License: MIT

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)

Source distribution for agent-audit-trail 1.0.0
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)

Table of built distributions (wheels) for agent-audit-trail 1.0.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page