Skip to main content
Freestyle VMs are full Linux virtual machines for long-running agent tasks that can be paused, snapshotted and resumed. The following table shows what CostGraph runs on this provider.

​
Connect

Run the dispatcher with provider set to freestyle and these variables:
  • FREESTYLE_API_KEY
Sandbox size comes from the snapshot set as providerTemplate.

​
Key and permissions

FREESTYLE_API_KEY is a Freestyle account API key, minted with npx freestyle@latest tokens create <name> after “freestyle login” (shown once; list/revoke with freestyle tokens list/revoke). Keys are not scoped: “tokens create” takes only a name, and an account API key “already belongs to one team” with access to that team’s VMs. No per-key permissions are documented (per-end-user identity tokens are a separate mechanism). Sources: www.freestyle.sh: quickstart, www.freestyle.sh: cli, www.freestyle.sh: lifecycle, www.freestyle.sh: pricing and limits.

​
Limits

  • Idle timeout (idleTimeoutSeconds) pauses VMs with no network activity when configured; optional ttlSeconds, maxRunSeconds and maxRunTotalSeconds pause or delete VMs; -1 removes a limit. (source)
  • Max per VM: Free 4 vCPU / 8 GiB / 32 GB, Hobby 8 vCPU / 16 GiB / 64 GB, Pro 32 vCPU / 64 GiB / 256 GB; concurrent VMs Free 10, Hobby 40, Pro 400. (source)
  • On Free, exhausting a monthly compute allowance pauses affected VMs. (source)