Skip to main content

zambo-openai-agents

AER-1, the agent execution receipt standard: zambo.dev/aer-1 | Add Zambo to your AI: zambo.dev/add

Zambo is the verifiable work layer for AI. This package connects OpenAI Agents SDK agents to it, minting a verifiable AER-1 receipt for every tool call.

Receipt format: AER-1, IETF Internet-Draft draft-zambo-aer1-26.

Verifiable execution receipts for OpenAI Agents SDK agents. Give your OpenAI Agents SDK agent Zambo's live tools. Every tool call is executed by Zambo and mints a verifiable AER-1 receipt: a public URL carrying the tool, its arguments, the observed result, a SHA-256 fingerprint, and machine-readable JSON-LD.

from agents import Agent, Runner
from zambo_openai_agents import zambo_tools

agent = Agent(name="assistant", tools=zambo_tools(["live_price", "prompt_shield"]))
result = await Runner.run(agent, "What is the live BTC price?")

No account. No API key. Free tier: every tool free once a day, plus 3 continue calls. One free wrap-up handover per day, and pickup is always free.

What the receipt actually proves

Each receipt page (for example https://zambo.dev/run/<id>) is the public record of the call: the tool name, the exact arguments your agent sent, the observed result, a timestamp, and a SHA-256 fingerprint of the record, published as JSON-LD. Anyone can recompute the fingerprint and check that the saved result was not changed, with no account.

The included ZamboReceiptProcessor (a standard TracingProcessor) attaches each minted receipt URL to its trace span, so the trace shows proof next to every call:

from agents.tracing.setup import get_trace_provider
from zambo_openai_agents import ZamboReceiptProcessor

processor = ZamboReceiptProcessor()
get_trace_provider().register_processor(processor)
# after the run: processor.receipts -> {span_id: receipt_url}

Install

pip install zambo-openai-agents

One tool, custom schema

from zambo_openai_agents import zambo_tool

price_tool = zambo_tool(
    "live_price",
    params_json_schema={
        "type": "object",
        "properties": {"symbol": {"type": "string"}},
        "required": ["symbol"],
    },
)

Browse the full catalog any time with zambo_openai_agents.list_tools(), or pick tools by use case through Zambo's capability_search tool.

Notes

  • Zambo calls need no key and no signup. Heavy tracing (dozens of tool calls per run) will reach the free daily limit; the tool raises a clear error and the agent run continues with the other tools.
  • The processor never breaks your run: span handling is fully exception-guarded, and it ignores non-Zambo spans.
  • Receipts are public by design. Do not pass secrets as tool arguments.

MIT License.

Where these receipts run live: Zambo

zambo-openai-agents connects OpenAI Agents SDK agents to Zambo, minting a verifiable AER-1 receipt for every tool call, and it has been downloaded 3,614 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 zambo-openai-agents

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 zambo-openai-agents 0.1.9

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

Source distribution (sdist)

Source distribution for zambo-openai-agents 0.1.9
File Size Uploaded Provenance Actions
zambo_openai_agents-0.1.9.tar.gz 8.7 kB Without provenance Details for zambo_openai_agents-0.1.9.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for zambo-openai-agents 0.1.9
File Interpreter ABI Platform Actions
zambo_openai_agents-0.1.9-py3-none-any.whl Python 3 none any Details for zambo_openai_agents-0.1.9-py3-none-any.whl

Total release size: 17.5 kB

Release files / zambo_openai_agents-0.1.9.tar.gz

Download URL zambo_openai_agents-0.1.9.tar.gz
Size 8.7 kB
Tags Source
SHA-256 checksum
How to use checksums
af012ba90068b03874afbcd5b7a969c28ee2ab1107ac1a7b14bc539ee29102cc
BLAKE2b-256 checksum
How to use checksums
5765e2e0c6f771356291229fc5415056ec852ce165f60dc4a18b50cbeb52269b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via rambo-pypi-grab/0.1.0

Release files / zambo_openai_agents-0.1.9-py3-none-any.whl

Download URL zambo_openai_agents-0.1.9-py3-none-any.whl
Size 8.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ca48a9105a6bf782a9c37566964e5124377fdcf09fde27c68aeaa5d3113a7f42
BLAKE2b-256 checksum
How to use checksums
525b27be3644e577d371259b4b8878131d2d6cddb41ccf2af2d6b3eacf9efc9b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via rambo-pypi-grab/0.1.0

Security for zambo-openai-agents 0.1.9

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