サンドボックス

curl -fsSL https://glac.ai/install.sh | sh
export GLAC_API_KEY=ak_...

API=https://api.glac.ai/v1/sandboxes
AUTH="Authorization: Bearer $GLAC_API_KEY"

from glac import Glac
glac = Glac()

import { Glac } from "glac";
const glac = new Glac();

# give your agent the tools (Claude Code here)
claude mcp add glac -e GLAC_API_KEY=ak_... -- npx glac-mcp

1. 01

   作成する

   任意のイメージから、専用のマシンを。

   glac sandboxes create --name web \
     --image python:3.12

   curl $API -H "$AUTH" \
     --json '{"name": "web", "image": "python:3.12"}'

   sbx = glac.sandboxes.create(name="web", image="python:3.12")

   const sbx = await glac.sandboxes.create(
     { name: "web", image: "python:3.12" });

   # no call of its own: the first sandbox_run
   # that names "web" makes it, from the image

2. 02

   中で実行する

   コマンドとファイル操作を、必要なだけ。

   glac sandboxes exec web -- \
     pip install pandas

   curl $API/web/run -H "$AUTH" \
     --json '{"command": "pip install pandas"}'

   print(sbx.run("pip install pandas").stdout)

   console.log((await sbx.run("pip install pandas")).stdout);

   sandbox_run {"sandbox": "web", "image": "python:3.12",
                "command": "pip install pandas"}

3. 03

   丸ごと保存してフォークする

   メモリ、プロセス、ディスクを、そこから続きを実行できるコピーに。

   glac sandboxes snapshots create web \
     --name ready
   glac sandboxes fork web --count 16

   curl $API/web/snapshots -H "$AUTH" \
     --json '{"name": "ready"}'
   curl $API/web/fork -H "$AUTH" --json '{"count": 16}'

   snap = sbx.snapshot(name="ready")
   copies = sbx.fork(16)

   const snap = await sbx.snapshot({ name: "ready" });
   const copies = await sbx.fork(16);

   sandbox_snapshot {"sandbox": "web", "name": "ready"}
   sandbox_fork {"sandbox": "web", "count": 16}

ID が使える場所ではどこでも名前を使えます。復帰させるための呼び出しはなく、スリープ中のサンドボックスを必要とする操作が、そのまま復帰させます。