Durable workspaces
Persist data across runs with explicitly created storage that bills until deletion.
A workspace is durable storage, separate from ephemeral compute and warm cache. Use one only when data must survive after a machine stops.
Quote before creating
amics workspace quote --capacity-gb 100 --location europeThe quote is read-only. Workspace storage bills continuously from creation until deletion.
Create and attach
amics workspace create \
--name research \
--capacity-gb 100 \
--location europe
amics run \
--workspace WORKSPACE_ID \
[COMPUTE_OPTIONS] \
-- python train.pyThe attached workspace rate appears in the acquisition approval because it continues after compute stops.
Inspect and manage
amics workspace list
amics workspace get WORKSPACE_ID
amics workspace snapshots WORKSPACE_ID
amics workspace rename WORKSPACE_ID --name new-nameEach command prints one JSON document. list and snapshots print JSON arrays,
which makes workspace commands straightforward for agents and scripts to parse.
Delete
amics workspace delete WORKSPACE_IDDeletion removes the workspace and all of its data. It is irreversible. An
interactive terminal asks for confirmation; a non-interactive caller must pass
--yes after explicit approval.
Choose the right storage
| Need | Use |
|---|---|
| Package and model download cache during one warm window | Default project cache |
| Dataset or checkpoints after compute stops | Durable workspace |
| Shared or very large external data | External object or dataset storage |
| Files back in the local Git tree | Write or download them explicitly; Amics does not sync artifacts back |