Getting Started

For humans

Create and Export Your API Keys

Sign in to the Runta dashboard, then create and copy a key from Settings → Runta API Keys.

export RUNTA_TOKEN="rt..."

Install Runta Tools

Runta setup currently targets macOS and Linux. Windows is not supported yet.

CLI

Linux:

npm install -g @runta/runta-cli

macOS (Apple silicon):

brew install runta-dev/tap/runta

Python SDK

Install the Python SDK:

With pip:

pip install runta-sdk

Or with uv:

uv pip install runta-sdk

TypeScript SDK

Install the TypeScript SDK:

npm install @runta/runta-sdk

Start Your First Runtime

CLI

runta run --name demo --cpus 2 --memory 2048
runta exec demo -- python3 -c 'print("Hello from Runta")'
runta rm demo

Python SDK

quickstart.py

from runta import Runta

with Runta() as runta:
    runtime = runta.runtimes.create(
        "demo",
        vcpus=2,
        memory_mib=2048,
    )
    try:
        result = runtime.exec('python3 -c \'print("Hello from Runta")\'')
        print(result.stdout_text)
    finally:
        runtime.delete()

TypeScript SDK

quickstart.ts

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

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

try {
  const result = await runtime.exec('python3 -c \'print("Hello from Runta")\'');
  console.log(result.stdoutText);
} finally {
  await runtime.delete();
}

Create an Agent Runtime

Choose either the dashboard or the CLI to create an agent runtime.

Create an Agent in the Dashboard

Open the Runta dashboard, create a runtime, set its name and compute resources, then choose an agent such as Codex CLI, Claude Code, or OpenClaw.

CREATE RUNTIMEDashboard preview

Create runtime

Set the runtime details, compute resources, and agent setup.

Open dashboard →

Runtime details Name: my-runtimeCPU 1 vCPUMemory 2 GiB

Agent Setup

Clean runtime

Codex CLI

Claude Code

OpenClaw

Create a Codex Runtime with the CLI

Create an OpenAI API key.

Pass the --agent parameter when creating a runtime. Runta installs and configures the selected coding agent automatically.

Store the exported OpenAI API key in Runta once, then create the runtime:

runta secret set OPENAI_API_KEY --value-env OPENAI_API_KEY
runta run --name codex-demo --cpus 2 --memory 2048 --agent codex

The Codex agent preset automatically installs Codex and injects the stored credential into matching OpenAI requests without exposing the real key inside the runtime.

For agents

Create and Export Your API Keys

Sign in to the Runta dashboard, then create and copy a key from Settings → Runta API Keys. Create an OpenAI API key, then export both keys in your shell:

export RUNTA_TOKEN="rt..."
export OPENAI_API_KEY="sk-..."

Set up a Coding Agent with Pi