Runta SDK
Runta SDKs wrap the same REST API used by the CLI. Use them when application code needs to create runtimes, execute commands, move files, configure egress, inject credentials, or manage checkpoints.
Packages
Section titled “Packages”| Language | Package | Primary client | Execution style |
|---|---|---|---|
| Python | runta-sdk | Runta, AsyncRunta | Sync and async |
| TypeScript | @runta/runta-sdk | Runta | Async |
Shared Configuration
Section titled “Shared Configuration”Both SDKs use the same hosted endpoint and token model:
export RUNTA_ENDPOINT=https://api.runta.devexport RUNTA_TOKEN=<tenant_token>RUNTA_ENDPOINT is optional when using the hosted API. Set it when targeting a
local, staging, or self-hosted API.
Interface Families
Section titled “Interface Families”| Area | Python SDK | TypeScript SDK |
|---|---|---|
| Runtimes | runta.runtimes, runtime | runta.runtimes, runtime |
| Command execution | runtime.exec(), runtime.exec_detached() | runtime.exec() |
| Files | runtime.files | runtime.files |
| Egress | runtime.egress | runtime.egress |
| Audits | runtime.audits | REST API today |
| Secrets | runta.secrets, runtime.secrets | runta.secrets |
| Checkpoints | runta.checkpoints, runtime.checkpoints | runtime.checkpoints, runtime.restore() |
For HTTP route details and request/response schemas, use the Runta REST API reference.