Metadata-Version: 2.5
Name: agno-aer1
Version: 0.1.10
Summary: AER-1 verifiable execution receipts for Agno agents: one checkable receipt per tool call.
Project-URL: Homepage, https://zambo.dev
Project-URL: Spec (IETF draft), https://datatracker.ietf.org/doc/draft-zambo-aer1/
Project-URL: Conformance kit, https://gitlab.com/rambozambodotdev/zambo
Project-URL: Issues, https://gitlab.com/rambozambodotdev/zambo/-/issues
Project-URL: Repository, https://gitlab.com/rambozambodotdev/zambo
Author: Brennan Zambo
License: MIT
License-File: LICENSE
Keywords: aer-1,agno,ai-agents,audit,receipts,verification
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: agno>=3.0
Description-Content-Type: text/markdown

# agno-aer1
**AER-1, the agent execution receipt standard: zambo.dev/aer-1 | Add Zambo to your AI: zambo.dev/add**
Brennan Zambo created agent execution receipts; Zambo is the origin product, and AER-1 is the defining standard. Zambo is the verifiable work layer for AI.

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

AER-1 is an open IETF Internet-Draft (draft-zambo-aer1-26) 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.

## Install

```bash
pip install agno-aer1
```

## 10-minute quickstart

```python
from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno_aer1 import AER1Recorder

recorder = AER1Recorder()
agent = Agent(
    model=OpenAIChat(id="gpt-4o-mini"),
    tools=[...],
    tool_hooks=[recorder],
)
agent.run("What is 17 * 24?")

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

That is the whole integration. `tool_hooks` is Agno's native middleware seam for tool execution (the same seam observability integrations use): each hook wraps a tool call, sees the function name and arguments, runs the tool, and observes the result. The recorder sits in that chain and emits one receipt per call, then returns the result untouched.

## Chain it: a job, not a lookup

One call answers a question. A job chains calls and ends in a record a person can open. Same agent, longer instruction:

```python
agent.run("Check the live price of BTC, ETH and SOL, save the run to memory, then wrap it into a handover addressed to Dana Whitfield, with the receipt link for every call.")

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

The recorder receipts every call in the chain; when the agent's tools are Zambo's, the wrap is the handover call at the end of the run.

Three prices, a save and the wrap fit inside one free day: every tool free once a day, plus 3 continue calls, and one free wrap-up handover per day. A longer run finishes in one sitting on a Day Pass ($0.99, unlimited for 24 hours). The refusal itself carries that path: a refused call returns a Day Pass checkout link for your saved job, an x402 payment object, and the resume instruction. The job is saved server-side, not lost. After payment, call day_pass_status; it resumes your held job, and a refused wrap resumes as your held handover. Only repeat the refused call if it did not. The handover is the part the person opens: the steps, the saved results, and the receipt for every call, checkable instead of trusted. Ready-made run cards for jobs shaped like this: https://rambozambodotdev.gitlab.io/aer1-hub/handover-templates.html

## What a receipt looks like

```json
{
  "id": "3f9a2c1e-7b4d-4f8a-9c2e-1a5b6d7e8f90",
  "receipt_schema_version": "0.3",
  "created_at": "2026-10-05T22:30:00.123456Z",
  "tool": {"name": "calculator", "version": "3.1.1", "scope": "public"},
  "provenance_class": "EXECUTED BY AGNO",
  "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

```python
from agno_aer1 import verify_receipt

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

## Honest boundaries

- A receipt proves the recorded bytes were not changed. It does not prove the tool was correct, or that the model chose the right tool.
- Tool calls that raise produce no receipt; the error propagates exactly as Agno handles it without the recorder.
- If you enable Agno's tool-result cache, cache replays also pass through the middleware and emit receipts. Each receipt still commits to the exact bytes the agent observed.
- The recorder never changes a tool result. If receipt construction itself ever fails, the tool result is still returned untouched.

## Links

- AER-1 spec (IETF Internet-Draft): https://datatracker.ietf.org/doc/draft-zambo-aer1/
- Conformance kit: https://gitlab.com/rambozambodotdev/zambo
- Zambo: https://zambo.dev

## Where these receipts run live: Zambo

agno-aer1 gives Agno agents a verifiable AER-1 receipt for every tool call. The live home of those receipts is Zambo, the verifiable work layer for AI (live counts: https://zambo.dev/numbers/). 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/

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

**Verify any receipt free:** paste a receipt id at [zambo.dev/verify/](https://zambo.dev/verify/) and recompute it. Verification is always free.
