Python SDK Reference

Choose Sync for regular scripts and synchronous applications, or Async for asyncio services and concurrent runtime operations. Both styles use the same Shared models, configuration objects, enums, and errors.

Style	Entry point	Best for
Sync	`Runta`	Scripts, CLI tools, notebooks, and synchronous applications
Async	`AsyncRunta`	`asyncio` services and concurrent runtime operations

Quick start

Sync

from runta import Runta

with Runta() as client:
    runtime = client.runtimes.create()
    result = runtime.exec("python --version")
    print(result.stdout_text)

Async

from runta import AsyncRunta

async with AsyncRunta() as client:
    runtime = await client.runtimes.create()
    result = await runtime.exec("python --version")
    print(result.stdout_text)

Sync

Component	Role	Description
`Runta`	Client	Main synchronous client for runtimes, secrets, and checkpoints.
`Runtime`	Runtime handle	Controls lifecycle, commands, files, networking, and secrets for one runtime.
`RuntimeManager`	Manager	Creates, lists, and resolves runtimes for a synchronous client.
`SecretManager`	Manager	Manages stored tenant secrets and default secret-injection stubs.
`CheckpointManager`	Manager	Lists, resolves, waits for, and deletes tenant checkpoints.
`EgressManager`	Manager	Reads and updates the network egress policy for a runtime.
`FileManager`	Manager	Reads, writes, uploads, and downloads files for a runtime.
`RuntimeSecretManager`	Manager	Configures and inspects secret-injection stubs for a runtime.
`RuntimeCheckpointManager`	Manager	Creates, lists, and deletes checkpoints for a runtime.

Async

Component	Role	Description
`AsyncRunta`	Client	Main asynchronous client for runtimes, secrets, and checkpoints.
`AsyncRuntime`	Runtime handle	Controls one runtime through asynchronous lifecycle and I/O operations.
`AsyncRuntimeManager`	Manager	Creates, lists, and resolves runtimes asynchronously.
`AsyncSecretManager`	Manager	Manages stored tenant secrets and default stubs asynchronously.
`AsyncCheckpointManager`	Manager	Lists, resolves, waits for, and deletes checkpoints asynchronously.
`AsyncEgressManager`	Manager	Reads and updates a runtime egress policy asynchronously.
`AsyncFileManager`	Manager	Reads, writes, uploads, and downloads runtime files asynchronously.
`AsyncRuntimeSecretManager`	Manager	Configures runtime secret-injection stubs asynchronously.
`AsyncRuntimeCheckpointManager`	Manager	Creates, lists, and deletes runtime checkpoints asynchronously.

Shared

Component	Role	Description
`CheckpointInfo`	Model	Checkpoint metadata returned by the Runta API.
`CommandResult`	Model	Buffered command result returned by runtime execution methods.
`DefaultSecretStubInfo`	Model	Default secret stub metadata copied to new runtimes.
`RuntimeInfo`	Model	Runtime metadata returned by the Runta API.
`SecretInfo`	Model	Stored tenant secret metadata.
`SecretStubInfo`	Model	Runtime-scoped secret stub metadata.
`CreateRuntimeResourceRequests`	Configuration	Resource requests accepted while creating a runtime.
`CreateRuntimeResources`	Configuration	Structured resource configuration used while creating a runtime.
`EgressPolicy`	Configuration	Network egress policy attached to a runtime.
`IngressSpec`	Configuration	Ingress protocol and runtime port mapping.
`PatchRuntimeResourceRequests`	Configuration	Resource requests accepted while updating a runtime.
`PatchRuntimeResources`	Configuration	Structured resource configuration used while updating a runtime.
`RuntimeResourceLimits`	Configuration	Maximum runtime memory allocation.
`RuntimeResourceRequests`	Configuration	Requested runtime memory and CPU allocation.
`RuntimeResources`	Configuration	Effective runtime resource requests and limits.
`SecretStubConfig`	Configuration	Header or query-parameter injection configuration for a secret stub.
`CheckpointState`	Enum	Creation state reported for a checkpoint.
`EgressMode`	Enum	Supported runtime egress policy modes.
`RuntimeStatus`	Enum	Lifecycle state reported for a runtime.
`ApiError`	Error	Control-plane RPC failed.
`CommandError`	Error	A runtime command failed.
`ConfigError`	Error	Configuration is missing or invalid.
`RuntaError`	Error	Base class for SDK errors.