Metadata-Version: 2.4
Name: langchain-zambo
Version: 0.1.0
Summary: LangChain callbacks that publish verifiable AI agent receipts to zambo.dev
Author: Zambo
License: MIT
Project-URL: Homepage, https://zambo.dev
Project-URL: Documentation, https://zambo.dev/integrations/langchain-receipts/
Keywords: langchain,ai agent receipt,verifiable receipt,observability,mcp
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# langchain-zambo

Publish LangChain lifecycle events as public, verifiable receipts at [zambo.dev](https://zambo.dev).

## Install

```bash
pip install langchain-zambo
```

## Ten-line example

```python
from langchain_zambo import ZamboCallbackHandler
from langchain_openai import ChatOpenAI

handler = ZamboCallbackHandler()
llm = ChatOpenAI(callbacks=[handler])
llm.invoke("Summarize this task")
print(handler.last_receipt_url)
```

The callback prints each public `https://zambo.dev/run/{id}` URL and keeps the most recent URL in `last_receipt_url`. It records LLM, tool, and chain lifecycle events through the live Zambo MCP endpoint. 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` when using a compatible Zambo host. Callback failures are available in `receipt_errors` and do not replace the original LangChain result.

Project homepage: [https://zambo.dev](https://zambo.dev)
