Metadata-Version: 2.1
Name: zambo
Version: 1.0.10
Summary: Zambo: the verifiable work layer for AI, on the command line. A verifiable AER-1 receipt for every job, no API key.
Author: Brennan 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/docs
Project-URL: Receipt Test, https://muse.ai/s/the-receipt-test-uxk6ljxzgxyxn1xo
Keywords: mcp,ai,agents,tools,receipts,automation,llm
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# zambo: the verifiable work layer for AI, on your command line

**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/)**

**The problem:** AI models talk. Getting things *done*, checking a live price, auditing a site, running research, pulling data, means wiring up APIs, keys, and glue code for every single task.

**The fix:** one command. Describe the job, get it done, get a receipt.

```bash
pip install zambo
zambo "what's the price of BTC right now?"
```

```text
BTC $81,235.00 USD ...

receipt 89ccbddc-0b3b-4dbd-b424-4ee75119ef80
audit: https://zambo.dev/run/89ccbddc-0b3b-4dbd-b424-4ee75119ef80
verify: zambo verify 89ccbddc-0b3b-4dbd-b424-4ee75119ef80
```

No account. No API key. No config. Free tier included; limits vary by tool.

## Quickstart

```bash
# One-command: describe any goal
zambo "audit example.com for AI discoverability"

# Call a specific tool directly
zambo call live_price '{"symbol":"BTC"}'
zambo call ghost_audit_site '{"url":"https://example.com"}'

# Search the tool catalog
zambo search 'generate QR code'

# List exposed tools
zambo list

# Verify any receipt
zambo verify 89ccbddc-0b3b-4dbd-b424-4ee75119ef80

# Teach your agents about Zambo (writes to AGENTS.md / CLAUDE.md / .muserules)
zambo init
```

Or use it from Python:

```python
import zambo

out = zambo.call_tool("live_price", {"symbol": "BTC"})
print(out["text"], out["receipt"]["id"])

v = zambo.verify_receipt(out["receipt"]["id"])
print(v["verified"], v["sha256"])
```

## What Zambo is

[Zambo](https://zambo.dev) is the verifiable work layer for AI: tools behind one MCP endpoint (https://zambo.dev/mcp), over plain JSON-RPC. Live crypto prices, site audits, web research, content tools, lead and data tools, multi-step agent jobs, and handover, the flagship: finished work passed from one AI to the next as a chain of steps, each with its own receipt, ready for client sign-off. This package is a thin Python client for that endpoint (stdlib + `requests` only).

Don't know which tool fits? Skip the catalog: `zambo "<goal>"` routes through `zambo_universal`, which picks the right tools for the job. Pass `--session <id>` to keep a trail across calls.

## Receipts: proof the saved result was not changed

Every call returns a **verifiable receipt**: a UUID, a timestamp, and a **sha256 of the saved result**, in the AER-1 format (IETF Internet-Draft draft-zambo-aer1-26). Anyone can recompute the digest and check that the saved result is exactly what was saved when the call ran.

Honest scope: a receipt proves the saved result was not changed. It does not prove the answer was right. It fixes the record; judging the work stays with you.

Check any receipt in your browser or on the command line:

```bash
zambo verify <receipt-uuid>     # confirms zambo.dev serves the receipt,
                               # and shows sha256, source, timestamp, audit URL
```

Receipt pages are real web pages with Open Graph tags and canonical URLs, shareable, linkable, citable.

Try the [Receipt Test](https://muse.ai/s/the-receipt-test-uxk6ljxzgxyxn1xo): run a free call, get a receipt, verify it yourself.

## Free tier, honestly

- **Free:** 20 calls + 1 wrap-up free every day; picking up in another AI is always free. No account, no API key, no card.
- **Paid:** the $0.99 Day Pass (24h) at [zambo.dev/day-pass](https://zambo.dev/day-pass/): humans pay by card or PayPal, agents pay with USDC on Base via x402. The Zambo Pass is $29/mo or $290/yr ($19/mo for $ZAMBO holders). Never required for a first call.

No fake limits, no "contact sales to see a price."

## Commands

| Command | What it does |
|---|---|
| `zambo "<goal>" [--session <id>]` | Do the thing. Routes via `zambo_universal`. |
| `zambo call <tool> '<json>'` | Call one tool directly. |
| `zambo search '<query>'` | Search the tool catalog. |
| `zambo list` | List exposed tools with one-line descriptions. |
| `zambo verify <receipt-uuid>` | Verify a receipt on zambo.dev. |
| `zambo init [--root <dir>] [--file <name>] [--force]` | Write the Zambo section into your project's agent instruction file. |

## Requirements & troubleshooting

- Python 3.8 or newer. Only dependency: `requests`.
- The upstream endpoint occasionally resets connections; the client retries transient transport failures automatically (up to 4 attempts). A received JSON-RPC error is never retried; it's shown to you as-is.
- Timeouts: 60s per attempt.

## License

MIT: see LICENSE (included in the package). Built by [Zambo](https://zambo.dev) (Brennan Zambo, solo founder).

## Where these receipts run live: Zambo

The zambo CLI puts the live Zambo endpoint in your terminal, every call returning a verifiable AER-1 receipt, and it has been downloaded 3,991 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: 20 calls + 1 wrap-up free every day; picking up in another AI is always free. The Day Pass is $0.99 for 24 hours, unlimited.

Install:

    pip install zambo
