flopsindex-partner 0.2.0

Partner-tier write SDK for the FLOPS Compute Intelligence Platform — submit fleet / SMPI / CLRI data. Companion to the public-read SDK at https://pypi.org/project/flopsindex/.

flopsindex-partner — partner write SDK

pip install flopsindex-partner

Authenticated write-side SDK for contributing partners (Modular, the lender-wave anchors, future fleet operators) submitting fleet / SMPI / CLRI data into the FLOPS Compute Intelligence Platform.

For the read-side (price / verify / catalog / methodology / timeseries / compute_margin / spread) install the companion package flopsindex — different audience, different brand, no API key required for the public surface.

30-second example

from flopsindex_partner import FLOPSClient

c = FLOPSClient(api_key="flops_xxxxxxxxx")

# Weekly fleet snapshot
c.submit_weekly({
    "partner_id": "modular",
    "as_of":      "2026-05-19T00:00:00Z",
    "gpus":       [{"sku": "h100_sxm5", "region": "us_east", "count": 128}, ...],
})

# Single-machine pricing index event
c.submit_smpi({
    "partner_id": "modular",
    "sku":        "h100_sxm5",
    "region":     "us_east",
    "price_usd":  2.42,
    "tier":       "on_demand",
    "ts":         "2026-05-19T22:00:00Z",
})

# CLRI lease-rate submission
c.submit_clri({
    "partner_id":      "modular",
    "sku":             "h100_sxm5",
    "tenor":           "P36M",
    "implied_rate_pct": 11.4,
    "as_of":           "2026-05-19T00:00:00Z",
})

Async surface

Every method has an a-prefixed async sibling:

import asyncio
from flopsindex_partner import FLOPSClient

async def main():
    async with FLOPSClient(api_key="...") as c:
        await c.asubmit_smpi({...})

asyncio.run(main())

Renamed from flops-client (2026-05-19)

This package was previously published as flops-client. Old imports continue to work but emit DeprecationWarning:

# OLD — deprecated, still works
from flops_client import FLOPSClient

# NEW — canonical
from flopsindex_partner import FLOPSClient

The PyPI distribution name also changed (flops-client → flopsindex-partner). Update your requirements.txt:

- flops-client==0.1.0
+ flopsindex-partner>=0.2.0

The legacy flops-client distribution on PyPI will be marked deprecated in a follow-up release; it will continue to install but won't receive updates. The recommended deadline for migration is 2026-12-31.

Authentication

API keys are issued by FLOPS partner ops. Email [e-mail] to onboard. Once issued:

export FLOPS_API_KEY="flops_xxxxxxxxx"

import os
from flopsindex_partner import FLOPSClient

c = FLOPSClient(api_key=os.environ["FLOPS_API_KEY"])

Submission contracts

The schemas for submit_weekly / submit_smpi / submit_clri live in the Submission Guide (latest at https://app.flopsindex.com/v1/methodology/submission-guide). Each method returns the server's receipt envelope:

result = c.submit_smpi({...})
# {'receipt_id': '...', 'received_at': '...', 'methodology_version': '...',
#  'k_anon_floor_met': True, 'inputs_hash': 'sha256:...'}

Hold onto receipt_id + inputs_hash — they're the audit trail.

Errors

FLOPSClientError is raised on non-retryable 4xx + exhausted 5xx retries. The SDK retries 429/500/502/503/504 up to 3 times with exponential backoff before surfacing.

from flopsindex_partner import FLOPSClient, FLOPSClientError

try:
    c.submit_smpi({...})
except FLOPSClientError as e:
    print(f"HTTP {e.status_code}: {e.detail}")

Optional metrics

If prometheus-client is installed (pip install flopsindex-partner[metrics]), the SDK emits:

Metric	Labels
flops_sdk_submissions_total	endpoint, status (ok / error / exhausted)
flops_sdk_request_seconds	endpoint

Scrape via the standard Prometheus exporter.

Related

• Read SDK: pip install flopsindex (PyPI)
• MCP server: pip install flopsindex-mcp (PyPI)
• Schema (JSON-LD): schema.flopsindex.com/compute-index-spec/v0.1/
• Verify endpoint: GET /v1/verify?index_id=<ID>&value=<v>
• Methodology library: /v1/methodology