Volume

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

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

from glac import DriveMount, 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

   Crea un volume

   Si fatturano solo i dati scritti al suo interno.

   glac drives create --name data \
     --size-bytes 10GiB

   curl $API/drives -H "$AUTH" \
     --json '{"name": "data", "size_bytes": 10737418240}'

   drive = glac.drives.create(name="data", size_bytes=10 << 30)

   const drive = await glac.drives.create(
     { name: "data", sizeBytes: 10 * 2 ** 30 });

   drive_create {"name": "data", "size_gib": 10}

2. 02

   Montalo e scrivici

   In una sandbox, nel percorso che scegli.

   glac sandboxes create --name web \
     --drive data:/data
   glac sandboxes exec web -- \
     sh -c 'echo kept > /data/note'

   curl $API/sandboxes -H "$AUTH" --json '{"name": "web",
     "drives": [{"drive": "data", "path": "/data"}]}'
   curl $API/sandboxes/web/run -H "$AUTH" \
     --json '{"command": "echo kept > /data/note"}'

   mount = DriveMount("/data", drive)
   sbx = glac.sandboxes.create(drives=[mount])
   sbx.run("echo kept > /data/note")

   const mount = { path: "/data", drive: drive.id };
   const sbx = await glac.sandboxes.create(
     { drives: [mount] });
   await sbx.files.write("/data/note", "kept\n");

   drive_attach {"drive": "data", "sandbox": "web",
                 "path": "/data"}
   sandbox_run {"sandbox": "web",
                "command": "echo kept > /data/note"}

3. 03

   Passalo avanti

   Alla sandbox successiva, con ciò che contiene.

   glac drives detach data web
   glac sandboxes create --name next \
     --drive data:/data
   glac sandboxes exec next -- \
     cat /data/note

   curl -X DELETE $API/sandboxes/web/drives/data -H "$AUTH"
   curl $API/sandboxes -H "$AUTH" --json '{"name": "next",
     "drives": [{"drive": "data", "path": "/data"}]}'

   glac.drives.detach(sbx, drive)
   nxt = glac.sandboxes.create(drives=[mount])
   print(nxt.run("cat /data/note").stdout)

   await glac.drives.detach(sbx, drive);
   const nxt = await glac.sandboxes.create(
     { drives: [mount] });
   console.log(await nxt.files.readText("/data/note"));

   drive_detach {"drive": "data", "sandbox": "web"}
   drive_attach {"drive": "data", "sandbox": "next",
                 "path": "/data"}

Un volume appartiene a una sandbox alla volta, finché non viene scollegato. Un Cubo con un volume ha una sola istanza.