Arbiter Python SDK

Official Python client for the Arbiter Control Plane. Same governance semantics as @arbiterhq/sdk (Node): evaluate → allow | hold | deny.

Package: arbiter-sdk==0.1.0
Import: from arbiter import ArbiterRuntime

Install

pip install arbiter-sdk==0.1.0

Authority Connect (arbiter connect --apply) installs this package into Python projects after confirmation. When an on-disk package root is available (monorepo developer installs), Connect prefers an editable local install; otherwise it installs the public pip pin arbiter-sdk==0.1.0.

Publication note: prepare this wheel for PyPI before treating the public pip install path as live. Until publication, offline certification can use ARBITER_PYTHON_SDK_PIP_SPEC=/path/to/arbiter_sdk-0.1.0-py3-none-any.whl.

Quick start

from arbiter import ArbiterRuntime

runtime = ArbiterRuntime()  # ARBITER_API_KEY, ARBITER_BASE_URL, ARBITER_AGENT from env
result = runtime.evaluate("send_payment", amount=100)

if result.decision == "allow":
    ...
elif result.decision == "deny":
    ...
elif result.decision == "hold":
    # Approval HOLD has approval_request_id; Discovery HOLD requires human Adopt.
    ...

API surface

Environment variables (same as Node Connect):

• ARBITER_API_KEY
• ARBITER_BASE_URL (default https://api.arbitertrust.com)
• ARBITER_AGENT (required for workspace API keys)

Governance boundaries

Connect and this SDK never auto-Adopt Discovery resources or auto-Approve HOLD decisions.