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
| Call | Description |
|---|---|
seal(msg, domain=...) |
One-line receipt |
prove_restraint(action, reason, ...) |
Restraint Atom |
bind_payment(payment_hash, ...) |
PDTR twin receipt |
VelaruCallbackHandler |
LangChain callback (alias of VelaruAuditHandler) |
Velaru().classify(...) |
Full classify |
receipt.verify_url |
Browser verify link |
receipt.permalink |
Permanent receipt URL |
Links
MIT © Nisaba LLC
Metadata
Release files for velaru-sdk 0.2.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| velaru_sdk-0.2.8.tar.gz | 20.5 kB | Without provenance | Details for velaru_sdk-0.2.8.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| velaru_sdk-0.2.8-py3-none-any.whl | Python 3 | none | any | Details for velaru_sdk-0.2.8-py3-none-any.whl |
Total release size: 42.5 kB
Release files / velaru_sdk-0.2.8.tar.gz
| Download URL | velaru_sdk-0.2.8.tar.gz |
|---|---|
| Size | 20.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d9588c5f67255f9a6c61557d7f33a97d769d56f5a6ee8fc49b8e41ada08fda1f
|
|
BLAKE2b-256 checksum How to use checksums |
8a0e361607cb6edd4dd821b0792c260e5a621ac0087416a62b8519cc5a99fc74
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / velaru_sdk-0.2.8-py3-none-any.whl
| Download URL | velaru_sdk-0.2.8-py3-none-any.whl |
|---|---|
| Size | 22.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a907aef53849e11e3e187e0274d8a2530d7238ac2275399ad6434763f11cbf10
|
|
BLAKE2b-256 checksum How to use checksums |
6754d295a729ebd45f2a15746ac210a3fd858be6fdaf35324ae9eebee03ed0a2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for velaru-sdk 0.2.8
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.