Velaru SDK (Python) · v0.2.8

Governed attempts under frozen law — stranger-verifiable audit receipts in three lines. Official client for Velaru.

Install

pip install velaru-sdk

# Optional extras
pip install "velaru-sdk[all]"   # crypto + OpenAI middleware

Quickstart (3 lines)

from velaru import seal

receipt = seal("Bind policy DEMO-PAS-2026-001", domain="insurance")
print(receipt.verify_url)   # stranger verify — no login
print(receipt.permalink)    # permanent /r/{id} URL

Restraint Atom (bind-gate / carrier wedge)

from velaru import prove_restraint

proof = prove_restraint(
    "policy_bind",
    "Permit-before-bind: delegation limit exceeded",
    capability_proof={"bind_authority_limit_usd": 50_000},
)
print(proof["verify_url"])

Bind-payment twin (PDTR)

from velaru import bind_payment

twin = bind_payment("0xpayment_hash", decision_entry_id="ENTRY_ID")
print(twin["verify_url"])

LangChain callback

from langchain_openai import ChatOpenAI
from velaru import Velaru, VelaruCallbackHandler

handler = VelaruCallbackHandler(Velaru(api_key="YOUR_KEY"), domain="insurance")
llm = ChatOpenAI(model="gpt-4o-mini", callbacks=[handler])

Public try-it key: velaru_public_demo (sandbox, 10 req/min) — see /integrate.

MCP server (Cursor / Claude Desktop)

pip install "velaru-sdk[mcp]"
velaru-mcp

Tools: velaru_seal, velaru_prove_restraint, velaru_bind_payment, velaru_hero_demo, velaru_warm.
Cursor config: integrations/mcp/cursor-config.json in the repo.

Local verify (optional — advanced)

pip install "velaru-sdk[crypto]"

receipt = seal("hello", domain="hiring")
assert receipt.verify_local()

CLI

velaru seal "Skip the safety review" --domain hiring
velaru restraint --action "policy_bind" --reason "Delegation limit"
velaru public-key

OpenAI middleware

pip install "velaru-sdk[openai]"

from openai import OpenAI
from velaru import VelaruAuditedOpenAI

audited = VelaruAuditedOpenAI(OpenAI(), domain="hiring", api_key="YOUR_KEY")
result = audited.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello"}],
)
print(result.input_verify_url)

API surface

Links

• Integration guide
• Carrier hero demo
• Insurance wedge
• llms-full.txt
• PyPI

MIT © Nisaba LLC