Getting Started

Create a Runta account and token

export RUNTA_TOKEN=<tenant_token>

Install Runta tools

Install the Linux CLI package:

npm install -g @runta/runta-cli

The npm CLI package currently targets Linux x64 and Linux arm64. If npm cannot resolve the matching native optional dependency, or if you use another platform, use the CLI artifact from your Runta account or release channel, then place it on your PATH:

mkdir -p ~/.local/bin
chmod +x runta
mv runta ~/.local/bin/runta

Install the Python SDK:

With pip:

pip install runta-sdk

Or with uv:

uv pip install runta-sdk

Use the published package from your workspace release channel when you are not working from the SDK source repository.

Install the TypeScript SDK:

npm install @runta/runta-sdk

Use the published package from your workspace release channel when you are not working from the SDK source repository.

Start your first runtime

Create a runtime named hello with 2 vCPUs and 2048 MiB of memory, then run a command inside it.

runta run --name hello --cpus 2 --memory 2048
runta exec hello -- echo "Hello from Runta"

from runta import Runta

with Runta() as runta:
    runtime = runta.runtimes.create("hello", vcpus=2, memory_mib=2048)

    result = runtime.exec('echo "Hello from Runta"')
    print(result.stdout_text)

import { Runta } from "@runta/runta-sdk";

const runta = new Runta();
const runtime = await runta.runtimes.create("hello", {
  vcpus: 2,
  memoryMiB: 2048,
});

const result = await runtime.exec('echo "Hello from Runta"');
console.log(result.stdoutText);