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)

OpenAI middleware (15-minute integration)

Wrap your existing OpenAI client — every completion gets Velaru signed receipts:

pip install "velaru-sdk[openai]"

from openai import OpenAI
from velaru import VelaruAuditedOpenAI

audited = VelaruAuditedOpenAI(
    OpenAI(),
    domain="hiring",
    api_key="YOUR_VELARU_KEY",
    session_id="prod-customer-123",
)

result = audited.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": user_message}],
)

print(result.text)
print(result.input_verify_url)   # permanent receipt URL
print(result.output_verify_url)  # assistant reply receipt (if audit_output=True)

Blocked inputs raise VelaruBlockedError with the receipt attached — verify at /verify without trusting Velaru.

See examples/openai_audited_chat.py in the repo.

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