Quickstart

npm install @lelantos-ai/sdk

import { LelantosClient } from "@lelantos-ai/sdk";

const client = new LelantosClient({
  apiKey: process.env.LELANTOS_API_KEY!,
});

const sandbox = await client.createSandbox({
  templateID: "base",
});

console.log("Sandbox ID:", sandbox.sandboxID);
console.log("URL:", sandbox.getURL());

// Upload a file
await sandbox.uploadFile("/home/user/hello.txt", "Hello from Lelantos!");

// Download it back
const data = await sandbox.downloadFile("/home/user/hello.txt");
console.log(new TextDecoder().decode(data));

// Extend lifetime by 1 hour
await sandbox.refresh(3600);

// Pause to save resources (resume later)
await sandbox.pause();

// Resume when needed
await sandbox.resume();

// Clean up when done
await sandbox.kill();

const events = await sandbox.getLogs();
for (const ev of events.logs) {
  console.log(`[${ev.timestamp}] ${ev.line}`);
}
// [2026-03-06T10:00:52Z] sandbox.lifecycle.created
// [2026-03-06T10:00:52Z] sandbox.lifecycle.killed

const template = await client.createTemplate({
  dockerfile: "FROM python:3.12\nRUN pip install numpy pandas",
  alias: "data-science",
  cpuCount: 4,
  memoryMB: 2048,
});

console.log("Template:", template.templateID);
console.log("Build:", template.buildID);

// Check build status
const status = await client.getTemplateBuildStatus(
  template.templateID,
  template.buildID,
);
console.log("Status:", status.status); // "building" | "ready" | "error"

# Create a sandbox
curl -X POST https://api.lelantos.ai/sandboxes \
  -H "X-API-Key: lel_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"templateID": "base"}'

# List running sandboxes
curl https://api.lelantos.ai/sandboxes \
  -H "X-API-Key: lel_your_key_here"

# Kill a sandbox
curl -X DELETE https://api.lelantos.ai/sandboxes/SANDBOX_ID \
  -H "X-API-Key: lel_your_key_here"