proxyllm-client 1.0.0__py3-none-any.whl

proxyllm_client/__init__.py

@@ -0,0 +1,153 @@
+"""Client helper for ProxyLLM (https://proxyllm.ai), the OpenAI-compatible
+LLM gateway.
+
+Two jobs, kept small:
+
+1. Point any OpenAI SDK at the gateway in one line:
+
+       import proxyllm_client
+       client = proxyllm_client.OpenAI(api_key="pllm_...")
+
+2. Let an agent create an account autonomously (email OTP, no captcha), then
+   provision routing keys. Unpaid accounts answer HTTP 402 with a checkout
+   link for the human operator; ``account()`` polls until the plan flips.
+   Full flow: https://proxyllm.ai/auth.md
+"""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.request
+
+__all__ = [
+    "OpenAI",
+    "signup",
+    "verify",
+    "account",
+    "models",
+    "key_info",
+    "create_routing_key",
+    "savings",
+    "GATEWAY_URL",
+    "BASE_URL",
+]
+
+GATEWAY_URL = "https://api.proxyllm.ai"
+BASE_URL = GATEWAY_URL + "/v1"
+_DASHBOARD = "https://proxyllm.ai"
+
+
+def _call(url: str, method: str = "GET", token: str | None = None, body=None):
+    """One HTTP call. Non-2xx responses return their parsed body instead of
+    raising: ProxyLLM's 402/410 bodies carry the next step (checkout link,
+    expiry) and are the useful part."""
+    req = urllib.request.Request(url, method=method)
+    req.add_header("Content-Type", "application/json")
+    if token:
+        req.add_header("Authorization", f"Bearer {token}")
+    data = None if body is None else json.dumps(body).encode()
+    try:
+        with urllib.request.urlopen(req, data) as res:
+            return {"status": res.status, **json.loads(res.read().decode() or "{}")}
+    except urllib.error.HTTPError as e:
+        try:
+            return {"status": e.code, **json.loads(e.read().decode() or "{}")}
+        except (ValueError, TypeError):
+            return {"status": e.code}
+
+
+def OpenAI(**kwargs):
+    """An ``openai.OpenAI`` client pre-pointed at the ProxyLLM gateway.
+
+    Pass ``api_key="pllm_..."`` (a routing key). Every other keyword goes to
+    the OpenAI constructor unchanged. Requires the ``openai`` package
+    (``pip install proxyllm-client[openai]``).
+    """
+    try:
+        import openai
+    except ImportError as e:
+        raise ImportError(
+            "The openai package is required: pip install proxyllm-client[openai]"
+        ) from e
+    kwargs.setdefault("base_url", BASE_URL)
+    return openai.OpenAI(**kwargs)
+
+
+def signup(email: str, source: str = "pypi") -> dict:
+    """Start account creation: emails a 6-digit code to the operator's inbox.
+
+    New accounts are unpaid and removed after 48 hours unless a human
+    activates the membership. Follow with :func:`verify`.
+    """
+    return _call(
+        f"{_DASHBOARD}/api/auth?action=agent-signup",
+        "POST",
+        body={"email": email, "source": source},
+    )
+
+
+def verify(email: str, code: str) -> dict:
+    """Exchange the emailed code for the sk_ account token (returned once).
+
+    While unpaid, the response carries ``payment.checkout_url`` to relay to
+    the human operator.
+    """
+    return _call(
+        f"{_DASHBOARD}/api/auth?action=agent-verify",
+        "POST",
+        body={"email": email, "code": code},
+    )
+
+
+def account(token: str) -> dict:
+    """Account state. Works while unpaid; poll until ``plan == "pro"``."""
+    return _call(f"{GATEWAY_URL}/v1/organizations/me", token=token)
+
+
+def models(routing_key: str | None = None) -> dict:
+    """OpenAI-shaped model list. No auth needed; key-scoped with one."""
+    return _call(f"{GATEWAY_URL}/v1/models", token=routing_key)
+
+
+def key_info(routing_key: str) -> dict:
+    """What a routing key routes to: lanes, models, budget remaining."""
+    return _call(f"{GATEWAY_URL}/v1/key", token=routing_key)
+
+
+def create_routing_key(token: str, label: str = "default", **body) -> dict:
+    """Mint a pllm_ routing key (``raw_key`` returned once). Optional keyword
+    arguments pass through: ``monthly_budget_usd``, ``mode``, ``providers``."""
+    return _call(
+        f"{GATEWAY_URL}/v1/organizations/routing-keys",
+        "POST",
+        token=token,
+        body={"label": label, **body},
+    )
+
+
+_TIERS = (
+    ("ChatGPT Plus", 20, 700),
+    ("ChatGPT Pro 5x", 100, 3500),
+    ("ChatGPT Pro 20x", 200, 14000),
+)
+_FEE = 129
+
+
+def savings(monthly_openai_bill_usd: float) -> dict:
+    """API bill in, subscription tier + flat total + monthly savings out."""
+    bill = max(0.0, float(monthly_openai_bill_usd))
+    tier = next((t for t in _TIERS if bill <= t[2]), None)
+    if tier is None:
+        seats = -(-int(bill) // _TIERS[2][2])
+        tier = (f"{seats}x ChatGPT Pro 20x", seats * _TIERS[2][1], seats * _TIERS[2][2])
+    name, cost, capacity = tier
+    total = cost + _FEE
+    return {
+        "plan": name,
+        "plan_cost_usd": cost,
+        "plan_capacity_usd": capacity,
+        "proxyllm_fee_usd": _FEE,
+        "new_monthly_total_usd": total,
+        "monthly_savings_usd": max(0, round(bill - total)),
+    }

proxyllm_client-1.0.0.dist-info/METADATA

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: proxyllm-client
+Version: 1.0.0
+Summary: Client helper for ProxyLLM, the OpenAI-compatible LLM gateway: one-line OpenAI client wiring plus the autonomous email-OTP account signup flow.
+Author-email: ProxyLLM <support@proxyllm.ai>
+License: MIT
+Project-URL: Homepage, https://proxyllm.ai/docs/api
+Project-URL: Documentation, https://proxyllm.ai/auth.md
+Project-URL: OpenAPI, https://proxyllm.ai/openapi.json
+Keywords: llm,openai-compatible,gateway,proxyllm,agent,http-402
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == "openai"
+
+# proxyllm-client
+
+Client helper for [ProxyLLM](https://proxyllm.ai), the OpenAI-compatible LLM gateway. One routing key rides provider lanes with fallback (a flat-fee ChatGPT/Codex subscription, self-hosted Claude Code bridges, metered API keys), budgets, and request logs.
+
+```bash
+pip install proxyllm-client[openai]
+```
+
+Point the OpenAI SDK at the gateway:
+
+```python
+import proxyllm_client
+
+client = proxyllm_client.OpenAI(api_key="pllm_...")
+client.chat.completions.create(model="flagship", messages=[{"role": "user", "content": "hi"}])
+```
+
+Or set two environment variables and change nothing else: `OPENAI_BASE_URL=https://api.proxyllm.ai/v1`, `OPENAI_API_KEY=pllm_...`.
+
+Agents can create the account themselves (email OTP, no captcha or browser):
+
+```python
+proxyllm_client.signup("operator@example.com")          # code lands in the inbox
+r = proxyllm_client.verify("operator@example.com", "123456")
+token = r["account_token"]                               # sk_..., returned once
+
+state = proxyllm_client.account(token)                   # 402 payload until a human pays:
+print(state["payment"]["checkout_url"])                 # relay this to your operator
+# poll account(token) until state["plan"] == "pro", then:
+key = proxyllm_client.create_routing_key(token, label="agent")["raw_key"]
+```
+
+Unpaid accounts answer HTTP 402 with the checkout link, the flat price ($129/mo), and the 48-hour removal deadline; error bodies are returned as values because they contain the next step. Free helpers: `models()`, `key_info(routing_key)`, `savings(monthly_bill)`.
+
+Full agent flow: <https://proxyllm.ai/auth.md>. OpenAPI: <https://proxyllm.ai/openapi.json>. MCP server: `npx -y proxyllm-mcp`.

proxyllm_client-1.0.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+proxyllm_client/__init__.py,sha256=zMUVyqwqD2pve_MCILBACIPx1pBkHFSJDSHegx_s0JA,4891
+proxyllm_client-1.0.0.dist-info/METADATA,sha256=q7XlFBYbbftiMHBpoW5EfhYWubrh07C8rhT6-JL3OIg,2529
+proxyllm_client-1.0.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+proxyllm_client-1.0.0.dist-info/top_level.txt,sha256=__xTeIMXiLqdxFKrr37NJe6kSOo19IhthbIuf7Gul2o,16
+proxyllm_client-1.0.0.dist-info/RECORD,,

proxyllm_client-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

proxyllm_client-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+proxyllm_client