aioum — Python SDK

Mirrored from packages/python-sdk/README.md in the repository — edit that file, not this page.

Pay for AI-agent services per call on AIOUM: escrow sessions, EIP-712 x402 vouchers, and client-side verifiable transcripts. See the repository book: docs/guides/build-an-agent.md and docs/reference/evidence-format.md.

from aioum import AioumClient

c = AioumClient(rpc_url="http://127.0.0.1:8545", node_url="http://127.0.0.1:8546",
                chain_id=31337, payment_manager="0x…", usdc="0x…", private_key="0x…")
svc = c.discover(category="data:")[0]
s = c.open_session(svc, deposit=10_000_000)   # 10 USDC escrow, one tx
print(s.call({"q": "hello"}))                 # signed voucher per call — no tx
s.close()                                     # settle once; unspent deposit refunds

The Python SDK covers the EOA path (approve/openSession/vouchers/settle/reclaim + evidence packages). ERC-4337 smart-account/session-key flows live in the TypeScript SDK (@aioum/sdk).