Vast.ai Python SDK & CLI
The official Vast.ai Python package — provides both the CLI and SDK for managing Vast.ai GPU cloud resources, plus a serverless client for endpoint inference.
Install
pip install vastai
Note:
pip install vastai-sdkalso works and installs the same package. Both package names are supported for backward compatibility.
Quickstart
-
Get your API key from https://cloud.vast.ai/manage-keys/
-
Set your API key:
vastai set api-key YOUR_API_KEY
- Test a search:
vastai search offers --limit 3
You should see a short list of available GPU offers.
CLI Usage
The vastai command provides full access to the Vast.ai platform from your terminal:
vastai search offers 'gpu_name=RTX_4090 num_gpus>=4'
vastai create instance 12345 --image pytorch/pytorch --disk 32 --ssh --direct
vastai show instances
vastai stop instance 12345
vastai destroy instance 12345
Run vastai --help for a full list of commands. You can also use --help on any subcommand:
vastai search offers --help
vastai create instance --help
SDK Usage
from vastai import VastAI
vast = VastAI() # uses VAST_API_KEY env var, or pass api_key="..."
vast.search_offers(query='gpu_name=RTX_4090 num_gpus>=4')
vast.show_instances()
vast.start_instance(id=12345)
vast.stop_instance(id=12345)
Use help(vast.search_offers) to view documentation for any method.
Migrating from
vastai-sdk? The old import still works:from vastai_sdk import VastAI
Using the Serverless Client
- Create the client
from vastai import Serverless
serverless = Serverless() # or, Serverless("YOUR_API_KEY")
- Get an endpoint
endpoint = await serverless.get_endpoint("my-endpoint")
- Make a request
request_body = {
"model": "Qwen/Qwen3-8B",
"prompt" : "Who are you?",
"max_tokens" : 100,
"temperature" : 0.7
}
response = await serverless.request("/v1/completions", request_body)
- Read the response
text = response["response"]["choices"][0]["text"]
print(text)
Find more examples in the examples/ directory.
Tab Completion
Tab completion is supported in Bash and Zsh via argcomplete (installed automatically). To enable it:
activate-global-python-argcomplete
Or for a single session:
eval "$(register-python-argcomplete vastai)"
AI Agents
Vast.ai has a skill for AI coding agents (Claude Code, Cursor, Windsurf, Codex, etc.):
npx skills add vast-ai/vast-cli
This installs the Vast.ai skill so your agent can search offers, create instances, and manage GPU workflows directly. See CLI SKILL.md or SDK SKILL.md for the full reference.
Contributing
This repository is open source. If you find a bug, please open an issue. PRs are welcome.
3 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vastai-1.4.4.tar.gz.
File metadata
- Download URL: vastai-1.4.4.tar.gz
- Upload date:
- Size: 258.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/2.4.1 CPython/3.12.13 Linux/6.17.0-1020-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5dc7c6a0d624c313f602d792543e35d44593add236dc237dda884f73c457fd8e
|
|
| MD5 |
26f789caa32d5ea5976140dd36cc1ed8
|
|
| BLAKE2b-256 |
43611f2a883764da2941581bfe2a75c204c39354cfc2aa37541ba903fccf6ca2
|
File details
Details for the file vastai-1.4.4-py3-none-any.whl.
File metadata
- Download URL: vastai-1.4.4-py3-none-any.whl
- Upload date:
- Size: 295.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/2.4.1 CPython/3.12.13 Linux/6.17.0-1020-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
391b91e2a7923184e73e49268755ee2dff0cb0023ec633b295cd4cc92499296f
|
|
| MD5 |
51572638d5106c09a065b16be6092f23
|
|
| BLAKE2b-256 |
e1f3568cdf64104d775ddcb26805d7dd0e9a010f0c2e31bbea294f6adfe43da3
|
