Velaru SDK (Python) · v0.2.2

Tamper-evident AI audit receipts in three lines. Official client for Velaru.

Install

pip install velaru-sdk

# Recommended — local Ed25519 verify + OpenAI middleware
pip install "velaru-sdk[all]"

Quickstart (3 lines)

from velaru import seal

receipt = seal("your message", domain="hiring")
print(receipt.verify_url)   # open in browser — 12 green checks
print(receipt.permalink)    # permanent /r/{id} URL

Restraint Atom (one call — beats two-phase commit-reveal)

from velaru import prove_restraint

proof = prove_restraint(
    "financial.execute_trade",
    "Risk threshold exceeded",
    capability_proof={"permissions": ["trade.execute"]},
)
print(proof["verify_url"])

Local verify (no server round-trip)

pip install "velaru-sdk[crypto]"

receipt = seal("hello", domain="hiring")
assert receipt.verify_local()  # Ed25519 over entry_hash

CLI

pip install "velaru-sdk[crypto]"
velaru seal "Skip the safety review" --domain hiring
velaru restraint --action "trade.execute" --reason "Risk limit"
velaru public-key

OpenAI middleware (15-minute integration)

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
• Public verifier
• Procurement hub
• PyPI

MIT © Nisaba LLC