agentbill-py-sdk 1.0.0__tar.gz

agentbill_py_sdk-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AgentBill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agentbill_py_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,270 @@
+Metadata-Version: 2.4
+Name: agentbill-py-sdk
+Version: 1.0.0
+Summary: OpenTelemetry-based SDK for tracking and billing AI agent usage
+Home-page: https://github.com/Agent-Bill/python
+Author: AgentBill
+Author-email: AgentBill Team <support@agentbill.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Agent-Bill/python
+Project-URL: Documentation, https://github.com/Agent-Bill/python#readme
+Project-URL: Repository, https://github.com/Agent-Bill/python.git
+Project-URL: Issues, https://github.com/Agent-Bill/python/issues
+Keywords: ai,billing,tracking,opentelemetry,llm,agents
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: pylint>=2.17.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# AgentBill Python SDK
+
+OpenTelemetry-based SDK for automatically tracking and billing AI agent usage.
+
+## Installation
+
+### From GitHub (Recommended)
+```bash
+pip install git+https://github.com/Agent-Bill/python.git
+```
+
+### From PyPI (Coming Soon)
+```bash
+pip install agentbill
+```
+
+### From Source
+```bash
+git clone https://github.com/Agent-Bill/python.git
+cd python
+pip install -e .
+```
+
+## File Structure
+
+```
+agentbill-python/
+├── agentbill/
+│   ├── __init__.py
+│   ├── client.py
+│   ├── tracer.py
+│   └── types.py
+├── examples/
+│   ├── openai_basic.py
+│   ├── anthropic_basic.py
+│   ├── bedrock_basic.py
+│   ├── azure_openai_basic.py
+│   ├── mistral_basic.py
+│   └── google_ai_basic.py
+├── tests/
+│   ├── test_agentbill.py
+│   └── test_tracer.py
+├── README.md
+├── setup.py
+├── pyproject.toml
+├── pytest.ini
+├── Makefile
+├── CHANGELOG.md
+├── CONTRIBUTING.md
+├── SECURITY.md
+└── LICENSE
+```
+
+## Quick Start
+
+```python
+from agentbill import AgentBill
+import openai
+
+# Initialize AgentBill
+agentbill = AgentBill.init({
+    "api_key": "your-api-key",
+    "customer_id": "customer-123",
+    "debug": True
+})
+
+# Wrap your OpenAI client
+client = agentbill.wrap_openai(openai.OpenAI(
+    api_key="sk-..."
+))
+
+# Use normally - all calls are automatically tracked!
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+## Features
+
+- ✅ Zero-config instrumentation
+- ✅ Accurate token & cost tracking
+- ✅ Multi-provider support (OpenAI, Anthropic, Bedrock, Azure OpenAI, Mistral, Google AI)
+- ✅ Rich metadata capture
+- ✅ OpenTelemetry-based
+
+## Supported Providers
+
+- **OpenAI** - GPT-4, GPT-5, Embeddings, DALL-E, Whisper, TTS
+- **Anthropic** - Claude Sonnet, Claude Opus
+- **AWS Bedrock** - Claude, Titan, and other Bedrock models
+- **Azure OpenAI** - GPT models via Azure
+- **Mistral AI** - Mistral models
+- **Google AI** - Gemini Pro, Gemini Flash
+
+## Provider Examples
+
+### OpenAI
+```python
+from agentbill import AgentBill
+import openai
+
+agentbill = AgentBill.init({"api_key": "your-api-key"})
+client = agentbill.wrap_openai(openai.OpenAI(api_key="sk-..."))
+
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### Anthropic
+```python
+from agentbill import AgentBill
+import anthropic
+
+agentbill = AgentBill.init({"api_key": "your-api-key"})
+client = agentbill.wrap_anthropic(anthropic.Anthropic(api_key="sk-ant-..."))
+
+response = client.messages.create(
+    model="claude-sonnet-4-20250514",
+    max_tokens=1024,
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### AWS Bedrock
+```python
+from agentbill import AgentBill
+import boto3
+
+agentbill = AgentBill.init({"api_key": "your-api-key"})
+bedrock = agentbill.wrap_bedrock(boto3.client('bedrock-runtime'))
+
+response = bedrock.invoke_model(
+    modelId='anthropic.claude-v2',
+    body=json.dumps({
+        "prompt": "Hello!",
+        "max_tokens_to_sample": 300
+    })
+)
+```
+
+### Azure OpenAI
+```python
+from agentbill import AgentBill
+from openai import AzureOpenAI
+
+agentbill = AgentBill.init({"api_key": "your-api-key"})
+client = agentbill.wrap_azure_openai(AzureOpenAI(
+    api_key="your-azure-key",
+    api_version="2024-02-01",
+    azure_endpoint="https://your-resource.openai.azure.com"
+))
+
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### Mistral AI
+```python
+from agentbill import AgentBill
+from mistralai import Mistral
+
+agentbill = AgentBill.init({"api_key": "your-api-key"})
+client = agentbill.wrap_mistral(Mistral(api_key="your-mistral-key"))
+
+response = client.chat.complete(
+    model="mistral-large-latest",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### Google AI (Gemini)
+```python
+from agentbill import AgentBill
+import google.generativeai as genai
+
+agentbill = AgentBill.init({"api_key": "your-api-key"})
+genai.configure(api_key="your-google-key")
+model = genai.GenerativeModel('gemini-pro')
+wrapped_model = agentbill.wrap_google_ai(model)
+
+response = wrapped_model.generate_content("Hello!")
+```
+
+## Configuration
+
+```python
+config = {
+    "api_key": "your-api-key",        # Required
+    "base_url": "https://...",         # Optional
+    "customer_id": "customer-123",     # Optional
+    "debug": True                       # Optional
+}
+
+agentbill = AgentBill.init(config)
+```
+
+## Publishing to PyPI
+
+### Prerequisites
+1. Create a PyPI account at https://pypi.org/account/register/
+2. Generate an API token at https://pypi.org/manage/account/token/
+3. Create `~/.pypirc` file with your token:
+```ini
+[pypi]
+username = __token__
+password = pypi-YOUR_API_TOKEN_HERE
+```
+
+### Publishing Steps
+```bash
+# Build the package
+python setup.py sdist bdist_wheel
+
+# Upload to PyPI
+pip install twine
+twine upload dist/*
+```
+
+## GitHub Repository Setup
+
+1. Create repository: `https://github.com/Agent-Bill/python`
+2. Push all files (agentbill/, examples/, LICENSE, setup.py, README.md)
+3. Tag releases: `git tag v1.0.0 && git push origin v1.0.0`
+4. Users can install with: `pip install git+https://github.com/Agent-Bill/python.git`
+
+## License
+
+MIT

agentbill_py_sdk-1.0.0/README.md

@@ -0,0 +1,233 @@
+# AgentBill Python SDK
+
+OpenTelemetry-based SDK for automatically tracking and billing AI agent usage.
+
+## Installation
+
+### From GitHub (Recommended)
+```bash
+pip install git+https://github.com/Agent-Bill/python.git
+```
+
+### From PyPI (Coming Soon)
+```bash
+pip install agentbill
+```
+
+### From Source
+```bash
+git clone https://github.com/Agent-Bill/python.git
+cd python
+pip install -e .
+```
+
+## File Structure
+
+```
+agentbill-python/
+├── agentbill/
+│   ├── __init__.py
+│   ├── client.py
+│   ├── tracer.py
+│   └── types.py
+├── examples/
+│   ├── openai_basic.py
+│   ├── anthropic_basic.py
+│   ├── bedrock_basic.py
+│   ├── azure_openai_basic.py
+│   ├── mistral_basic.py
+│   └── google_ai_basic.py
+├── tests/
+│   ├── test_agentbill.py
+│   └── test_tracer.py
+├── README.md
+├── setup.py
+├── pyproject.toml
+├── pytest.ini
+├── Makefile
+├── CHANGELOG.md
+├── CONTRIBUTING.md
+├── SECURITY.md
+└── LICENSE
+```
+
+## Quick Start
+
+```python
+from agentbill import AgentBill
+import openai
+
+# Initialize AgentBill
+agentbill = AgentBill.init({
+    "api_key": "your-api-key",
+    "customer_id": "customer-123",
+    "debug": True
+})
+
+# Wrap your OpenAI client
+client = agentbill.wrap_openai(openai.OpenAI(
+    api_key="sk-..."
+))
+
+# Use normally - all calls are automatically tracked!
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+## Features
+
+- ✅ Zero-config instrumentation
+- ✅ Accurate token & cost tracking
+- ✅ Multi-provider support (OpenAI, Anthropic, Bedrock, Azure OpenAI, Mistral, Google AI)
+- ✅ Rich metadata capture
+- ✅ OpenTelemetry-based
+
+## Supported Providers
+
+- **OpenAI** - GPT-4, GPT-5, Embeddings, DALL-E, Whisper, TTS
+- **Anthropic** - Claude Sonnet, Claude Opus
+- **AWS Bedrock** - Claude, Titan, and other Bedrock models
+- **Azure OpenAI** - GPT models via Azure
+- **Mistral AI** - Mistral models
+- **Google AI** - Gemini Pro, Gemini Flash
+
+## Provider Examples
+
+### OpenAI
+```python
+from agentbill import AgentBill
+import openai
+
+agentbill = AgentBill.init({"api_key": "your-api-key"})
+client = agentbill.wrap_openai(openai.OpenAI(api_key="sk-..."))
+
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### Anthropic
+```python
+from agentbill import AgentBill
+import anthropic
+
+agentbill = AgentBill.init({"api_key": "your-api-key"})
+client = agentbill.wrap_anthropic(anthropic.Anthropic(api_key="sk-ant-..."))
+
+response = client.messages.create(
+    model="claude-sonnet-4-20250514",
+    max_tokens=1024,
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### AWS Bedrock
+```python
+from agentbill import AgentBill
+import boto3
+
+agentbill = AgentBill.init({"api_key": "your-api-key"})
+bedrock = agentbill.wrap_bedrock(boto3.client('bedrock-runtime'))
+
+response = bedrock.invoke_model(
+    modelId='anthropic.claude-v2',
+    body=json.dumps({
+        "prompt": "Hello!",
+        "max_tokens_to_sample": 300
+    })
+)
+```
+
+### Azure OpenAI
+```python
+from agentbill import AgentBill
+from openai import AzureOpenAI
+
+agentbill = AgentBill.init({"api_key": "your-api-key"})
+client = agentbill.wrap_azure_openai(AzureOpenAI(
+    api_key="your-azure-key",
+    api_version="2024-02-01",
+    azure_endpoint="https://your-resource.openai.azure.com"
+))
+
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### Mistral AI
+```python
+from agentbill import AgentBill
+from mistralai import Mistral
+
+agentbill = AgentBill.init({"api_key": "your-api-key"})
+client = agentbill.wrap_mistral(Mistral(api_key="your-mistral-key"))
+
+response = client.chat.complete(
+    model="mistral-large-latest",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### Google AI (Gemini)
+```python
+from agentbill import AgentBill
+import google.generativeai as genai
+
+agentbill = AgentBill.init({"api_key": "your-api-key"})
+genai.configure(api_key="your-google-key")
+model = genai.GenerativeModel('gemini-pro')
+wrapped_model = agentbill.wrap_google_ai(model)
+
+response = wrapped_model.generate_content("Hello!")
+```
+
+## Configuration
+
+```python
+config = {
+    "api_key": "your-api-key",        # Required
+    "base_url": "https://...",         # Optional
+    "customer_id": "customer-123",     # Optional
+    "debug": True                       # Optional
+}
+
+agentbill = AgentBill.init(config)
+```
+
+## Publishing to PyPI
+
+### Prerequisites
+1. Create a PyPI account at https://pypi.org/account/register/
+2. Generate an API token at https://pypi.org/manage/account/token/
+3. Create `~/.pypirc` file with your token:
+```ini
+[pypi]
+username = __token__
+password = pypi-YOUR_API_TOKEN_HERE
+```
+
+### Publishing Steps
+```bash
+# Build the package
+python setup.py sdist bdist_wheel
+
+# Upload to PyPI
+pip install twine
+twine upload dist/*
+```
+
+## GitHub Repository Setup
+
+1. Create repository: `https://github.com/Agent-Bill/python`
+2. Push all files (agentbill/, examples/, LICENSE, setup.py, README.md)
+3. Tag releases: `git tag v1.0.0 && git push origin v1.0.0`
+4. Users can install with: `pip install git+https://github.com/Agent-Bill/python.git`
+
+## License
+
+MIT

agentbill_py_sdk-1.0.0/agentbill/__init__.py

@@ -0,0 +1,11 @@
+"""
+AgentBill Python SDK
+OpenTelemetry-based SDK for tracking AI agent usage and billing
+"""
+
+from .client import AgentBill
+from .tracer import AgentBillTracer
+from .types import AgentBillConfig, TraceContext
+
+__version__ = "1.0.0"
+__all__ = ["AgentBill", "AgentBillTracer", "AgentBillConfig", "TraceContext"]