Quickstart

curl -sS -X POST http://localhost:7423/api/v1/sandboxes \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ${STACYVM_API_KEY}" \
  -d '{"image":"python:3.12","ttl":"10m","memory_mb":512,"vcpus":1}'

from stacyvm import Client

client = Client(
    base_url="http://localhost:7423",
    api_key="sk_test_YOUR_API_KEY",
)

sandbox = client.spawn(
    image="python:3.12",
    ttl="10m",
    memory_mb=512,
    vcpus=1,
)
print(sandbox.id)

import { Client } from "stacyvm";

const client = new Client({
  baseUrl: "http://localhost:7423",
  apiKey: "sk_test_YOUR_API_KEY",
});

const sandbox = await client.spawn({
  image: "python:3.12",
  ttl: "10m",
  memory_mb: 512,
  vcpus: 1,
});
console.log(sandbox.id);

curl -sS -X POST "http://localhost:7423/api/v1/sandboxes/${SANDBOX_ID}/exec" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ${STACYVM_API_KEY}" \
  -d '{"command":"python3 -c \"print(40 + 2)\"","timeout":"10s"}'

result = sandbox.exec("python3 -c 'print(40 + 2)'", timeout="10s")
print(result.stdout)

const result = await sandbox.exec("python3 -c 'print(40 + 2)'", {
  timeout: "10s",
});
console.log(result.stdout);

curl -sS -X PUT "http://localhost:7423/api/v1/sandboxes/${SANDBOX_ID}/files/app/main.py" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ${STACYVM_API_KEY}" \
  -d '{"content":"name = \"StacyVM\"\\nprint(f\"hello from {name}\")\\n","mode":"644"}'

sandbox.write_file(
    "/app/main.py",
    'name = "StacyVM"\nprint(f"hello from {name}")\n',
)
print(sandbox.exec("python3 /app/main.py").stdout)

await sandbox.writeFile(
  "/app/main.py",
  'name = "StacyVM"\nprint(f"hello from {name}")\n',
);
console.log((await sandbox.exec("python3 /app/main.py")).stdout);

curl -sS -X DELETE "http://localhost:7423/api/v1/sandboxes/${SANDBOX_ID}" \
  -H "X-API-Key: ${STACYVM_API_KEY}"

sandbox.destroy()

await sandbox.destroy();