paid-python
Decision gist · record as of 2026-08-14
Yes, if you are building a monetized or multi-tenant AI agent platform and need integrated billing and cost tracking. The low install friction, active maintenance, and automatic instrumentation of major AI providers make it a practical choice. However, verify the license terms before committing to production use, and confirm that the 18 runtime dependencies align with your environment's constraints and update cadence.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later (up to 3.13).
- API key from Paid dashboard must be set via token parameter or PAID_API_KEY environment variable.
- Low install friction with a pure-Python wheel.
License · maintenance · safety
(unclear) — License status is unclear; neither SPDX nor raw license metadata is available. Verify the actual license terms in the repository before adopting this package in a commercial or restricted-license project.
last release 2026-07-07 (38 days) · last repo commit 2026-07-07 · 7 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 80,636 downloads/mo, #14,279 on PyPI
Alternatives
Verify before relying
pip install paid-python
from paid import Paid
from paid.tracing import initialize_tracing, paid_autoinstrument, paid_tracing
initialize_tracing()
paid_autoinstrument()
client = Paid(token="API_KEY")
@paid_tracing("customer_id")
def my_agent():
response = client.customers.create_customer(name="John Doe")
return response- Whether the package's 18 runtime dependencies (particularly the openinference and opentelemetry instrumentation libraries) are all actively maintained and compatible with current AI provider SDK versions.
- Actual license terms and any commercial usage restrictions not declared in package metadata.
- Whether the default OpenTelemetry collector endpoint (collector.agentpaid.io) requires additional configuration or authentication in production environments.
What it is and what it does
Paid is a Python client library for the Paid API, designed to handle billing, subscriptions, pricing, and cost tracking for AI agent applications. It provides a straightforward REST client interface for managing customers and subscriptions, plus an optional OpenTelemetry tracing layer that automatically instruments calls to major AI providers (OpenAI, Anthropic, Bedrock, Cohere, Google GenAI, and others) to capture and report usage costs.
The package is built around two main workflows: direct API calls for customer and subscription management, and decorator-based or context-manager-based cost tracking that wraps your agent logic. It pulls in a large set of instrumentation libraries as dependencies—one for each supported AI provider—which means you get automatic tracing integration without writing wrapper code. Configuration is handled via environment variables or constructor parameters, and the library gracefully falls back to normal execution if tracing fails.
Use it for
- Track AI API costs in real time for multi-tenant SaaS applications serving AI agents, attributing usage to specific customers.
- Implement usage-based billing for agent workflows by wrapping agent functions with @paid_tracing and querying traces by customer metadata.
- Monitor and cap spending on AI provider calls (OpenAI, Anthropic, etc.) by collecting cost telemetry through OpenTelemetry without modifying provider SDK calls.
- Build a customer management and subscription renewal system for AI agent products using the Paid API client.
- Route cost traces to a custom OpenTelemetry collector endpoint for integration with existing observability infrastructure.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a monetized or multi-tenant AI agent platform and need integrated billing and cost tracking.
The low install friction, active maintenance, and automatic instrumentation of major AI providers make it a practical choice. However, verify the license terms before committing to production use, and confirm that the 18 runtime dependencies align with your environment's constraints and update cadence.
Install
paid-python on PyPI
Before you install
Low install friction with a pure-Python wheel. Active maintenance with a recent release (38 days ago). Depends on 18 runtime packages including OpenTelemetry, Pydantic, and instrumentation libraries for multiple AI providers—a substantial but standard dependency tree for an integration SDK.
Requires Python 3.10 or later (up to 3.13). API key from Paid dashboard must be set via token parameter or PAID_API_KEY environment variable.
License in practice
License status is unclear; neither SPDX nor raw license metadata is available. Verify the actual license terms in the repository before adopting this package in a commercial or restricted-license project.
Quickstart
pip install paid-python
from paid import Paid
from paid.tracing import initialize_tracing, paid_autoinstrument, paid_tracing
initialize_tracing()
paid_autoinstrument()
client = Paid(token="API_KEY")
@paid_tracing("customer_id")
def my_agent():
response = client.customers.create_customer(name="John Doe")
return responseVerify before relying
- Whether the package's 18 runtime dependencies (particularly the openinference and opentelemetry instrumentation libraries) are all actively maintained and compatible with current AI provider SDK versions.
- Actual license terms and any commercial usage restrictions not declared in package metadata.
- Whether the default OpenTelemetry collector endpoint (collector.agentpaid.io) requires additional configuration or authentication in production environments.
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release <3.14,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 18 packageshttpxmutagenopeninference-instrumentation-anthropicopeninference-instrumentation-bedrockopeninference-instrumentation-claude-agent-sdkopeninference-instrumentation-google-genaiopeninference-instrumentation-instructoropeninference-instrumentation-langchainopeninference-instrumentation-openaiopeninference-instrumentation-openai-agentsopentelemetry-apiopentelemetry-exporter-otlp-proto-httpopentelemetry-instrumentation-cohereopentelemetry-sdkpydanticpydantic-coretyping_extensionswrapt |
| Maintenance | Actively maintained 38 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 80,636 / month, #14,279 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersOperating System :: MacOSOperating System :: Microsoft :: WindowsOperating System :: OS IndependentOperating System :: POSIXOperating System :: POSIX :: LinuxProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Topic :: Software Development :: Libraries :: Python ModulesTyping :: Typed |
Evidence: paid_python-1.11.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “AI agent billing SDK”
- paid-pythonPaid is a Python SDK for integrating billing, subscriptions, and cost…
- cursor-sdkPython SDK for scripting Cursor agents with sync and async clients,…
- openmeterOpenMeter Python SDK provides a client library to ingest usage events…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also openinference-instrumentation-openai-agents · mlflow · opentelemetry-instrumentation-openai-agents · promptlayer · openinference-instrumentation-openai · opentelemetry-instrumentation-openai · mlflow-tracing · opentelemetry-instrumentation-openai-agents-v2 · openinference-instrumentation-pydantic-ai · opentelemetry-instrumentation-agno