# Pylva

> Cost infrastructure for AI agent businesses.

## Docs

- [Sync budget accumulators](https://docs.pylva.com/api/budget-sync.md): Reconcile SDK-side budget accumulators against backend-authoritative totals so budget hard stops stay consistent across replicas.
- [Manage custom pricing](https://docs.pylva.com/api/custom-pricing.md): List and mutate custom pricing rows for LLM and non-LLM usage.
- [Create custom pricing](https://docs.pylva.com/api/custom-pricing-create.md): Create a custom pricing row for an LLM model or non-LLM metric.
- [Delete custom pricing](https://docs.pylva.com/api/custom-pricing-delete.md): Delete an existing custom pricing row.
- [List custom pricing](https://docs.pylva.com/api/custom-pricing-list.md): List current custom pricing rows for LLM and non-LLM usage.
- [Update custom pricing](https://docs.pylva.com/api/custom-pricing-update.md): Update mutable fields on an existing custom pricing row.
- [Submit telemetry events](https://docs.pylva.com/api/events.md): Send batched cost telemetry from a Pylva SDK runtime with customer context, model usage, latency, and pricing-safe metadata.
- [Pylva API Overview](https://docs.pylva.com/api/overview.md): Understand Pylva's SDK-facing API surface, authentication model, telemetry ingest endpoints, pricing APIs, and budget sync flow.
- [Billing and Pricing](https://docs.pylva.com/concepts/billing-and-pricing.md): Understand server-side pricing, custom rates, customer usage, invoices, and portal links.
- [AI Cost Attribution Concepts](https://docs.pylva.com/concepts/cost-attribution.md): Design stable customer and agent-step identifiers so Pylva cost reports map spend to accounts, workflows, and margin decisions.
- [Pylva Privacy and PII Controls](https://docs.pylva.com/concepts/privacy-and-pii.md): Send cost-shaped telemetry without prompts, completions, raw messages, personal data, API keys, or raw tool arguments.
- [Rules and Controls](https://docs.pylva.com/concepts/rules-and-controls.md): Understand Pylva rules for budgets, routing, throttles, failover, and recommendations.
- [Pylva Cost Infrastructure Docs](https://docs.pylva.com/index.md): Install Pylva, attribute AI cost by customer and agent step, enforce budget controls, and bill from trusted usage data.
- [Pylva SDK Quickstart](https://docs.pylva.com/quickstart.md): Install the TypeScript or Python SDK, create an Agent SDK key, attach customer context, and send your first cost event safely.
- [Budget Enforcement](https://docs.pylva.com/sdks/budget-enforcement.md): Use SDK-side budget rules to warn or block calls before customer spend runs away.
- [LangGraph Cost Tracking](https://docs.pylva.com/sdks/langgraph.md): Track token cost per LangGraph node, run, and customer with the Pylva LangChain callback handler.
- [Non-LLM Usage](https://docs.pylva.com/sdks/non-llm-usage.md): Track search, speech, vector database, workflow, and other non-LLM costs beside model spend.
- [Python SDK](https://docs.pylva.com/sdks/python.md): Install and operate the Pylva Python SDK for Python agent runtimes.
- [TypeScript SDK](https://docs.pylva.com/sdks/typescript.md): Install and operate the Pylva TypeScript SDK for Node.js agent runtimes.