Getting Started

For humans
For agents

Create a Runta Account and API Key

export RUNTA_TOKEN=rt...

Install Runta Tools

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

Linux:

npm install -g @runta/runta-cli

macOS (Apple silicon):

brew install runta-dev/tap/runta

Install the Python SDK:

With pip:

pip install runta-sdk

Or with uv:

uv pip install runta-sdk

Install the TypeScript SDK:

npm install @runta/runta-sdk

Start Your First Runtime

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

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

from runta import Runta

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

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('echo "Hello from Runta"');
  console.log(result.stdoutText);
} finally {
  await runtime.delete();
}

Each example deletes the runtime after the command finishes. If you stop an example before cleanup runs, delete the runtime manually with runta rm demo to stop storage billing.

Install Runta via Agents

Copy this prompt into your coding agent:

Install and configure Runta for this project without interactive prompts.

1. From the project root, install all Runta skills for all detected agents:
   npx --yes skills add https://next.runta.dev/docs --all
2. Load and follow the installed runta-installer skill.
3. Detect the operating system, architecture, package manager, and project languages, then install the appropriate Runta CLI and SDK packages.
4. Check that RUNTA_TOKEN is configured without printing its value, verify the installed CLI or SDK imports, and report what was installed.

Do not use interactive installers or ask installation questions. Choose the appropriate defaults from the repository and environment. Never print or commit credentials.