modelcost-sdk 0.1.0__tar.gz

modelcost_sdk-0.1.0/.gitignore

@@ -0,0 +1,113 @@
+# OS
+.DS_Store
+
+# Environment
+.env*
+
+# Local dev config (contains secrets)
+server/src/main/resources/application-local.yml
+
+### Client (Next.js) ###
+client/node_modules/
+client/.next/
+client/out/
+client/.pnp
+client/.pnp.*
+client/.yarn/*
+!client/.yarn/patches
+!client/.yarn/plugins
+!client/.yarn/releases
+!client/.yarn/versions
+client/coverage/
+client/build/
+client/.vercel
+client/*.tsbuildinfo
+client/next-env.d.ts
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+### Server (Spring Boot / Maven) ###
+server/target/
+server/.mvn/wrapper/maven-wrapper.jar
+!server/**/src/main/**/target/
+!server/**/src/test/**/target/
+
+# IDE - Eclipse/STS
+server/.apt_generated
+server/.classpath
+server/.factorypath
+server/.project
+server/.settings
+server/.springBeans
+server/.sts4-cache
+
+# IDE - IntelliJ
+.idea/
+*.iws
+*.iml
+*.ipr
+
+# IDE - NetBeans
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+
+# IDE - VS Code
+.vscode/
+
+# Misc
+*.pem
+
+### SDK - Python ###
+sdk/python/.venv/
+sdk/python/venv/
+sdk/python/__pycache__/
+sdk/python/**/__pycache__/
+sdk/python/*.egg-info/
+sdk/python/src/*.egg-info/
+sdk/python/dist/
+sdk/python/build/
+sdk/python/.mypy_cache/
+sdk/python/.ruff_cache/
+sdk/python/.pytest_cache/
+sdk/python/htmlcov/
+sdk/python/.coverage
+
+### SDK - Node.js ###
+sdk/node/node_modules/
+sdk/node/dist/
+sdk/node/coverage/
+sdk/node/*.tsbuildinfo
+
+### SDK - Java ###
+sdk/java/target/
+sdk/java/.mvn/wrapper/maven-wrapper.jar
+!sdk/java/**/src/main/**/target/
+!sdk/java/**/src/test/**/target/
+
+### Marketing Site (Next.js) ###
+marketing-site/node_modules/
+marketing-site/.next/
+marketing-site/out/
+
+### Demo App ###
+demo/node_modules/
+demo/dist/
+
+### SDK Examples ###
+sdk-examples/node_modules/
+sdk-examples/dist/
+
+### Terraform ###
+infra/.terraform/
+infra/*.tfstate
+infra/*.tfstate.backup
+infra/.terraform.lock.hcl
+infra/terraform.tfvars
+infra/dev/.terraform/
+infra/dev/*.tfstate
+infra/dev/*.tfstate.backup
+infra/dev/.terraform.lock.hcl

modelcost_sdk-0.1.0/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to `modelcost` will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-03-01
+
+### Added
+- Initial alpha release
+- Cost tracking with automatic provider wrapping (OpenAI, Anthropic, Google)
+- Budget enforcement with configurable actions (alert, throttle, block)
+- PII detection scanning for SSN, email, phone, API keys, and credit cards
+- Token bucket rate limiting
+- Automatic background telemetry flushing
+- Sync and async client support
+- Full type annotations with PEP 561 marker

modelcost_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 ModelCost
+
+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.

modelcost_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: modelcost-sdk
+Version: 0.1.0
+Summary: Python SDK for the ModelCost API — track, govern, and optimize AI model spending.
+Project-URL: Homepage, https://modelcost.ai
+Project-URL: Documentation, https://modelcost.ai/docs
+Author-email: ModelCost <support@modelcost.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,budget,cost,governance,llm,tracking
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: respx; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ModelCost Python SDK
+
+Python SDK for the ModelCost API. Track, govern, and optimize your AI model spending in real time.
+
+## Installation
+
+```bash
+pip install modelcost
+```
+
+For development:
+
+```bash
+pip install modelcost[dev]
+```
+
+## Quick Start
+
+```python
+import modelcost
+
+# Initialize the SDK
+modelcost.init(api_key="mc_your_api_key", org_id="org_123")
+
+# Wrap your OpenAI client for automatic tracking
+import openai
+client = openai.OpenAI()
+wrapped = modelcost.wrap(client)
+
+# All calls are now tracked automatically
+response = wrapped.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+
+# Or track costs manually
+modelcost.track_cost(
+    provider="openai",
+    model="gpt-4o",
+    input_tokens=150,
+    output_tokens=50,
+    feature="chatbot",
+)
+
+# Check budget before expensive operations
+budget = modelcost.check_budget(feature="chatbot", estimated_cost=0.50)
+if not budget.allowed:
+    print(f"Budget exceeded: {budget.reason}")
+
+# Scan text for PII before sending to models
+result = modelcost.scan_pii("Contact me at test@example.com")
+if result.detected:
+    print(f"PII found: {result.entities}")
+
+# Get current usage summary
+usage = modelcost.get_usage()
+
+# Flush any buffered events and shut down
+modelcost.shutdown()
+```
+
+## Configuration
+
+You can configure the SDK via environment variables:
+
+| Variable | Description |
+|---|---|
+| `MODELCOST_API_KEY` | Your API key (must start with `mc_`) |
+| `MODELCOST_ORG_ID` | Your organization ID |
+| `MODELCOST_ENV` | Environment name (default: `production`) |
+| `MODELCOST_BASE_URL` | API base URL (default: `https://api.modelcost.ai`) |
+
+## License
+
+MIT

modelcost_sdk-0.1.0/README.md

@@ -0,0 +1,75 @@
+# ModelCost Python SDK
+
+Python SDK for the ModelCost API. Track, govern, and optimize your AI model spending in real time.
+
+## Installation
+
+```bash
+pip install modelcost
+```
+
+For development:
+
+```bash
+pip install modelcost[dev]
+```
+
+## Quick Start
+
+```python
+import modelcost
+
+# Initialize the SDK
+modelcost.init(api_key="mc_your_api_key", org_id="org_123")
+
+# Wrap your OpenAI client for automatic tracking
+import openai
+client = openai.OpenAI()
+wrapped = modelcost.wrap(client)
+
+# All calls are now tracked automatically
+response = wrapped.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Hello!"}],
+)
+
+# Or track costs manually
+modelcost.track_cost(
+    provider="openai",
+    model="gpt-4o",
+    input_tokens=150,
+    output_tokens=50,
+    feature="chatbot",
+)
+
+# Check budget before expensive operations
+budget = modelcost.check_budget(feature="chatbot", estimated_cost=0.50)
+if not budget.allowed:
+    print(f"Budget exceeded: {budget.reason}")
+
+# Scan text for PII before sending to models
+result = modelcost.scan_pii("Contact me at test@example.com")
+if result.detected:
+    print(f"PII found: {result.entities}")
+
+# Get current usage summary
+usage = modelcost.get_usage()
+
+# Flush any buffered events and shut down
+modelcost.shutdown()
+```
+
+## Configuration
+
+You can configure the SDK via environment variables:
+
+| Variable | Description |
+|---|---|
+| `MODELCOST_API_KEY` | Your API key (must start with `mc_`) |
+| `MODELCOST_ORG_ID` | Your organization ID |
+| `MODELCOST_ENV` | Environment name (default: `production`) |
+| `MODELCOST_BASE_URL` | API base URL (default: `https://api.modelcost.ai`) |
+
+## License
+
+MIT

modelcost_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,83 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "modelcost-sdk"
+version = "0.1.0"
+description = "Python SDK for the ModelCost API — track, govern, and optimize AI model spending."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "ModelCost", email = "support@modelcost.ai" },
+]
+keywords = ["ai", "llm", "cost", "tracking", "budget", "governance"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.27",
+    "pydantic>=2.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "pytest-asyncio",
+    "ruff",
+    "mypy",
+    "respx",
+]
+
+[project.urls]
+Homepage = "https://modelcost.ai"
+Documentation = "https://modelcost.ai/docs"
+
+[project.scripts]
+test = "pytest:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/modelcost"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-v"
+
+[tool.ruff]
+target-version = "py39"
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",    # pycodestyle errors
+    "W",    # pycodestyle warnings
+    "F",    # pyflakes
+    "I",    # isort
+    "UP",   # pyupgrade
+    "B",    # flake8-bugbear
+    "SIM",  # flake8-simplify
+    "TCH",  # flake8-type-checking
+]
+ignore = [
+    "E501",  # line too long (handled by formatter)
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["modelcost"]
+
+[tool.mypy]
+python_version = "3.9"
+strict = true
+warn_return_any = true
+warn_unused_configs = true