cortexhub 0.3.2

CortexHub Python SDK — Runtime governance for AI systems. One decorator, any tool, any framework.

CortexHub Python SDK

Runtime governance for AI systems. One decorator. Any tool. Any framework.

pip install cortexhub

Python 3.10–3.12.

Quick start

import cortexhub

cx = cortexhub.init("my-agent")  # or set CORTEXHUB_API_KEY

@cx.tool
def process_payment(customer_id: str, amount: str, reference: str) -> dict:
    """Process a payment."""
    return payment_service.charge(customer_id, amount, reference)

# Policies, approvals, and audit trail are configured in the control plane.

Configuration

Env var	Description
CORTEXHUB_API_KEY	API key (required for cloud enforcement)
CORTEXHUB_DEBUG	Set to 1 or true for readable SDK logs: tool + arguments, policy name + condition, and decision
CORTEXHUB_LOG_LEVEL	e.g. DEBUG, INFO (default INFO)

Debug logging

With CORTEXHUB_DEBUG=1 (or CORTEXHUB_DEBUG_POLICY=1), the SDK logs in real time:

• Tool encountered — tool name and argument names/values (values redacted when privacy mode is on)
• Policy evaluated — policy name, condition/reasoning, and decision (allow / deny / escalate)
• Decision — final effect, policy, and reason for the current tool call

Useful for seeing exactly what CortexHub is evaluating and why a tool was allowed, blocked, or sent for approval.

---

Documentation · Control plane · Examples