From 3a0a81d928e0bcf71cff93a226fcafd05850f0ff Mon Sep 17 00:00:00 2001
From: allena <aalbindia08@gmail.com>
Date: Mon, 3 Nov 2025 10:53:05 -0800
Subject: [PATCH] Add PolarGrid feature extraction and text generation classes

---
 .../inference/_provider/polargrid.py          | 65 +++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 src/huggingface_hub/inference/_provider/polargrid.py

diff --git a/src/huggingface_hub/inference/_provider/polargrid.py b/src/huggingface_hub/inference/_provider/polargrid.py
new file mode 100644
index 0000000000..0c0e5f4acf
--- /dev/null
+++ b/src/huggingface_hub/inference/_provider/polargrid.py
@@ -0,0 +1,65 @@
+from typing import Any, Dict, Optional, Union
+from ._common import TaskProviderHelper, BaseTextGenerationTask
+from ._types import RequestParameters
+
+PROVIDER_NAME = "polargrid"
+PROVIDER_BASE_URL = "https://api.polargrid.com"  #NOT ACTUALLY URL BASE RN
+
+class PolarGridFeatureExtraction(TaskProviderHelper):
+    def __init__(self) -> None:
+        super().__init__(provider=PROVIDER_NAME, base_url=PROVIDER_BASE_URL, task="feature-extraction")
+
+    def _prepare_headers(self, headers: Dict, api_key: str) -> Dict:
+        headers = {**headers, "Authorization": f"Bearer {api_key}"}
+        headers.setdefault("Content-Type", "application/json")
+        return headers
+
+    def _prepare_route(self, mapped_model: str, api_key: str) -> str:
+        return "/v1/embeddings"
+
+    def _prepare_payload_as_dict(self, inputs: Any, parameters: Dict, mapped_model: str) -> Optional[Dict]:
+        return {
+            "model": mapped_model,
+            "input": inputs if isinstance(inputs, list) else [inputs],
+            **(parameters or {}),
+        }
+
+    def get_response(self, response: Union[bytes, Dict], request_params: Optional[RequestParameters] = None) -> Any:
+        if isinstance(response, bytes):
+            raise ValueError("Unexpected bytes response for feature-extraction")
+        return response
+
+class PolarGridTextGeneration(BaseTextGenerationTask):
+    def __init__(self) -> None:
+        super().__init__(provider=PROVIDER_NAME, base_url=PROVIDER_BASE_URL)
+
+    def _prepare_headers(self, headers: Dict, api_key: str) -> Dict:
+        headers = {**headers, "Authorization": f"Bearer {api_key}"}
+        headers.setdefault("Content-Type", "application/json")
+        return headers
+
+    def _prepare_route(self, mapped_model: str, api_key: str) -> str:
+        return "/v1/chat/completions"
+
+    def _prepare_payload_as_dict(self, inputs: Any, parameters: Dict, mapped_model: str) -> Optional[Dict]:
+        prompt = inputs if isinstance(inputs, str) else str(inputs)
+        body: Dict[str, Any] = {
+            "model": mapped_model,
+            "messages": [{"role": "user", "content": prompt}],
+        }
+        if "max_new_tokens" in parameters: body["max_tokens"] = parameters["max_new_tokens"]
+        if "temperature" in parameters: body["temperature"] = parameters["temperature"]
+        if "top_p" in parameters: body["top_p"] = parameters["top_p"]
+        if "stop_sequences" in parameters: body["stop"] = parameters["stop_sequences"]
+        for k, v in parameters.items():
+            if k not in {"max_new_tokens", "temperature", "top_p", "stop_sequences"}:
+                body.setdefault(k, v)
+        return body
+
+    def get_response(self, response: Union[bytes, Dict], request_params: Optional[RequestParameters] = None) -> Any:
+        if isinstance(response, bytes):
+            raise ValueError("Unexpected bytes response for text-generation")
+        choices = response.get("choices", [])
+        if choices and "message" in choices[0]:
+            return choices[0]["message"]["content"]
+        return str(response)