Metadata-Version: 2.4
Name: crewai-zambo
Version: 0.1.14
Summary: Verifiable AER-1 execution receipts for CrewAI agents. Every task event publishes a verifiable receipt at zambo.dev.
Author: Zambo
License: MIT
Project-URL: AER-1 standard, https://zambo.dev/aer1/
Project-URL: Add Zambo to your AI, https://zambo.dev/add
Project-URL: Homepage, https://zambo.dev
Project-URL: Documentation, https://zambo.dev/integrations/crewai-receipts/
Keywords: crewai,ai agent receipt,verifiable receipt,observability,mcp,verifiable-execution-receipts,execution-receipts,verifiable-receipt
Requires-Python: >=3.9
Description-Content-Type: text/markdown

[![verifiable receipts](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fzambo.dev%2Fapi%2Fstats&query=%24.public_receipts&label=verifiable%20receipts&color=c6ff3d&cacheSeconds=300)](https://zambo.dev/numbers/) [![package downloads](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fzambo.dev%2Fapi%2Fpackage-stats&query=%24.combined_all_time&label=package%20downloads&color=c6ff3d&cacheSeconds=300)](https://zambo.dev/numbers/)

**Zambo: the verifiable work layer for AI.** Watch a handover in 61 seconds: https://dev.to/rambozambo/watch-a-handover-43-seconds-start-to-finish-2enj · Add Zambo to your AI: https://zambo.dev/add/ · MCP endpoint: https://zambo.dev/mcp

# crewai-zambo

**AER-1, the agent execution receipt standard: [zambo.dev/aer-1](https://zambo.dev/aer-1/) | Add Zambo to your AI: [zambo.dev/add](https://zambo.dev/add)**

Zambo is the verifiable work layer for AI. This package publishes CrewAI task events as verifiable AER-1 receipts at zambo.dev.

Receipt format: AER-1, IETF Internet-Draft [draft-zambo-aer1-26](https://datatracker.ietf.org/doc/draft-zambo-aer1/26/).

Verifiable AER-1 execution receipts for CrewAI agents. Publish CrewAI task events as public, verifiable receipts at [zambo.dev](https://zambo.dev).

Receipts follow [AER-1](https://zambo.dev/aer-1/), the IETF draft for verifiable execution receipts created by Brennan Zambo.

## Install

```bash
pip install crewai-zambo
```

## 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. Lead with the job: give the crew a chained job instead of a single task, with this instruction:

```text
Check the live price of BTC, ETH and SOL, save the run to memory, then wrap it into a handover addressed to Dana Whitfield, the client who ordered the check, with summary, goal, recipient and next steps, and the receipt link for every call.
```

Each task the crew completes in the chain publishes its receipt through the listener, so the whole job is on the record, not just the last step.

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

## Ten-line example

```python
from crewai_zambo import ZamboCrewListener

listener = ZamboCrewListener()
result = listener.on_task_completed("Summarize this task", "completed")
print(listener.last_receipt_url or result)
```

Attach `ZamboCrewListener` to the CrewAI listener mechanism supported by your installed CrewAI version, or call `on_task_completed` from a task completion hook. The listener prints each public `https://zambo.dev/run/{id}` URL and keeps the most recent URL in `last_receipt_url`.

The receipt describes what the live endpoint recorded and observed. It does not prove an outside outcome that the endpoint did not observe. Set `ZAMBO_API_URL` when using a compatible Zambo host. Listener failures are available in `receipt_errors`.

## Local AER-1 receipts (no network needed)

The package also mints AER-1 execution receipts locally, with no API calls. Pass `emit_aer1=True` to record every event as a verifiable receipt on your own machine:

```python
from crewai_zambo import ZamboCrewListener

listener = ZamboCrewListener(emit_aer1=True)
listener.on_task_completed("Summarize this task", "completed")

receipt = listener.last_local_receipt
print(receipt["id"], receipt["output_hash"])
```

Or mint receipts directly for any tool call:

```python
from crewai_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 CREWAI-ZAMBO`, naming this package as the recording system. They pass the same hash-recomputation check as any AER-1 receipt.

Project homepage: [https://zambo.dev](https://zambo.dev)
AER-1 receipt spec: [https://zambo.dev/aer-1/](https://zambo.dev/aer-1/)

## Guides

- [Execution Receipts for AI Agent Frameworks](https://zambo.dev/guides/framework-agent-execution-receipts/)
- [What Is an AI Agent Execution Receipt?](https://zambo.dev/guides/ai-agent-execution-receipt/)

## Where these receipts run live: Zambo

crewai-zambo publishes every CrewAI task event as a verifiable AER-1 receipt at zambo.dev, and it has been downloaded 5,308 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. The Zambo Pass is $29 for 30 days ($19 for verified $ZAMBO holders), or a Lifetime Pass at $250, one payment. Full pricing: https://zambo.dev/pricing

Install:

    pip install crewai-zambo
