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

   Crie um volume

   Só os dados gravados nele são cobrados.

   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

   Monte-o e grave nele

   Em um sandbox, no caminho que você escolher.

   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

   Passe adiante

   Para o próximo sandbox, com o que ele contém.

   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"}

Um volume pertence a um sandbox de cada vez, até ser desanexado. Um Cubo com volume tem uma única instância.