citadel-governance 0.2.0

AI Governance: Constitution + Audit for Agent Builders

Citadel Governance SDK for Python

AI governance for agent builders — one primitive to control, audit, and approve every action your agents take.

Installation

pip install citadel-governance

Quickstart (recommended import)

import citadel_governance as cg

cg.configure(
    base_url="https://ledger-sdk.fly.dev",
    api_key="your-api-key",
    actor_id="my-agent",
)

result = await cg.execute(
    action="email.send",
    resource="user:123",
    payload={"to": "[e-mail]", "subject": "Hello"},
)

if result.status == "executed":
    print("Sent!")
elif result.status == "pending_approval":
    print("Waiting for human review")
else:
    print(f"Blocked: {result.reason}")

Legacy import (deprecated)

import citadel  # deprecated — will be removed in v1.0

The citadel import path is kept for backward compatibility but emits a DeprecationWarning. Please migrate to citadel_governance.

Decorator

import citadel_governance as cg

cg.configure(...)

@cg.guard(action="stripe.refund", resource="charge:{charge_id}")
async def refund(charge_id: str, amount: int):
    return stripe.refund.create(charge=charge_id, amount=amount)

Context manager

async with cg.CitadelClient(base_url="https://ledger-sdk.fly.dev") as client:
    result = await client.execute(action="db.write", resource="users")

Dashboard

Monitor all agent activity, approve requests, and manage policies at: https://casss20-ledger-sdk-6nlu.vercel.app

License

MIT