Installation - Runtools.ai

Requirements

Node.js 20+ or Bun 1.0+
TypeScript 5+
An API key from the dashboard or runtools auth keys create

Install

npm install @runtools-ai/sdk

Configure Auth

.env

RUNTOOLS_API_KEY=rt_live_xxx

import { RunTools } from '@runtools-ai/sdk';

export const rt = new RunTools({
  apiKey: process.env.RUNTOOLS_API_KEY,
});

Options

const rt = new RunTools({
  apiKey: process.env.RUNTOOLS_API_KEY,
  apiUrl: 'https://api.runtools.ai',
  authUrl: 'https://auth.runtools.ai',
  toolsUrl: 'https://tools.runtools.ai',
});

Verify

const page = await rt.sandbox.listPage({ limit: 5 });
console.log(page.data.length, page.hasMore);

Framework Example

app/api/sandboxes/route.ts

import { RunTools } from '@runtools-ai/sdk';

const rt = new RunTools({ apiKey: process.env.RUNTOOLS_API_KEY });

export async function POST() {
  const sandbox = await rt.sandbox.create({ template: 'base-ubuntu' });
  return Response.json({ id: sandbox.id });
}

Keep API keys in server-side code only.