Metadata-Version: 2.4
Name: axiomax-esg-sdk
Version: 1.0.0
Summary: Official client SDK for AXIOMAX ESG Carbon Shield. Cryptographically attest your AI inference workload carbon footprint with one line of code. Patent Pending USPTO 64/081,419.
Author-email: Charles Santana <charles@axiomaxllc.com>
License: MIT
Project-URL: Homepage, https://axiomaxllc.com
Project-URL: Repository, https://github.com/axiomaxllc/esg-carbon-shield
Project-URL: Issues, https://github.com/axiomaxllc/esg-carbon-shield/issues
Project-URL: Hosted Verifier, https://verify.axiomaxllc.com
Keywords: esg,climate-tech,carbon-accounting,cryptography,ai,openai,anthropic,azure-openai,aws-bedrock,sustainability,csrd,sec-climate
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31
Requires-Dist: cryptography>=41.0
Dynamic: license-file

# axiomax-esg-sdk

Official client SDK for [AXIOMAX ESG Carbon Shield](https://axiomaxllc.com). Cryptographically attest your AI inference workload carbon footprint with one line of code.

> Patent Pending USPTO Application **64/081,419** (filed June 3, 2026).
> Operated by **AXIOMAX LLC**, Salinas, Puerto Rico.

## Install

```bash
pip install axiomax-esg-sdk
```

## Quick start with OpenAI

```python
from axiomax_esg_sdk import AxiomaxClient, wrap_openai
import openai

axe = AxiomaxClient(license_key="axe_lic_2026_acme_...")

# One-line wrap — every chat completion now cryptographically attested
client = wrap_openai(openai.OpenAI(api_key="..."), axe)

# Use OpenAI normally
response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "hello"}],
)

# Periodically issue a signed token from accumulated records
token = axe.issue_token()
print(token["signature_ed25519"])
```

## Quick start with Anthropic Claude

```python
from axiomax_esg_sdk import AxiomaxClient, wrap_anthropic
import anthropic

axe = AxiomaxClient(license_key="axe_lic_...")
client = wrap_anthropic(anthropic.Anthropic(api_key="..."), axe)

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[{"role": "user", "content": "hello"}],
)
```

## Quick start with AWS Bedrock

```python
import boto3
from axiomax_esg_sdk import AxiomaxClient, wrap_bedrock

axe = AxiomaxClient(license_key="axe_lic_...")
bedrock = wrap_bedrock(boto3.client("bedrock-runtime"), axe)

# every invoke_model is now attested (duration only — parse body for token counts)
response = bedrock.invoke_model(modelId="anthropic.claude-3-sonnet-20240229-v1:0", body=...)
```

## Manual recording (any provider)

```python
from axiomax_esg_sdk import AxiomaxClient

axe = AxiomaxClient(license_key="axe_lic_...", soc_profile="apple_m4_pro", region="us_east")

# After your inference completes, record metrics:
axe.record_inference(
    model_id="gpt-4",
    tokens_in=120,
    tokens_out=340,
    duration_ms=1800,
)

# Sign accumulated batch
token = axe.issue_token()
```

## Auto-batching every N seconds

```python
axe = AxiomaxClient(
    license_key="axe_lic_...",
    batch_interval_sec=3600,  # auto-issue token every hour
)
```

## Verification

Every issued token is verifiable by any third party at https://verify.axiomaxllc.com or using our open-source verifier `pip install axiomax-esg-verify`.

## License

MIT for this SDK. The AXIOMAX ESG Carbon Shield system architecture, calibration coefficients, and brand are proprietary to AXIOMAX LLC (Patent Pending USPTO 64/081,419).

## Links

- Main: https://axiomaxllc.com
- Public verifier: https://verify.axiomaxllc.com
- Pricing: https://axiomaxllc.com/pricing.html
- Open-source verifier spec: https://github.com/axiomaxllc/esg-carbon-shield
