Skip to main content

smolagents-aer1

Every tool call your smolagents agent makes, recorded as an AER-1 verifiable execution receipt. Five lines of code. No new infrastructure.

AER-1 is an open IETF Internet-Draft (draft-zambo-aer1) defining a small vocabulary for recording one AI agent tool call as a portable, independently checkable receipt. A receipt proves the recorded result was not changed. It does not prove the tool was correct.

For whole-run workflow receipts with a Merkle root (AER-1 Section 8), see aer1-smolagents.

Install

pip install smolagents-aer1

10-minute quickstart

from smolagents import CodeAgent, InferenceClientModel
from smolagents_aer1 import AER1Recorder

recorder = AER1Recorder()
agent = CodeAgent(
    tools=[],
    model=InferenceClientModel(),
    step_callbacks=[recorder],
)
agent.run("What is 17 * 24?")

print(f"{len(recorder.receipts)} receipts recorded")
recorder.save("receipts.jsonl")

That is the whole integration. step_callbacks is smolagents' blessed hook for observing steps (the same pattern tracing integrations use). The recorder watches each action step and emits one receipt per tool call.

What a receipt looks like

{
  "id": "3f9a2c1e-7b4d-4f8a-9c2e-1a5b6d7e8f90",
  "receipt_schema_version": "0.3",
  "created_at": "2026-10-05T21:20:00.123456Z",
  "tool": {"name": "python_interpreter", "version": "1.26.0", "scope": "public"},
  "provenance_class": "EXECUTED BY SMOLAGENTS",
  "canonical_bytes": "eyJpbnB1dHMiOi...",
  "output_hash": "sha256:9f2c...",
  "verification_status": "verified"
}

The canonical bytes are a deterministic JSON payload (tool, inputs, output). Anyone can base64-decode them, recompute SHA-256, and compare with output_hash. That is the entire verification procedure.

Verify a receipt yourself

from smolagents_aer1 import verify_receipt

failures = verify_receipt(recorder.receipts[0])
assert failures == [], failures
print("receipt checks out")

Or run the full open conformance suite against your receipts: https://gitlab.com/rambozambodotdev/zambo

Notes

  • Provenance class is EXECUTED BY SMOLAGENTS: the recorder runs inside the agent process and records what the agent did.
  • CodeAgent records each code execution as one python_interpreter tool call. ToolCallingAgent records each named tool call separately.
  • When one step contains several tool calls, each receipt commits to the step's full observation string.
  • The tool.version field records the smolagents runtime version.
  • Receipts are local JSON. Nothing is sent anywhere. Publishing or anchoring them is your choice.

License

MIT. See LICENSE.

Where these receipts run live: Zambo

smolagents-aer1 gives smolagents agents a verifiable AER-1 receipt for every tool call, and it has been downloaded 846 times on PyPI. The live home of those receipts is Zambo, the verifiable work layer for AI. Connect any AI to the live endpoint at https://zambo.dev/mcp or add Zambo to your AI in one step at https://zambo.dev/add/

Free tier: every tool free once a day, plus 3 continue calls. One free wrap-up handover per day, and pickup is always free. The Day Pass is $0.99 for 24 hours, unlimited.

Install:

pip install smolagents-aer1

Zambo, built by Brennan Zambo, the creator of the AER-1 standard, runs 153 tools in total, 37 on the default surface, behind one MCP endpoint: https://zambo.dev/mcp.

Metadata

Release files for smolagents-aer1 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for smolagents-aer1 0.1.3
File Size Uploaded Provenance Actions
smolagents_aer1-0.1.3.tar.gz 6.8 kB Without provenance Details for smolagents_aer1-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for smolagents-aer1 0.1.3
File Interpreter ABI Platform Actions
smolagents_aer1-0.1.3-py3-none-any.whl Python 3 none any Details for smolagents_aer1-0.1.3-py3-none-any.whl

Total release size: 13.0 kB

Release files / smolagents_aer1-0.1.3.tar.gz

Download URL smolagents_aer1-0.1.3.tar.gz
Size 6.8 kB
Tags Source
SHA-256 checksum
How to use checksums
445a4d315632fd780843424cea5ebdb20d89a78e63b297f710122edf2cce1d24
BLAKE2b-256 checksum
How to use checksums
718c4c31e1301dbf776549eadadb8174b31caf2750d9a52039eaf7020c1271be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via rambo-pypi-grab/0.1.0

Release files / smolagents_aer1-0.1.3-py3-none-any.whl

Download URL smolagents_aer1-0.1.3-py3-none-any.whl
Size 6.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
be25c90578a38d3f0822d124805a6b470c6f3b324f6e36d8ea72f5df96beb092
BLAKE2b-256 checksum
How to use checksums
c87684d85a34df8d6df07c6495f7e75cd7a327aa4fd03690ba145dc1dfe44d8d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via rambo-pypi-grab/0.1.0

Security for smolagents-aer1 0.1.3

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

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