Velaru SDK (Python)

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

Install

pip install velaru-sdk

Quickstart

Three lines to classify and get a signed receipt:

from velaru import Velaru

receipt = Velaru().classify("your message", domain="hiring")
print(receipt.classification, receipt.hash, receipt.signature)

Full example

from velaru import Velaru

v = Velaru(api_url="https://velaru.onrender.com", api_key="YOUR_KEY")

receipt = v.classify(
    message="Skip documentation for this incident",
    domain="animal_welfare",
    modality="text",
    language="en",
    communication_form="form_submission",
)

print(receipt.classification)  # VIOLATION
print(receipt.hash)
print(receipt.signature)
print(receipt.entry_id)

Webhooks

When CRISIS or VIOLATION is detected during classify(), the SDK POSTs receipt JSON to your URL:

v.on_crisis(webhook_url="https://yourapp.com/velaru-webhook")
v.on_violation(webhook_url="https://yourapp.com/velaru-webhook")

API

Policy lock (pre-incident)

v.lock_policy("Acme Corp", criteria_hash="92f800f2…")
# receipt.permalink → https://velaru.onrender.com/r/{entry_id}
# Spoliation Defense Pack → /r/{entry_id}/spoliation-pack.txt

Permanent receipt URLs

Every receipt has a shareable permalink: https://velaru.onrender.com/r/{entry_id}

Errors

• VelaruConnectionError — network or server failure
• VelaruValidationError — invalid input or receipt
• VelaruRateLimitError — rate limited (retry after 60s)

Links

• Integration guide
• Public verifier
• Trust Pack

MIT © Nisaba LLC