Project Links

Meta

Author: Chris McKenzie

Requires Python: >=3.9

Classifiers

Programming Language

Python :: 3
Python :: 3.9
Python :: 3.10
Python :: 3.11
Python :: 3.12
Python :: 3.13
Python :: 3.14

Vast.ai Python SDK

This package is deprecated. It has been merged into vast-ai/vast-cli. pip install vastai now installs both the SDK and CLI in a single package. pip install vastai-sdk still works and installs the same package. For issues and PRs, go to vast-ai/vast-cli.

Install

pip install vastai-sdk

Quickstart

Get your API key from https://cloud.vast.ai/manage-keys/
Set your API key:

from vastai_sdk import VastAI
vast = VastAI(api_key="YOUR_API_KEY")

Or set the VAST_API_KEY environment variable and just use:

vast = VastAI()

SDK Usage

Both of these work identically:

from vastai_sdk import VastAI
from vastai import VastAI

Both of these also work identically:

from vastai import Serverless
from vastai_sdk.serverless.client.client import Serverless

vast = VastAI()

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.

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.

Contributing

This repo is deprecated. For issues, PRs, and documentation, go to vast-ai/vast-cli.

1.0.0.dev2 Mar 24, 2026

1.0.0.dev1 Mar 24, 2026

0.4.3.dev4 Jan 27, 2026

0.4.3.dev2 Jan 26, 2026

0.4.3.dev1 Jan 23, 2026

0.4.2 Jan 21, 2026

0.4.2.dev3 Jan 14, 2026

0.4.2.dev2 Jan 14, 2026

0.4.2.dev1 Dec 31, 2025

0.4.1.dev1 Dec 18, 2025

0.3.6.dev1 Dec 19, 2025

0.3.4.dev2 Dec 19, 2025

0.3.4.dev1 Dec 19, 2025

0.3.3.dev4 Dec 20, 2025

0.3.3.dev3 Dec 20, 2025

0.3.3.dev2 Dec 19, 2025

0.3.3.dev1 Dec 18, 2025

Wheel compatibility matrix

Platform	Python 3
any

Files in release

vastai_sdk-1.5.1-py3-none-any.whl (2.1KiB)

vastai_sdk-1.5.1.tar.gz (1.7KiB)

Extras: None

Dependencies:

vastai (==1.5.1)

vastai-sdk 1.5.1