Skip to main content
from gravixlayer import GravixLayer

client = GravixLayer()

runtime = client.runtime.create(
    template="python-3.12-base-small",
    env_vars={"APP_ENV": "production"},
    metadata={"project": "my-agent"},
)

print(runtime.runtime_id)
print(runtime.status)
print(runtime.template)

# Clean up when done
client.runtime.kill(runtime.runtime_id)

​
Parameters

ParameterTypeRequiredDescription
templatestringYesTemplate name (e.g. python-3.12-base-small)
timeoutintegerNoRuntime timeout in seconds
env_varsobjectNoEnvironment variables injected into the runtime
metadataobjectNoUser-defined metadata
internet_accessbooleanNoEnable internet access
providerstringNoCloud provider (azure, aws, gcp)
regionstringNoRegion (eastus2, us-east-1)

​
Response

FieldTypeDescription
runtime_idstringUnique runtime identifier
statusstringRuntime status (creating, running)
templatestringTemplate used
providerstringCloud provider
regionstringRegion
started_atstringStart timestamp
timeout_atstringTimeout timestamp
cpu_countintegervCPU count
memory_mbintegerMemory in MB
disk_size_mbintegerDisk size in MB