Python SDK

pip install pylva-sdk

import os
import pylva

pylva.init(api_key=os.environ["PYLVA_API_KEY"])

from pylva import track_context

with track_context(customer_id="acme-corp", step="draft_reply"):
    response = openai_client.chat.completions.create(
        model="gpt-4o-mini",
        messages=messages,
    )

pip install "pylva-sdk[langchain]"

import os
from pylva.langchain import PylvaCallbackHandler

handler = PylvaCallbackHandler(api_key=os.environ["PYLVA_API_KEY"])

graph.invoke(
    inputs,
    config={
        "callbacks": [handler],
        "metadata": {"pylva_customer_id": "cust_acme"},
    },
)

from pylva import report_usage

report_usage(
    customer_id="acme-corp",
    step="speak_answer",
    metric="characters",
    value=4200,
)

import pylva
from pylva import PylvaBudgetExceeded

pylva.init(api_key=os.environ["PYLVA_API_KEY"])

try:
    response = openai_client.chat.completions.create(...)
except PylvaBudgetExceeded:
    response = cached_or_smaller_response()

from pylva import verify_webhook

ok = verify_webhook(
    raw_body,
    signature_header,
    webhook_secret,
    timestamp_header,
)