epistemic-handshake 0.2.0

Governance middleware for AI agents. One line before every action.

Epistemic Handshake - Python SDK

Governance middleware for AI agents. One line before every action.

Install

pip install epistemic-handshake

Quick Start

from epistemic_handshake import EH

eh = EH(api_key="eh_xxx", policy_id="your-policy-id")

# One-line check
if eh.allow("Send refund of 350 pounds to customer"):
    send_refund()
else:
    print("Action blocked by policy")

Full Verification

result = eh.verify("Apply 25% discount to order #4521")

print(result.verdict)      # APPROVE, DENY, or ESCALATE
print(result.confidence)   # 0.0 - 1.0
print(result.reasoning)    # Why this verdict
print(result.approved)     # True/False
print(result.blocked)      # True if DENY or ESCALATE

Decorator

@eh.guard("Send email to {recipient}")
def send_email(recipient, body):
    # Only executes if EH approves
    smtp.send(recipient, body)

@eh.guard()  # Auto-generates intent from function name + args
def delete_user(user_id):
    db.delete(user_id)

Observe Mode

Start without blocking anything. See what EH would catch.

eh = EH(api_key="eh_xxx", policy_id="xxx", mode="observe")

# Everything passes, but violations are logged
result = eh.verify("Apply 50% discount")
# result.approved == True (observe mode)
# But logs: "[OBSERVE] Would have blocked: Apply 50% discount"

Environment Variables

export EH_API_KEY=eh_xxx
export EH_POLICY_ID=your-policy-id
# Optional:
export EH_API_URL=https://your-custom-deployment.com

# No args needed if env vars are set
from epistemic_handshake import EH
eh = EH()

Error Handling

eh = EH(
    api_key="eh_xxx",
    policy_id="xxx",
    on_error="escalate",  # If API is down: "escalate", "approve", or "deny"
)

With LangChain

from epistemic_handshake import EH
from langchain.tools import tool

eh = EH(api_key="eh_xxx", policy_id="xxx")

@tool
def send_refund(amount: float, customer_id: str) -> str:
    """Send a refund to a customer."""
    result = eh.verify(f"Send refund of {amount} pounds to customer {customer_id}")
    if result.blocked:
        return f"Action blocked: {result.reasoning}"
    # proceed with refund
    return f"Refund of {amount} sent to {customer_id}"

Free During Early Access

Sign up at epistemic-handshake-production.up.railway.app