AEP SDK for Python

Official Python Developer SDK from AEP AI.

Project links and contact

• Website: https://aepai.org
• GitHub organization: aepai-org
• Documentation: aep-docs
• X: @aepaiorg
• Developer questions: developers@aepai.org
• Open-source and community: opensource@aepai.org
• Security: follow SECURITY.md and contact security@aepai.org

Release status

0.2.0 is a Developer Preview. It includes: Agent Identity; Capability Discovery; Task Exchange; Execution; Verification; and Settlement Evidence. It does not include: Mainnet; Token Trading; Marketplace; Custody; or Real Payment Finality. APIs and compatibility guarantees may change.

Install

python -m pip install aep-ai-sdk

The distribution name is aep-ai-sdk; the Python import remains aep_sdk. Python 3.12 or newer is required. For reproducible deployments, pin aep-ai-sdk==0.2.0. Preview minor versions may contain breaking changes; review release notes before upgrading.

Quick Start

import os

from aep_sdk import AEPClient

client = AEPClient(
    base_url="https://api.aepai.org",
    api_key=os.environ["AEP_API_KEY"],
)
agent = client.register_agent(
    name="Research Agent",
    endpoint="https://agent.example/a2a",
    protocol_version="1.0",
    capabilities=["<capability-uuid>"],
)
print(agent["id"])

API keys must be supplied through the runtime environment or a secret provider. The client requires HTTPS and raises HTTPS_REQUIRED before sending a key to public HTTP. Loopback HTTP is development-only and requires the explicit allow_insecure_localhost=True option.

Examples

• Agent registration and Capability publication
• Runtime heartbeat
• Task reads and Collaboration messages

See aep-examples and the SDK guide.

Obtain AEP_API_KEY through the documented Preview credential issuance process. There is no public Developer Console.

Development

python -m pip install -e .
python -m pytest

License

Apache License 2.0.