Skip to main content
Parmana Client. Main entry point for the Parmana Python SDK.

ParmanaClient Objects

Parmana SDK Client. Parmana ensures AI executes only policy-compliant actions.

Example

client = ParmanaClient( … endpoint=“http://localhost:3000”, … )
trust_record = client.execution.execute(transaction)
verification = client.verification.verify( … transaction.business_transaction_id, … )

__init__

Create a Parmana SDK client.

Raises

ConfigurationError: If endpoint is missing or empty. Mirrors typescript/src/client/ParmanaClient.ts’s identical fail-fast check. This client is synchronous only. There is no async variant.

Parameters

endpoint: Base URL of the Parmana Runtime. api_key: Caller bearer key, minted by scripts/generate-api-key.ts. Sent as Authorization: Bearer <api_key> on every request. Omit only against a Runtime started with PARMANA_AUTH_DISABLED=true (local development only); every other deployment rejects an unauthenticated request with a 401 before a Business Transaction is even constructed. See /api-reference/authentication. timeout: HTTP timeout in seconds, applied per request. max_retries: Retry attempts for idempotent (GET) requests that fail with a connection error or a 502/503/504 response. POST requests (execute, verify, receipt, replay) are never retried. backoff_factor: Exponential backoff factor between retries, in seconds. debug: Enable request/response debug logging on the “parmana” logger.

endpoint

Parmana Runtime endpoint.

version

Parmana SDK version.

health

Returns the Runtime health status.

execute

Execute a Business Transaction.

verify

Run a fresh verification of an Execution Trust Record, appending a new Verification to its history. Distinct from get_latest_verification(), which reads the most recent one without re-verifying.

get_latest_verification

Returns the latest Verification, without performing a fresh one.

create_transaction

Creates (executes) a Business Transaction via POST /transactions, a second, independent entry point into the identical execution pipeline as execute() (POST /execute).

transaction

Retrieves a Business Transaction.

trust_record

Retrieves an Execution Trust Record.

validate_policy

Validates that a policy (name + version) is loadable.

refusal_record

Retrieves a Refusal Record by Business Transaction ID.

verify_refusal_record

Verifies a Refusal Record’s signature.

verify_audit_event

Verifies a signed caller-authentication or Razorpay-webhook audit event’s signature.