gpuai-sdk 0.3.3__tar.gz → 0.3.4__tar.gz

{gpuai_sdk-0.3.3 → gpuai_sdk-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gpuai-sdk
-Version: 0.3.3
+Version: 0.3.4
 Summary: GPU.ai Public Developer API
 Home-page: 
 Author: GPU.ai Support
@@ -26,7 +26,7 @@ the dashboard. See https://gpu.ai/docs for details.
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 1.0.0
-- Package version: 0.3.3
+- Package version: 0.3.4
 - Generator version: 7.24.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 

{gpuai_sdk-0.3.3 → gpuai_sdk-0.3.4}/README.md

@@ -6,7 +6,7 @@ the dashboard. See https://gpu.ai/docs for details.
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 1.0.0
-- Package version: 0.3.3
+- Package version: 0.3.4
 - Generator version: 7.24.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 

{gpuai_sdk-0.3.3 → gpuai_sdk-0.3.4}/gpuai_sdk/__init__.py

@@ -15,7 +15,7 @@
 """  # noqa: E501
 
 
-__version__ = "0.3.3"
+__version__ = "0.3.4"
 
 # Define package exports
 __all__ = [

{gpuai_sdk-0.3.3 → gpuai_sdk-0.3.4}/gpuai_sdk/api_client.py

@@ -92,7 +92,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/0.3.3/python'
+        self.user_agent = 'OpenAPI-Generator/0.3.4/python'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

{gpuai_sdk-0.3.3 → gpuai_sdk-0.3.4}/gpuai_sdk/configuration.py

@@ -552,7 +552,7 @@ class Configuration:
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 1.0.0\n"\
-               "SDK Package Version: 0.3.3".\
+               "SDK Package Version: 0.3.4".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

{gpuai_sdk-0.3.3 → gpuai_sdk-0.3.4}/gpuai_sdk/models/create_instance_request.py

@@ -41,8 +41,9 @@ class CreateInstanceRequest(BaseModel):
     environment: Optional[StrictStr] = Field(default=None, description="Launch environment. Omit for the provider default (the GPU.ai Certified Image where supported). Accepted values: `certified` (the GPU.ai Certified base image), `certified:<framework>` (a framework layer — see GET /v1/environments for the roster, e.g. `certified:pytorch`), `certified:<framework>@<version>` (a specific framework version, e.g. `certified:pytorch@2.13`), `raw_vm` (root VM, provider default OS), `raw_vm:<os>` (root VM with a chosen OS, e.g. `raw_vm:ubuntu-24.04`), or `provider_template` (the provider's own image). A well-formed value the placed machine can't serve returns 422 `environment_unavailable`.", json_schema_extra={"examples": ["certified:pytorch@2.13"]})
     offering_id: Optional[StrictStr] = Field(default=None, description="Pin the launch to one exact offering (from GET /v1/pricing) so the engine never substitutes a pricier one. If that offering is gone, the launch fails explicitly rather than silently placing elsewhere.")
     disk_gb: Optional[Annotated[int, Field(strict=True, ge=10)]] = Field(default=None, description="Requested instance filesystem size in GB. Omit for the platform default (100 GB), which never narrows placement. Setting it is a hard requirement: placement narrows to capacity that can honor it (see `disk_configurable` on GET /v1/pricing), and a request no offering of the gpu_type can honor returns 422 `disk_unavailable` rather than launching with a different size. When the launch also pins an exact `offering_id`, a disk_gb larger than that offering's displayed `storage_gb` returns 422 `disk_exceeds_offering` rather than launching with a clamped filesystem. Disk beyond the included allowance (100 GB) is billed at the offering's `disk_price_per_gb_hour` (GET /v1/pricing), folded into the instance's single hourly rate. Bounds: at least 10, at most the platform ceiling (currently 1000) — outside them returns 422 `validation_failed`.", json_schema_extra={"examples": [200]})
-    env: Optional[Dict[str, StrictStr]] = Field(default=None, description="Per-deploy env overrides; only keys the template marks user_overridable are accepted (others 422). Secret values are redacted from operation metadata.")
-    __properties: ClassVar[List[str]] = ["gpu_type", "gpu_count", "region", "tier", "ssh_key_ids", "name", "max_price_per_hour", "viewed_price_per_hour", "template_id", "environment", "offering_id", "disk_gb", "env"]
+    env: Optional[Dict[str, StrictStr]] = Field(default=None, description="Environment variables. With `template_id`: per-deploy overrides — only keys the template marks user_overridable are accepted (others 422), and secret values are redacted from operation metadata. With `image`: plain container env vars — keys must be POSIX names and the platform's reserved namespace (`PUBLIC_KEY`, `GPUAI_*`) is refused (422).")
+    image: Optional[StrictStr] = Field(default=None, description="Launch from your own container image, e.g. `pytorch/pytorch:2.4.1-cuda12.4-cudnn9-devel` or `ghcr.io/acme/trainer:v1`. The image must be publicly pullable (private registries are not yet supported) and provide linux/amd64 — both are verified synchronously before anything is provisioned: an unknown image returns 422 `image_unavailable` and a registry outage 502 `registry_unreachable`, with no operation created and nothing billed. The launch is pinned to the exact manifest digest verified, so a tag re-push cannot change what boots. After SSH/tunnel setup the image's own ENTRYPOINT/CMD is started (its output is in /var/log/gpuai-entrypoint.log on the instance); an image with neither is a plain SSH environment. Placement narrows to container-native capacity — a gpu_type only available on VM capacity returns 422 `image_unavailable`. Mutually exclusive with `template_id` and `environment` (422). A malformed reference (bad charset, localhost/private-IP registry) returns 400.", json_schema_extra={"examples": ["ghcr.io/acme/trainer:v1"]})
+    __properties: ClassVar[List[str]] = ["gpu_type", "gpu_count", "region", "tier", "ssh_key_ids", "name", "max_price_per_hour", "viewed_price_per_hour", "template_id", "environment", "offering_id", "disk_gb", "env", "image"]
 
     @field_validator('tier')
     def tier_validate_enum(cls, value):
@@ -114,7 +115,8 @@ class CreateInstanceRequest(BaseModel):
             "environment": obj.get("environment"),
             "offering_id": obj.get("offering_id"),
             "disk_gb": obj.get("disk_gb"),
-            "env": obj.get("env")
+            "env": obj.get("env"),
+            "image": obj.get("image")
         })
         return _obj
 

{gpuai_sdk-0.3.3 → gpuai_sdk-0.3.4}/gpuai_sdk/models/instance.py

@@ -41,13 +41,14 @@ class Instance(BaseModel):
     price_per_hour: Union[StrictFloat, StrictInt] = Field(description="hourly rate for the whole instance — covers all gpu_count GPUs")
     connection: Optional[InstanceConnection] = None
     disk_gb: Optional[StrictInt] = Field(default=None, description="Instance filesystem size in GB that the platform configured for this launch. Present only where the placed capacity honors a configured disk size; absent means the machine's disk is provider-determined (its own flavor volume).")
+    image: Optional[StrictStr] = Field(default=None, description="The customer-supplied container image this instance was launched from, digest-pinned at verification time (e.g. `ghcr.io/acme/trainer:v1@sha256:…`). Present only on custom-image launches; template and certified launches never expose their images here.")
     status_reason: Optional[StrictStr] = Field(default=None, description="Why the instance is in the error state, e.g. \"provisioning stalled: the instance started but never became reachable\". Present only on errored instances.")
     created_at: datetime
     ready_at: Optional[datetime] = None
     terminated_at: Optional[datetime] = None
     last_reachable_at: Optional[datetime] = Field(default=None, description="Last time the platform verified the SSH path to this instance end-to-end through the tunnel. Absent means the instance has not been probed yet (freshly launched, or no tunnel) — it does NOT mean unreachable. An instance whose status is still \"running\" while this timestamp stops advancing is one whose SSH has died even though the machine is up.")
     unreachable_since: Optional[datetime] = Field(default=None, description="Start of the confirmed tunnel outage the instance is currently in. Present exactly when status is \"unreachable\", absent otherwise. It is the timestamp the auto-credit for the dead window is computed from, so a ledger credit can be reconciled against it.")
-    __properties: ClassVar[List[str]] = ["id", "name", "status", "gpu_type", "gpu_count", "region", "tier", "price_per_hour", "connection", "disk_gb", "status_reason", "created_at", "ready_at", "terminated_at", "last_reachable_at", "unreachable_since"]
+    __properties: ClassVar[List[str]] = ["id", "name", "status", "gpu_type", "gpu_count", "region", "tier", "price_per_hour", "connection", "disk_gb", "image", "status_reason", "created_at", "ready_at", "terminated_at", "last_reachable_at", "unreachable_since"]
 
     @field_validator('status')
     def status_validate_enum(cls, value):
@@ -127,6 +128,7 @@ class Instance(BaseModel):
             "price_per_hour": obj.get("price_per_hour"),
             "connection": InstanceConnection.from_dict(obj["connection"]) if obj.get("connection") is not None else None,
             "disk_gb": obj.get("disk_gb"),
+            "image": obj.get("image"),
             "status_reason": obj.get("status_reason"),
             "created_at": obj.get("created_at"),
             "ready_at": obj.get("ready_at"),

{gpuai_sdk-0.3.3 → gpuai_sdk-0.3.4}/gpuai_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gpuai-sdk
-Version: 0.3.3
+Version: 0.3.4
 Summary: GPU.ai Public Developer API
 Home-page: 
 Author: GPU.ai Support
@@ -26,7 +26,7 @@ the dashboard. See https://gpu.ai/docs for details.
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 1.0.0
-- Package version: 0.3.3
+- Package version: 0.3.4
 - Generator version: 7.24.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 

{gpuai_sdk-0.3.3 → gpuai_sdk-0.3.4}/pyproject.toml

@@ -6,7 +6,7 @@ name = "gpuai-sdk"
 # injected tree. This file is ignore-protected (see .openapi-generator-ignore)
 # so the placeholder survives regeneration; sdk/release/assert-placeholder.sh
 # fails CI if a real version ever lands here.
-version = "0.3.3"
+version = "0.3.4"
 description = "GPU.ai Public Developer API"
 authors = [
   {name = "GPU.ai Support",email = "support@gpu.ai"},

{gpuai_sdk-0.3.3 → gpuai_sdk-0.3.4}/setup.py

@@ -20,7 +20,7 @@ from setuptools import setup, find_packages  # noqa: H301
 # prerequisite: setuptools
 # http://pypi.python.org/pypi/setuptools
 NAME = "gpuai-sdk"
-VERSION = "0.3.3"
+VERSION = "0.3.4"
 PYTHON_REQUIRES = ">= 3.10"
 REQUIRES = [
     "urllib3 >= 2.6.3, < 3.0.0",