Skip to main content

elizaOS ACP Plugin - Agentic Commerce Protocol for checkout and commerce

Project description

elizaos-plugin-acp

Python implementation of the ACP (Agentic Commerce Protocol) plugin for elizaOS.

Installation

pip install elizaos-plugin-acp

For development:

pip install -e ".[dev]"

Usage

import asyncio
from elizaos_plugin_acp import AcpClient, AcpClientConfig

async def main():
    # Create client from environment variables
    config = AcpClientConfig.from_env()
    client = AcpClient(config)
    
    # Create a checkout session
    session = await client.create_checkout_session({
        "currency": "USD",
        "line_items": [
            {
                "id": "item_123",
                "name": "Widget",
                "unit_amount": 1000,
                "quantity": 2
            }
        ],
        "buyer": {
            "email": "customer@example.com"
        }
    })
    
    print(f"Session ID: {session.id}")
    print(f"Status: {session.status}")
    print(f"Total: {session.totals}")

asyncio.run(main())

Environment Variables

  • ACP_MERCHANT_BASE_URL (required): Base URL of the merchant API
  • ACP_MERCHANT_API_KEY (optional): API key for authentication
  • ACP_REQUEST_TIMEOUT (optional): Request timeout in seconds (default: 30)
  • ACP_API_VERSION (optional): API version (default: 2026-01-30)

Running Tests

pytest

With coverage:

pytest --cov=elizaos_plugin_acp

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

elizaos_plugin_acp-2.0.0a4.tar.gz (19.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

elizaos_plugin_acp-2.0.0a4-py3-none-any.whl (23.4 kB view details)

Uploaded Python 3

File details

Details for the file elizaos_plugin_acp-2.0.0a4.tar.gz.

File metadata

  • Download URL: elizaos_plugin_acp-2.0.0a4.tar.gz
  • Upload date:
  • Size: 19.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for elizaos_plugin_acp-2.0.0a4.tar.gz
Algorithm Hash digest
SHA256 d01a7fc347786663dfcd725c672cc20e3fe5d1527ea372e65272a4015e443b7e
MD5 df631a714849a86ec8d094a4f3f8480a
BLAKE2b-256 fcca77b66847910131bb1d2a4ed4701e787637bc17da9a38416e8adf62ac63d7

See more details on using hashes here.

File details

Details for the file elizaos_plugin_acp-2.0.0a4-py3-none-any.whl.

File metadata

File hashes

Hashes for elizaos_plugin_acp-2.0.0a4-py3-none-any.whl
Algorithm Hash digest
SHA256 d1af5886937b7030d6951de8367710630d379c4d75feafeba08b27b0a71d3b81
MD5 5453a187cea0d92f3daedb4abc7514ce
BLAKE2b-256 b7b3a6c647eb64476452791463cda476d0e31fbd594106e013e8e4a46588cb62

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page