chassis-cloud 0.1.0__tar.gz

chassis_cloud-0.1.0/.gitignore

@@ -0,0 +1,23 @@
+node_modules
+.DS_Store
+dist
+dist-ssr
+*.local
+.env
+.env.local
+*.pem
+sdk/dist
+.nitro
+.tanstack
+.wrangler
+.output
+.vinxi
+__unconfig*
+todos.json
+*-resp.json
+tsc-scoped.txt
+scripts/_git-status.txt
+scripts/_npm-install.log
+
+.npmrc
+**/.npmrc

chassis_cloud-0.1.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: chassis-cloud
+Version: 0.1.0
+Summary: Official Python SDK for the Chassis GPU cloud API by OkeyMeta Ltd
+Project-URL: Homepage, https://chassis.okeymeta.com.ng/docs
+Project-URL: Documentation, https://chassis.okeymeta.com.ng/docs
+Project-URL: Repository, https://github.com/okeymeta/chassis
+Project-URL: Issues, https://github.com/okeymeta/chassis/issues
+Author-email: Okechukwu Nwaozor <okechukwunwaozor9@gmail.com>
+License: MIT
+Keywords: africa,ai,chassis,cloud,gpu,okeymeta,sdk
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: requests
+Requires-Dist: requests>=2.31.0; extra == 'requests'
+Description-Content-Type: text/markdown
+
+# chassis (Python)
+
+Official Python client for the Chassis public API (`/api/v1`).
+
+Default base URL: `https://chassis.okeymeta.com.ng/api/v1`
+
+## Install
+
+```bash
+pip install chassis-cloud
+```
+
+From this monorepo during development:
+
+```bash
+pip install -e packages/sdk-python
+```
+
+Requires **Python 3.10+** and **httpx**.
+
+```python
+from chassis import Chassis
+```
+
+## Auth
+
+Create an API key in the Chassis console under **API Keys**. Keys look like `chs_…` and are shown **once**.
+
+```python
+from chassis import Chassis
+
+with Chassis(api_key="chs_...") as client:
+    ...
+```
+
+Optional local override:
+
+```python
+Chassis(api_key="chs_...", base_url="http://localhost:3000/api/v1")
+```
+
+## Quickstart
+
+```python
+from chassis import Chassis
+
+with Chassis(api_key="chs_...") as client:
+    gpus = client.list_gpus()
+
+    instance = client.spin_up(
+        gpuSkuId=gpus[0]["id"],
+        name="train-01",
+        gpuCount=2,  # multi-GPU (1–8, SKU-capped)
+        imageName="pytorch/pytorch:2.1.0-cuda11.8-cudnn8-devel",
+        containerDiskGb=50,
+        cloudType="SECURE",
+        ports="8888/http,22/tcp",
+    )
+
+    client.restart(instance["id"])
+    client.stop(instance["id"])
+    client.terminate(instance["id"])
+```
+
+## Instance options (`create_instance` / `spin_up`)
+
+| Field | Required | Notes |
+|-------|----------|--------|
+| `gpuSkuId` | yes | Chassis SKU UUID from `list_gpus()` |
+| `name` | yes | Instance name |
+| `gpuCount` | no | Default `1`, max `8` |
+| `imageName` | no | Container image |
+| `containerDiskGb` | no | Default `50` |
+| `volumeGb` | no | Ephemeral volume GB |
+| `networkVolumeId` | no | Chassis network volume UUID |
+| `registryCredentialId` | no | Chassis registry credential UUID |
+| `cloudType` | no | `"SECURE"` or `"COMMUNITY"` |
+| `ports` | no | e.g. `"8888/http,22/tcp"` |
+| `startAfterCreate` | no | Default `True` (`spin_up` forces `True`) |
+
+## Methods
+
+### GPUs & instances
+
+| Method | HTTP |
+|--------|------|
+| `list_gpus()` | `GET /gpus` |
+| `list_instances()` | `GET /instances` |
+| `create_instance(**kwargs)` | `POST /instances` |
+| `spin_up(**kwargs)` | `POST /instances` (`startAfterCreate: true`) |
+| `get_instance(id)` | `GET /instances/:id` |
+| `get_instance_logs(id, tail=None)` | `GET /instances/:id/logs` |
+| `start(id)` | `POST /instances/:id/start` |
+| `stop(id)` | `POST /instances/:id/stop` |
+| `restart(id)` | `POST /instances/:id/restart` |
+| `terminate(id)` | `DELETE /instances/:id` |
+
+### Clusters (multi-node)
+
+| Method | HTTP |
+|--------|------|
+| `list_clusters()` | `GET /clusters` |
+| `create_cluster(**kwargs)` | `POST /clusters` |
+| `get_cluster(id)` | `GET /clusters/:id` |
+| `start_cluster(id)` | `POST /clusters/:id/start` |
+| `stop_cluster(id)` | `POST /clusters/:id/stop` |
+| `terminate_cluster(id)` | `DELETE /clusters/:id` |
+
+Create with `name`, `gpuSkuId`, `nodeCount` (2–8), and optional `gpusPerNode`, `imageName`, `networkVolumeId`, `ports`. Nodes get `CHASSIS_CLUSTER_ID`, `CHASSIS_NODE_RANK`, and `CHASSIS_NODE_COUNT`.
+
+### Templates, volumes, registries
+
+| Method | HTTP |
+|--------|------|
+| `list_templates()` / `create_template(**kwargs)` | `/templates` |
+| `list_volumes()` / `create_volume(**kwargs)` | `/volumes` |
+| `list_registries()` / `create_registry(**kwargs)` | `/registries` |
+
+### Serverless endpoints
+
+| Method | HTTP |
+|--------|------|
+| `list_endpoints()` | `GET /endpoints` |
+| `create_endpoint(**kwargs)` | `POST /endpoints` |
+| `delete_endpoint(id)` | `DELETE /endpoints/:id` |
+| `run(endpoint_id, body=None)` | `POST /endpoints/:id/run` |
+| `run_sync(endpoint_id, body=None, wait_ms=None)` | `POST /endpoints/:id/runsync` |
+
+Serverless example:
+
+```python
+endpoints = client.list_endpoints()
+result = client.run_sync(
+    endpoints[0]["id"],
+    body={"input": {"prompt": "hello"}},
+)
+health = client.get_endpoint_health(endpoints[0]["id"])
+```
+
+Create options also accept `env`, `interruptible`, and `publicIp`.
+
+Errors raise `ChassisError` with `.status`, `.body`, and a short Chassis-safe message — never infrastructure or vendor details. Responses use Chassis public shapes only (`data` / `error`).
+
+## Docs
+
+Human setup guide: [https://chassis.okeymeta.com.ng/docs](https://chassis.okeymeta.com.ng/docs)
+
+## License
+
+MIT · OkeyMeta Ltd

chassis_cloud-0.1.0/README.md

@@ -0,0 +1,150 @@
+# chassis (Python)
+
+Official Python client for the Chassis public API (`/api/v1`).
+
+Default base URL: `https://chassis.okeymeta.com.ng/api/v1`
+
+## Install
+
+```bash
+pip install chassis-cloud
+```
+
+From this monorepo during development:
+
+```bash
+pip install -e packages/sdk-python
+```
+
+Requires **Python 3.10+** and **httpx**.
+
+```python
+from chassis import Chassis
+```
+
+## Auth
+
+Create an API key in the Chassis console under **API Keys**. Keys look like `chs_…` and are shown **once**.
+
+```python
+from chassis import Chassis
+
+with Chassis(api_key="chs_...") as client:
+    ...
+```
+
+Optional local override:
+
+```python
+Chassis(api_key="chs_...", base_url="http://localhost:3000/api/v1")
+```
+
+## Quickstart
+
+```python
+from chassis import Chassis
+
+with Chassis(api_key="chs_...") as client:
+    gpus = client.list_gpus()
+
+    instance = client.spin_up(
+        gpuSkuId=gpus[0]["id"],
+        name="train-01",
+        gpuCount=2,  # multi-GPU (1–8, SKU-capped)
+        imageName="pytorch/pytorch:2.1.0-cuda11.8-cudnn8-devel",
+        containerDiskGb=50,
+        cloudType="SECURE",
+        ports="8888/http,22/tcp",
+    )
+
+    client.restart(instance["id"])
+    client.stop(instance["id"])
+    client.terminate(instance["id"])
+```
+
+## Instance options (`create_instance` / `spin_up`)
+
+| Field | Required | Notes |
+|-------|----------|--------|
+| `gpuSkuId` | yes | Chassis SKU UUID from `list_gpus()` |
+| `name` | yes | Instance name |
+| `gpuCount` | no | Default `1`, max `8` |
+| `imageName` | no | Container image |
+| `containerDiskGb` | no | Default `50` |
+| `volumeGb` | no | Ephemeral volume GB |
+| `networkVolumeId` | no | Chassis network volume UUID |
+| `registryCredentialId` | no | Chassis registry credential UUID |
+| `cloudType` | no | `"SECURE"` or `"COMMUNITY"` |
+| `ports` | no | e.g. `"8888/http,22/tcp"` |
+| `startAfterCreate` | no | Default `True` (`spin_up` forces `True`) |
+
+## Methods
+
+### GPUs & instances
+
+| Method | HTTP |
+|--------|------|
+| `list_gpus()` | `GET /gpus` |
+| `list_instances()` | `GET /instances` |
+| `create_instance(**kwargs)` | `POST /instances` |
+| `spin_up(**kwargs)` | `POST /instances` (`startAfterCreate: true`) |
+| `get_instance(id)` | `GET /instances/:id` |
+| `get_instance_logs(id, tail=None)` | `GET /instances/:id/logs` |
+| `start(id)` | `POST /instances/:id/start` |
+| `stop(id)` | `POST /instances/:id/stop` |
+| `restart(id)` | `POST /instances/:id/restart` |
+| `terminate(id)` | `DELETE /instances/:id` |
+
+### Clusters (multi-node)
+
+| Method | HTTP |
+|--------|------|
+| `list_clusters()` | `GET /clusters` |
+| `create_cluster(**kwargs)` | `POST /clusters` |
+| `get_cluster(id)` | `GET /clusters/:id` |
+| `start_cluster(id)` | `POST /clusters/:id/start` |
+| `stop_cluster(id)` | `POST /clusters/:id/stop` |
+| `terminate_cluster(id)` | `DELETE /clusters/:id` |
+
+Create with `name`, `gpuSkuId`, `nodeCount` (2–8), and optional `gpusPerNode`, `imageName`, `networkVolumeId`, `ports`. Nodes get `CHASSIS_CLUSTER_ID`, `CHASSIS_NODE_RANK`, and `CHASSIS_NODE_COUNT`.
+
+### Templates, volumes, registries
+
+| Method | HTTP |
+|--------|------|
+| `list_templates()` / `create_template(**kwargs)` | `/templates` |
+| `list_volumes()` / `create_volume(**kwargs)` | `/volumes` |
+| `list_registries()` / `create_registry(**kwargs)` | `/registries` |
+
+### Serverless endpoints
+
+| Method | HTTP |
+|--------|------|
+| `list_endpoints()` | `GET /endpoints` |
+| `create_endpoint(**kwargs)` | `POST /endpoints` |
+| `delete_endpoint(id)` | `DELETE /endpoints/:id` |
+| `run(endpoint_id, body=None)` | `POST /endpoints/:id/run` |
+| `run_sync(endpoint_id, body=None, wait_ms=None)` | `POST /endpoints/:id/runsync` |
+
+Serverless example:
+
+```python
+endpoints = client.list_endpoints()
+result = client.run_sync(
+    endpoints[0]["id"],
+    body={"input": {"prompt": "hello"}},
+)
+health = client.get_endpoint_health(endpoints[0]["id"])
+```
+
+Create options also accept `env`, `interruptible`, and `publicIp`.
+
+Errors raise `ChassisError` with `.status`, `.body`, and a short Chassis-safe message — never infrastructure or vendor details. Responses use Chassis public shapes only (`data` / `error`).
+
+## Docs
+
+Human setup guide: [https://chassis.okeymeta.com.ng/docs](https://chassis.okeymeta.com.ng/docs)
+
+## License
+
+MIT · OkeyMeta Ltd

chassis_cloud-0.1.0/chassis/__init__.py

@@ -0,0 +1,235 @@
+from __future__ import annotations
+
+import re
+from typing import Any, Optional
+
+import httpx
+
+_LEAKY_ERROR = re.compile(
+    r"run\s*pod|runpod|\bupstream\b|\bgraphql\b|\bpods?\b|compute api|compute server|https?://|rest\.runpod|api\.runpod|machineid|gputypeid",
+    re.I,
+)
+
+_LEAKY_KEY = re.compile(r"provider|upstream|runpod|podId|machineId|graphql", re.I)
+
+
+def _scrub(value: Any) -> Any:
+    if isinstance(value, str):
+        return "[redacted]" if _LEAKY_ERROR.search(value) else value
+    if isinstance(value, list):
+        return [_scrub(v) for v in value]
+    if isinstance(value, dict):
+        return {
+            k: _scrub(v)
+            for k, v in value.items()
+            if not _LEAKY_KEY.search(str(k))
+        }
+    return value
+
+
+def _public_error_message(message: str, status: int) -> str:
+    """Keep SDK errors specific when safe; never surface infrastructure wording."""
+    trimmed = (message or "").strip()
+    if not trimmed or _LEAKY_ERROR.search(trimmed):
+        if status == 401:
+            return "Invalid API key."
+        if status == 403:
+            return "Insufficient API key scope."
+        if status == 404:
+            return "Resource not found."
+        if status == 429:
+            return "Too many requests. Please wait and try again."
+        return "Request failed. Please try again or contact support."
+    return trimmed if len(trimmed) <= 240 else f"{trimmed[:237]}…"
+
+
+class ChassisError(Exception):
+    def __init__(self, message: str, status: int, body: Any = None) -> None:
+        super().__init__(_public_error_message(message, status))
+        self.status = status
+        self.body = _scrub(body)
+
+
+class Chassis:
+    """Minimal Chassis API client (httpx). Spin up GPUs from any Python runtime."""
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://chassis.okeymeta.com.ng/api/v1",
+        timeout: float = 60.0,
+    ) -> None:
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self._client = httpx.Client(
+            base_url=self.base_url,
+            headers={
+                "Authorization": f"Bearer {api_key}",
+                "Accept": "application/json",
+                "Content-Type": "application/json",
+            },
+            timeout=timeout,
+        )
+
+    def close(self) -> None:
+        self._client.close()
+
+    def __enter__(self) -> "Chassis":
+        return self
+
+    def __exit__(self, *args: object) -> None:
+        self.close()
+
+    def _request(self, method: str, path: str, json: Optional[dict] = None) -> Any:
+        response = self._client.request(method, path, json=json)
+        try:
+            body = response.json()
+        except Exception:
+            body = response.text
+
+        if response.is_error:
+            if isinstance(body, dict) and isinstance(body.get("error"), str):
+                message = body["error"]
+            elif response.status_code == 401:
+                message = "Invalid API key."
+            elif response.status_code == 403:
+                message = "Insufficient API key scope."
+            else:
+                message = "Request failed. Please try again or contact support."
+            raise ChassisError(message, response.status_code, body)
+
+        return body
+
+    def list_gpus(self) -> list[dict]:
+        return self._request("GET", "/gpus").get("data", [])
+
+    def list_instances(self) -> list[dict]:
+        return self._request("GET", "/instances").get("data", [])
+
+    def create_instance(self, **kwargs: Any) -> dict:
+        return self._request("POST", "/instances", json=kwargs)["data"]
+
+    def get_instance(self, instance_id: str) -> dict:
+        return self._request("GET", f"/instances/{instance_id}")["data"]
+
+    def update_instance(self, instance_id: str, **kwargs: Any) -> dict:
+        return self._request("PATCH", f"/instances/{instance_id}", json=kwargs)[
+            "data"
+        ]
+
+    def start(self, instance_id: str) -> dict:
+        return self._request("POST", f"/instances/{instance_id}/start")["data"]
+
+    def stop(self, instance_id: str) -> dict:
+        return self._request("POST", f"/instances/{instance_id}/stop")["data"]
+
+    def restart(self, instance_id: str) -> dict:
+        return self._request("POST", f"/instances/{instance_id}/restart")["data"]
+
+    def spin_up(self, **kwargs: Any) -> dict:
+        """Create and start an instance in one call (from notebooks, CI, or services)."""
+        payload = {**kwargs, "startAfterCreate": True}
+        return self.create_instance(**payload)
+
+    def terminate(self, instance_id: str) -> dict:
+        return self._request("DELETE", f"/instances/{instance_id}")["data"]
+
+    def list_registries(self) -> list[dict]:
+        return self._request("GET", "/registries").get("data", [])
+
+    def create_registry(self, **kwargs: Any) -> dict:
+        return self._request("POST", "/registries", json=kwargs)["data"]
+
+    def list_templates(self) -> list[dict]:
+        return self._request("GET", "/templates").get("data", [])
+
+    def create_template(self, **kwargs: Any) -> dict:
+        return self._request("POST", "/templates", json=kwargs)["data"]
+
+    def update_template(self, template_id: str, **kwargs: Any) -> dict:
+        return self._request("PATCH", f"/templates/{template_id}", json=kwargs)[
+            "data"
+        ]
+
+    def list_volumes(self) -> list[dict]:
+        return self._request("GET", "/volumes").get("data", [])
+
+    def create_volume(self, **kwargs: Any) -> dict:
+        return self._request("POST", "/volumes", json=kwargs)["data"]
+
+    def update_volume(self, volume_id: str, **kwargs: Any) -> dict:
+        return self._request("PATCH", f"/volumes/{volume_id}", json=kwargs)[
+            "data"
+        ]
+
+    def list_endpoints(self) -> list[dict]:
+        return self._request("GET", "/endpoints").get("data", [])
+
+    def create_endpoint(self, **kwargs: Any) -> dict:
+        return self._request("POST", "/endpoints", json=kwargs)["data"]
+
+    def get_endpoint(self, endpoint_id: str) -> dict:
+        return self._request("GET", f"/endpoints/{endpoint_id}")["data"]
+
+    def update_endpoint(self, endpoint_id: str, **kwargs: Any) -> dict:
+        return self._request("PATCH", f"/endpoints/{endpoint_id}", json=kwargs)[
+            "data"
+        ]
+
+    def delete_endpoint(self, endpoint_id: str) -> dict:
+        return self._request("DELETE", f"/endpoints/{endpoint_id}")["data"]
+
+    def run(self, endpoint_id: str, body: Optional[dict] = None) -> Any:
+        return self._request(
+            "POST", f"/endpoints/{endpoint_id}/run", json=body or {}
+        ).get("data")
+
+    def run_sync(
+        self,
+        endpoint_id: str,
+        body: Optional[dict] = None,
+        wait_ms: Optional[int] = None,
+    ) -> Any:
+        path = f"/endpoints/{endpoint_id}/runsync"
+        if wait_ms is not None:
+            path = f"{path}?wait={int(wait_ms)}"
+        return self._request("POST", path, json=body or {}).get("data")
+
+    def get_endpoint_health(self, endpoint_id: str) -> Any:
+        return self._request("GET", f"/endpoints/{endpoint_id}/health").get(
+            "data"
+        )
+
+    def get_job(self, endpoint_id: str, job_id: str) -> Any:
+        return self._request(
+            "GET", f"/endpoints/{endpoint_id}/jobs/{job_id}"
+        ).get("data")
+
+    def cancel_job(self, endpoint_id: str, job_id: str) -> Any:
+        return self._request(
+            "POST", f"/endpoints/{endpoint_id}/jobs/{job_id}/cancel"
+        ).get("data")
+
+    def get_instance_logs(self, instance_id: str, tail: int | None = None) -> dict:
+        path = f"/instances/{instance_id}/logs"
+        if tail is not None:
+            path = f"{path}?tail={int(tail)}"
+        return self._request("GET", path).get("data", {})
+
+    def list_clusters(self) -> list:
+        return self._request("GET", "/clusters").get("data", [])
+
+    def create_cluster(self, **kwargs: Any) -> dict:
+        return self._request("POST", "/clusters", json=kwargs)["data"]
+
+    def get_cluster(self, cluster_id: str) -> dict:
+        return self._request("GET", f"/clusters/{cluster_id}")["data"]
+
+    def start_cluster(self, cluster_id: str) -> dict:
+        return self._request("POST", f"/clusters/{cluster_id}/start")["data"]
+
+    def stop_cluster(self, cluster_id: str) -> dict:
+        return self._request("POST", f"/clusters/{cluster_id}/stop")["data"]
+
+    def terminate_cluster(self, cluster_id: str) -> dict:
+        return self._request("DELETE", f"/clusters/{cluster_id}")["data"]

chassis_cloud-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[project]
+name = "chassis-cloud"
+version = "0.1.0"
+description = "Official Python SDK for the Chassis GPU cloud API by OkeyMeta Ltd"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+  { name = "Okechukwu Nwaozor", email = "okechukwunwaozor9@gmail.com" },
+]
+keywords = ["chassis", "gpu", "cloud", "sdk", "okeymeta", "africa", "ai"]
+dependencies = [
+  "httpx>=0.27.0",
+]
+
+[project.urls]
+Homepage = "https://chassis.okeymeta.com.ng/docs"
+Documentation = "https://chassis.okeymeta.com.ng/docs"
+Repository = "https://github.com/okeymeta/chassis"
+Issues = "https://github.com/okeymeta/chassis/issues"
+
+[project.optional-dependencies]
+requests = ["requests>=2.31.0"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["chassis"]