chassis-cloud 0.1.0

Official Python SDK for the Chassis GPU cloud API by OkeyMeta Ltd

chassis (Python)

Official Python client for the Chassis public API (/api/v1).

Default base URL: https://chassis.okeymeta.com.ng/api/v1

Install

pip install chassis-cloud

From this monorepo during development:

pip install -e packages/sdk-python

Requires Python 3.10+ and httpx.

from chassis import Chassis

Auth

Create an API key in the Chassis console under API Keys. Keys look like chs_… and are shown once.

from chassis import Chassis

with Chassis(api_key="chs_...") as client:
    ...

Optional local override:

Chassis(api_key="chs_...", base_url="http://localhost:3000/api/v1")

Quickstart

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:

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

License

MIT · OkeyMeta Ltd