Exogram Python Client SDK

Official Python Client SDK for the Exogram Authority Runtime.

Evaluate action authorization before state changes, commit cryptographic execution tokens to the immutable audit ledger, and store/search records in the Exogram Encrypted Trust Vault.

Installation

pip install exogram

or using uv:

uv add exogram

Quickstart

Synchronous Usage

from exogram import Exogram

client = Exogram(token="exo_prod_your_api_key")

# 1. Evaluate authorization before state-changing operation
eval_res = client.evaluate(
    action_type="database_write",
    namespace="production",
    payload={"table": "users", "action": "update"}
)

if eval_res.allowed:
    print(f"Action Allowed! Execution Token: {eval_res.token}")
    
    # Perform database operation...
    
    # 2. Commit execution to audit trail
    client.commit(token=eval_res.token, status="success")
else:
    print(f"Action Blocked by Policy: {eval_res.policy_violation}")

Function Decorator (@client.governed)

from exogram import Exogram

client = Exogram(token="exo_prod_your_api_key")

@client.governed(action_type="user_deletion")
def delete_user(user_id: str):
    # This function automatically requests authorization from Exogram
    # before executing, and commits the execution token on completion!
    print(f"Deleting user {user_id}...")

delete_user("usr_123")

Asynchronous Usage (AsyncExogram)

import asyncio
from exogram import AsyncExogram

async def main():
    client = AsyncExogram(token="exo_prod_your_api_key")
    
    # Search encrypted trust vault
    results = await client.evaluate(action_type="api_call")
    print(results)

asyncio.run(main())

Environment Variables

License

MIT — see LICENSE for details.