routewise 0.1.0__tar.gz

routewise-0.1.0/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: routewise
+Version: 0.1.0
+Summary: Client SDK for the routewise cost-aware LLM router
+Requires-Python: >=3.8
+Requires-Dist: requests
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

routewise-0.1.0/README.md

@@ -0,0 +1,40 @@
+# routewise (Python SDK)
+
+Thin client for the routewise cost-aware LLM router. No routing logic lives
+here -- it's a convenience wrapper around HTTP calls to the real API.
+
+## Install
+
+Locally, for development:
+```bash
+pip install -e ./sdk
+```
+
+Or directly from GitHub (once pushed):
+```bash
+pip install git+https://github.com/Ishan-5/llm-router.git#subdirectory=sdk
+```
+
+## Usage
+
+```python
+from routewise import RouteWiseClient
+
+client = RouteWiseClient(api_key="rw_your_key_here")
+
+result = client.ask("What is the capital of France?")
+print(result["response"])
+print(result["routed_to"], result["cost_usd"])
+
+# Force a specific tier instead of letting the difficulty model decide
+result = client.ask("Explain quantum computing", override_tier="frontier")
+
+# Get aggregate usage stats
+stats = client.stats()
+print(stats["total_requests"], stats["cache_hit_rate"])
+```
+
+## Errors
+
+All non-2xx responses raise `RouteWiseError` with the API's error detail
+message, e.g. invalid key, rate limit exceeded, empty query.

routewise-0.1.0/routewise/__init__.py

@@ -0,0 +1,57 @@
+"""
+routewise -- a thin Python client for the routewise cost-aware LLM router.
+
+This does NOT contain any routing logic. It just wraps HTTP calls to the
+real API so callers don't have to write requests.post()/headers/error
+handling by hand every time.
+"""
+import requests
+
+DEFAULT_BASE_URL = "https://llm-router-d2b2.onrender.com"
+
+
+class RouteWiseError(Exception):
+    """Raised when the API returns an error response."""
+    pass
+
+
+class RouteWiseClient:
+    def __init__(self, api_key: str, base_url: str = DEFAULT_BASE_URL, timeout: int = 30):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+    def _headers(self) -> dict:
+        return {"Authorization": f"Bearer {self.api_key}"}
+
+    def ask(self, query: str, override_tier: str | None = None) -> dict:
+        """
+        Send a query through the router. Returns the full response dict
+        (response text, tier used, cost, latency, cache_hit, etc.)
+
+        override_tier: optionally force "cheap", "mid", or "frontier"
+        instead of letting the difficulty model decide.
+        """
+        payload = {"query": query}
+        if override_tier:
+            payload["override_tier"] = override_tier
+
+        response = requests.post(
+            f"{self.base_url}/route",
+            headers=self._headers(),
+            json=payload,
+            timeout=self.timeout,
+        )
+
+        if not response.ok:
+            detail = response.json().get("detail", response.text) if response.content else response.text
+            raise RouteWiseError(f"[{response.status_code}] {detail}")
+
+        return response.json()
+
+    def stats(self) -> dict:
+        """Fetch aggregate usage stats (total requests, cost saved, tier distribution, etc.)"""
+        response = requests.get(f"{self.base_url}/stats", timeout=self.timeout)
+        if not response.ok:
+            raise RouteWiseError(f"[{response.status_code}] {response.text}")
+        return response.json()

routewise-0.1.0/routewise.egg-info/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: routewise
+Version: 0.1.0
+Summary: Client SDK for the routewise cost-aware LLM router
+Requires-Python: >=3.8
+Requires-Dist: requests
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

routewise-0.1.0/routewise.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+setup.py
+routewise/__init__.py
+routewise.egg-info/PKG-INFO
+routewise.egg-info/SOURCES.txt
+routewise.egg-info/dependency_links.txt
+routewise.egg-info/requires.txt
+routewise.egg-info/top_level.txt

routewise-0.1.0/routewise.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

routewise-0.1.0/routewise.egg-info/requires.txt

@@ -0,0 +1 @@
+requests

routewise-0.1.0/routewise.egg-info/top_level.txt

@@ -0,0 +1 @@
+routewise

routewise-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

routewise-0.1.0/setup.py

@@ -0,0 +1,10 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="routewise",
+    version="0.1.0",
+    description="Client SDK for the routewise cost-aware LLM router",
+    packages=find_packages(),
+    install_requires=["requests"],
+    python_requires=">=3.8",
+)