Quickstart

Install

Install BLAST on the local or BYOC machine:

bash

cargo install blast_core
blast

Configure a pool

Configure a pool of CPU, memory, and disk:

bash

cat > blast.toml <<'EOF'
[worker.resources]
vcpu = 8
memory_mib = 16384
disk_mib = 102400
EOF

blast --config blast.toml

Fork and run

Invoke the BLAST API to fork and run sandboxes:

bash

VM1=$(curl -s -X POST localhost:7240/v1/fork \
  -H "Content-Type: application/json" \
  -d '{"image":"ubuntu:24.04"}' | jq -r .vm_id)

VM2=$(curl -s -X POST localhost:7240/v1/fork \
  -H "Content-Type: application/json" \
  -d "{\"source_vm_id\":\"$VM1\",\"name\":\"feature-xyz\"}" | jq -r .vm_id)

curl -X POST localhost:7240/v1/vms/$VM2/runs \
  -H "Content-Type: application/json" \
  -d '{"command":"echo hello from fork"}'