Quickstart

from tensorlake.sandbox import SandboxClient

client = SandboxClient()

# Ephemeral sandbox — no name, terminates when done, cannot be suspended
sandbox = client.create_and_connect(cpus=2.0, memory_mb=2048, timeout_secs=600)

# Named sandbox — can be suspended and resumed between tasks
sandbox = client.create_and_connect(name="my-agent-env", cpus=2.0, memory_mb=2048)

# List sandboxes and copy the sandbox ID
for sb in client.list():
    print(sb.sandbox_id, sb.status)

# Run code inside the sandbox
result = sandbox.run("python", ["-c", "print('Hello from sandbox')"])
print(result.stdout)

# Copy files in or out as the sandbox accumulates state
sandbox.write_file("/workspace/local-file.txt", b"example content")
file_bytes = bytes(sandbox.read_file("/workspace/local-file.txt"))
print(file_bytes.decode("utf-8"))

# Save a checkpoint you can return to later
snapshot = client.snapshot_and_wait(sandbox.sandbox_id)
print(snapshot.snapshot_id)

# Branching from a running sandbox (`tl sbx clone`) is not supported in the Python SDK.
# Suspending a named sandbox (`tl sbx suspend`) is not supported in the Python SDK.
# Ephemeral sandboxes cannot be suspended regardless of SDK or CLI.

# Terminate it when the work is finished
client.delete(sandbox.sandbox_id)

import { SandboxClient } from "tensorlake";

const client = SandboxClient.forCloud({
  apiKey: process.env.TENSORLAKE_API_KEY,
});

// Ephemeral sandbox — no name, terminates when done, cannot be suspended
const ephemeral = await client.create({
  cpus: 2.0,
  memoryMb: 2048,
  timeoutSecs: 600,
});
console.log(ephemeral.sandboxId, ephemeral.status);

// Create a named sandbox (can be suspended and resumed between tasks)
const sandbox = await client.createAndConnect({
  name: "my-agent-env",
  cpus: 2.0,
  memoryMb: 2048,
  timeoutSecs: 600,
});

for (const sb of await client.list()) {
  console.log(sb.sandboxId, sb.status);
}

// Run code inside the sandbox
const result = await sandbox.run("python", {
  args: ["-c", "print('Hello from sandbox')"],
});
console.log(result.stdout);

// Copy files in or out as the sandbox accumulates state
await sandbox.writeFile(
  "/workspace/local-file.txt",
  new TextEncoder().encode("example content"),
);
const fileBytes = await sandbox.readFile("/workspace/local-file.txt");
console.log(new TextDecoder().decode(fileBytes));

// Save a checkpoint you can return to later
const snapshot = await client.snapshotAndWait(sandbox.sandboxId);
console.log(snapshot.snapshotId);

await client.suspend("my-agent-env");
await client.resume("my-agent-env");

// Branching from a running sandbox (`tl sbx clone`) is not yet exposed in the TypeScript SDK.
// Ephemeral sandboxes cannot be suspended regardless of SDK or CLI.

await sandbox.terminate();
await client.delete(ephemeral.sandboxId);
client.close();