| name | search-gpus |
| description | Search for available GPU machines on Vast.ai. Use when looking for GPUs to rent, comparing GPU pricing, or finding machines that match specific requirements. |
| argument-hint | [gpu-type or requirements] |
| allowed-tools | Bash |
Search Vast.ai GPU Offers
Help the user find the best GPU offers on Vast.ai.
User Request
$ARGUMENTS
Instructions
-
Understand requirements: Key dimensions to determine:
- GPU model (RTX 4090, A100, H100, etc.)
- Number of GPUs
- VRAM requirements
- Budget ($/hr)
- Region preferences
- Reliability needs
- Pricing type (on-demand vs spot/interruptible vs reserved)
-
Build the search query from the mapping below.
-
Run the search and present results clearly.
-
Help interpret: Highlight best options based on user priorities.
Query Construction
| User says | Query field |
|---|
| "4090", "RTX 4090" | gpu_name=RTX_4090 |
| "A100 80GB" | gpu_name=A100 gpu_ram>=80 |
| "H100" | gpu_name=H100 |
| "4 GPUs", "multi-GPU" | num_gpus>=4 |
| "at least 48GB VRAM" | gpu_total_ram>=48 |
| "under $1/hr", "cheap" | dph_total<1.0 |
| "reliable" | reliability>0.95 |
| "US only" | geolocation=US |
| "datacenter" | datacenter=true |
| "spot", "interruptible" | add -b flag |
| "reserved" | add -r flag |
| "NVLink" | bw_nvlink>0 |
| "fast internet" | inet_down>500 |
Always include reliability>0.9 unless the user wants cheaper unreliable machines.
Default sort: -o 'dph_total' (cheapest first).
Examples
vastai search offers 'gpu_name=RTX_4090 num_gpus=1 reliability>0.9' -o 'dph_total'
vastai search offers 'gpu_name=H100 num_gpus=8 reliability>0.95' -o 'dph_total'
vastai search offers 'gpu_total_ram>=80 geolocation=US datacenter=true reliability>0.95' -o 'dph_total'
vastai search offers 'num_gpus>=2 gpu_ram>=24 dph_total<1.5 reliability>0.9' -o 'dph_total'
vastai search offers 'gpu_name=H100 num_gpus>=4' -b -o 'dph_total'
Presenting Results
After running the search:
- Summarize top 3-5 options in a clear table with: Offer ID, GPU, # GPUs, VRAM, $/hr, Reliability, Location
- Highlight the offer ID prominently — user needs it to launch
- Note trade-offs (price vs reliability vs perf)
- Mention spot pricing if it would save significantly
- If no results, suggest relaxing constraints