vastai

# vastai Manage GPU instances, templates, volumes, serverless endpoints, SSH keys, and billing on Vast.ai. > Command is `vastai` (lowercase). Always use `--raw` for machine-readable JSON output. ## Install ```bash # PyPI (recommended) pip install vastai ``` ## Quick start ```bash vastai set api-key <YOUR_API_KEY> # Authenticate (one-time); Create API Key in account at https://console.vast.ai/manage-keys/ vastai show user # Verify auth + check balance vastai create ssh-key ~/.ssh/id_ed25519.pub # Register SSH key (do BEFORE create) vastai search offers 'gpu_name=RTX_4090 num_gpus=1 verified=true direct_port_count>=1 rentable=true' -o 'dlperf_usd-' # Note the offer ID from the output vastai create instance <OFFER_ID> --image pytorch/pytorch:@vastai-automatic-tag --disk 20 --ssh --direct # Automatically grab appropriate image tag; Response: {"success": true, "new_contract": <INSTANCE_ID>} vastai show instance <INSTANCE_ID> # Poll until actual_status == "running" (see Instance status values below) vastai ssh-url <INSTANCE_ID> # Get SSH connection string vastai copy local:./data/ <INSTANCE_ID>:/workspace/ # Upload files vastai destroy instance <INSTANCE_ID> -y # Clean up (stops all billing; -y skips confirmation) ``` API key: https://console.vast.ai/manage-keys/ ## Global flags Available on every command: ``` --api-key KEY Override stored API key --raw ...