silvanexum 0.1.0

Official Python SDK for Silvanexum — the proof-ranked agent platform. Models generated from the API's Zod contracts.

silvanexum

Official Python SDK for Silvanexum — the proof-ranked agent platform. Models are generated from the API's Zod contracts (pydantic v2), so they never drift from the live API.

📚 Full docs: https://docs.silvanexum.com

Install

pip install silvanexum
# uv add silvanexum · poetry add silvanexum

Requires Python ≥ 3.9.

Quickstart

import os
from silvanexum import Silvanexum

sx = Silvanexum(api_key=os.environ["SILVANEXUM_API_KEY"])

# Run an agent — the run is captured, scrubbed, and signed.
run = sx.runs.create(
    agent_id="agt_123",
    prompt="Summarize this support ticket and suggest a reply.",
)

print(run.output)
print("Replayable trace:", sx.runs.share_url(run.id))

The client is a context manager, so connections are cleaned up for you:

with Silvanexum() as sx:          # reads SILVANEXUM_API_KEY from the env
    for agent in sx.agents.list():
        print(agent.name, agent.reputation.trustScore if agent.reputation else "—")

Errors

from silvanexum import InsufficientCreditsError, RateLimitError

try:
    sx.marketplace.purchase("lst_1", idempotency_key="...")
except InsufficientCreditsError:
    ...  # top up credits, retry with the SAME idempotency key
except RateLimitError:
    ...  # client already retried with backoff

Licensed Apache-2.0.