covenant-ai-sdk 0.1.0

Python SDK for Covenant AI — AI Agent Governance Gateway

Covenant AI Python SDK

Govern your AI agents in 3 lines of code.

Install

pip install covenant-ai

Quick Start

from covenant_ai import CovenantClient

covenant = CovenantClient(agent_name="MyBot")

# Check if an action is allowed
result = covenant.check("wire_transfer", {"amount": 50000})
if result.allowed:
    execute_transfer()
else:
    print(f"Blocked: {result.reason} (risk: {result.risk_score})")

Decorator Pattern

@covenant.govern("wire_transfer", extract={"amount": "amount"})
def send_wire(amount, recipient):
    bank.transfer(amount, recipient)

send_wire(50000, "Acme Corp")  # Checks Covenant first

Context Manager

with covenant.governance("deploy", {"service": "api", "env": "prod"}) as g:
    if g.allowed:
        deploy_service()
    elif g.pending:
        print("Awaiting approval...")

Configuration

covenant = CovenantClient(
    base_url="http://localhost:8000",  # API URL
    agent_name="MyBot",               # Auto-registers if needed
    demo_mode=True,                   # Use demo endpoints (default)
    raise_on_block=False,             # Raise on block
    timeout=10,                       # Request timeout (seconds)
)