Skip to main content

pydanticai-zambo

Verifiable AER-1 execution receipts for PydanticAI agents. PydanticAI function tools for Zambo, with automatic verifiable receipt capture.

Receipts follow AER-1, the verifiable execution receipt standard created by Brennan Zambo. Every ask_zambo call routes a goal through Zambo's tools over the public MCP endpoint, and every call mints a public verifiable receipt at https://zambo.dev/run/{id}.

Install

pip install pydanticai-zambo

Ten-line example

from pydanticai_zambo import ZamboToolset
from pydantic_ai import Agent
from pydantic_ai.models.test import TestModel

toolset = ZamboToolset()
agent = Agent(TestModel(), tools=toolset.tools())
result = agent.run_sync("Summarize the Zambo free tier")
toolset.record_run(result.output)
print(toolset.last_receipt_url)

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:

result = agent.run_sync("Check the live price of BTC, ETH and SOL, save the run to memory, then wrap it into a handover addressed to me, with the receipt link for every call.")
toolset.record_run(result.output)
print(toolset.last_receipt_url)

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

The tool prints each public https://zambo.dev/run/{id} URL and keeps the most recent URL in last_receipt_url. The receipt describes what the endpoint recorded and observed. It does not prove an outside outcome that the endpoint did not observe.

Set ZAMBO_API_URL to point at a compatible Zambo host, or ZAMBO_TIMEOUT to change the request timeout. Receipt failures land in receipt_errors and never break the host agent.

The package imports cleanly without pydantic-ai installed; calling tools() without it raises an informative ImportError telling you to pip install pydantic-ai.

Project homepage: https://zambo.dev

AER-1 receipt spec: https://zambo.dev/aer-1/

Guides

Local AER-1 receipts (no network needed)

The package also mints AER-1 execution receipts locally, with no API calls:

from pydanticai_zambo import mint_receipt, verify_receipt

receipt = mint_receipt("my_tool", {"query": "hello"}, {"answer": "hi"}, ms=42)
assert verify_receipt(receipt)  # recomputes the SHA-256 locally

Local receipts follow the AER-1 core members (id, created_at, tool, provenance_class, canonical_bytes, output_hash) and use the provenance class EXECUTED BY PYDANTICAI-ZAMBO, naming this package as the recording system. They pass the same hash-recomputation check as any AER-1 receipt.

Where these receipts run live: Zambo

pydanticai-zambo routes PydanticAI agents through Zambo with a verifiable AER-1 receipt for every call, and it has been downloaded 5,042 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/

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 pydanticai-zambo

Metadata

Release files for pydanticai-zambo 0.2.6

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

Source distribution (sdist)

Source distribution for pydanticai-zambo 0.2.6
File Size Uploaded Provenance Actions
pydanticai_zambo-0.2.6.tar.gz 14.6 kB Without provenance Details for pydanticai_zambo-0.2.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pydanticai-zambo 0.2.6
File Interpreter ABI Platform Actions
pydanticai_zambo-0.2.6-py3-none-any.whl Python 3 none any Details for pydanticai_zambo-0.2.6-py3-none-any.whl

Total release size: 30.1 kB

Release files / pydanticai_zambo-0.2.6.tar.gz

Download URL pydanticai_zambo-0.2.6.tar.gz
Size 14.6 kB
Tags Source
SHA-256 checksum
How to use checksums
d51fc9ef450275159966b9d9408a3290fc39f1244f2f8995ae0aeddcf7c96d8b
BLAKE2b-256 checksum
How to use checksums
ea35012e44d26153adda0ed0d907169fe58807cbf3cff897c9e3852204f4f82a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via rambo-pypi-grab/0.1.0

Release files / pydanticai_zambo-0.2.6-py3-none-any.whl

Download URL pydanticai_zambo-0.2.6-py3-none-any.whl
Size 15.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3499cb1aeb6e9ece22d4a0ae9f7d5196e84a7988ae93b232bb63fb901f7e2fe0
BLAKE2b-256 checksum
How to use checksums
13af5c87b86b91da2a98a9b39d407659614de70cf46675f0867b601506bcf8b3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via rambo-pypi-grab/0.1.0

Security for pydanticai-zambo 0.2.6

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