Skip to content

vast-ai/vast-cli / vastai

vastai

Flagged

Vast.ai CLI to manage GPU instances, volumes, serverless endpoints, and billing.

FileKindSize
SKILL.mdskill md18.6 KB
__init__.pyscript1.8 KB
_base.pyscript1.6 KB
api/__init__.pyscript31 B
api/auth.pyscript15.3 KB
api/billing.pyscript10.4 KB
api/client.pyscript9.1 KB
api/clusters.pyscript4.5 KB
api/deployments.pyscript1.4 KB
api/endpoints.pyscript12.0 KB
api/instances.pyscript17.1 KB
api/keys.pyscript4.3 KB
api/machines.pyscript7.4 KB
api/metrics.pyscript2.6 KB
api/offers.pyscript21.2 KB
api/price_increase.pyscript4.0 KB
api/query.pyscript12.2 KB
api/storage.pyscript14.5 KB
api/teams.pyscript4.4 KB
async_/__init__.pyscript79 B
async_/client.pyscript9.6 KB
async_/results.pyscript1.3 KB
cli/__init__.pyscript25 B
cli/commands/__init__.pyscript757 B
cli/commands/auth.pyscript42.8 KB
cli/commands/benchmarks.pyscript42.0 KB
cli/commands/billing.pyscript30.4 KB
cli/commands/clusters.pyscript7.8 KB
cli/commands/deployments.pyscript7.8 KB
cli/commands/endpoints.pyscript17.3 KB
cli/commands/instances.pyscript55.4 KB
cli/commands/keys.pyscript7.9 KB
cli/commands/machines.pyscript78.4 KB
cli/commands/metrics.pyscript12.7 KB
cli/commands/misc.pyscript11.0 KB
cli/commands/offers.pyscript30.0 KB
cli/commands/price_increase.pyscript14.5 KB
cli/commands/repl.pyscript719 B
cli/commands/storage.pyscript38.9 KB
cli/commands/teams.pyscript6.4 KB
cli/commands/uninstall.pyscript2.4 KB
cli/commands/update.pyscript3.1 KB
cli/display.pyscript20.1 KB
cli/main.pyscript11.5 KB
cli/parser.pyscript18.1 KB
cli/repl/__init__.pyscript318 B
cli/repl/bridge.pyscript7.3 KB
cli/repl/catalog.pyscript6.3 KB
cli/repl/completion.pyscript8.2 KB
cli/repl/session.pyscript7.3 KB
cli/self_test/__init__.pyscript46 B
cli/self_test/machine_diagnostics.pyscript21.0 KB
cli/self_test/runtime_diagnostics.pyscript18.6 KB
cli/self_test/support_bundle.pyscript11.0 KB
cli/selfupdate.pyscript14.0 KB
cli/util.pyscript26.3 KB
cli/utils.pyscript577 B
data/__init__.pyscript303 B
data/deployment.pyscript3.5 KB
data/endpoint.pyscript2.1 KB
data/instance.pyscript3.6 KB
data/offer.pyscript4.4 KB
data/query.pyscript12.8 KB
data/workergroup.pyscript1.4 KB
pdf/__init__.pyscript0 B
pdf/vast.ai-logo-50pct.pngbinary7.4 KB
pdf/vast.ai-logo.pngbinary10.1 KB
pdf/vast_pdf.pyscript19.4 KB
pdf/watcher.shexecutablescript390 B
sdk.pyscript52.2 KB
serverless/__init__.pyscript193 B
serverless/client/__init__.pyscript346 B
serverless/client/client.pyscript36.7 KB
serverless/client/connection.pyscript11.5 KB
serverless/client/endpoint.pyscript6.9 KB
serverless/client/managed.pyscript7.3 KB
serverless/client/request_status.pyscript371 B
serverless/client/session.pyscript2.8 KB
serverless/client/worker.pyscript1.3 KB
serverless/remote/__init__.pyscript245 B
serverless/remote/base.pyscript6.3 KB
serverless/remote/deploy.pyscript12.6 KB
serverless/remote/serialization.pyscript3.7 KB
serverless/remote/serve.pyscript8.6 KB
serverless/remote/serve_deployment.pyscript6.3 KB
serverless/remote/utils.pyscript9.7 KB
serverless/server/__init__.pyscript0 B
serverless/server/lib/__init__.pyscript0 B
serverless/server/lib/backend.pyscript43.3 KB
serverless/server/lib/data_types.pyscript10.6 KB
serverless/server/lib/metrics.pyscript12.2 KB
serverless/server/lib/server.pyscript3.2 KB
serverless/server/worker.pyscript17.1 KB
sync/__init__.pyscript76 B
sync/client.pyscript4.9 KB
sync/results.pyscript1.2 KB
utils.pyscript12.2 KB

api/billing.py

View on GitHub
"""Billing, user, and account API functions for the Vast.ai SDK."""

import time
from dateutil import parser as dateutil_parser


def parse_date_arg(value, param):
    """Parse a user-supplied date, or raise naming the argument."""
    try:
        return dateutil_parser.parse(str(value))
    except (ValueError, OverflowError) as exc:
        raise ValueError(
            f"{param}: could not parse {value!r} as a date. Use a format like "
            "'2026-08-24' or '2026-08-24 13:00:00'."
        ) from exc


def show_invoices(client, start_date=None, end_date=None, only_charges=False, only_credits=False):
    """Get billing history reports (deprecated endpoint).

    GET /users/me/invoices

    Args:
        client: VastClient instance.
        start_date (str, optional): Start date/time for report.
        end_date (str, optional): End date/time for report.
        only_charges (bool): Show only charge items. Default False.
        only_credits (bool): Show only credit items. Default False.

    Returns:
        dict: Invoice data including 'invoices' and 'current' charges.
    """
    end_timestamp = time.time()
    start_timestamp = time.time() - (24 * 60 * 60)

    if end_date:
        end_timestamp = parse_date_arg(end_date, "end_date").timestamp()
    if start_date:
        start_timestamp = parse_date_arg(start_date, "start_date").timestamp()

    query_args = {
        "owner": "me",
        "sdate": start_timestamp,
        "edate": end_timestamp,
        "inc_charges": not only_credits,
    }

    r = client.get("/users/me/invoices", query_args=query_args)
    r.raise_for_status()
    rj = r.json()

    rows = rj["invoices"]
    current_charges = rj["current"]

    if only_charges:
        rows = [row for row in rows if row.get("type") == "charge"]
    elif only_credits:
        rows = [row for row in rows if row.get("type") == "payment"]

    return {
        "invoices": rows,
        "current": current_charges,
    }


def show_invoices_v1(client, params):
    """Get billing (invoices/charges) history reports with advanced filtering.

    GET /api/v0/charges/ (for charges) or /api/v1/invoices/ (for invoices)

    Args:
        client: VastClient instance.
        params (dict): Request parameters including:
            charges (bool): If True, fetch charges; otherwise fetch invoices.
            start_date (int/str, optional): Start date (YYYY-MM-DD or timestamp).
            end_date (int/str, optional): End date (YYYY-MM-DD or timestamp).
            limit (int): Number of results per page. Default 20, max 100.
            next_token (str, optional): Pagination token for next page.
            latest_first (bool): Sort by latest first. Default False.
            charge_type (list, optional): Filter charge types (instance, volume, serverless).
            invoice_type (list, optional): Filter invoice types.
            format (str): Output format (table or tree). Default 'table'.

    Returns:
        dict: API response with 'results', 'count', 'total', and 'next_token'.
    """
    from datetime import datetime, timezone

    invoice_types_map = {
        "transfers": "transfer",
        "stripe": "stripe_payments",
        "bitpay": "bitpay",
        "coinbase": "coinbase",
        "crypto.com": "crypto.com",
        "reserved": "instance_prepay",
        "payout_paypal": "paypal_manual",
        "payout_wise": "wise_manual",
    }

    is_charges = params.get("charges", False)
    start_date = params.get("start_date")
    end_date = params.get("end_date")

    # Handle default start and end date values
    if not start_date and not end_date:
        end_date = int(time.time())
    if not start_date:
        end_date_val = end_date if isinstance(end_date, int) else int(
            datetime.strptime(str(end_date) + "+0000", '%Y-%m-%d%z').timestamp()
            if isinstance(end_date, str) and not str(end_date).isdigit()
            else int(end_date)
        )
        start_date = end_date_val - 7 * 24 * 60 * 60
    elif not end_date:
        start_date_val = start_date if isinstance(start_date, int) else int(
            datetime.strptime(str(start_date) + "+0000", '%Y-%m-%d%z').timestamp()
            if isinstance(start_date, str) and not str(start_date).isdigit()
            else int(start_date)
        )
        end_date = start_date_val + 7 * 24 * 60 * 60

    def to_timestamp(val):
        if isinstance(val, int):
            return val
        if isinstance(val, str):
            if val.isdigit():
                return int(val)
            return int(datetime.strptime(val + "+0000", '%Y-%m-%d%z').timestamp())
        raise ValueError("Invalid date format")

    start_timestamp = to_timestamp(start_date)
    end_timestamp = to_timestamp(end_date)

    # Build request parameters
    date_col = 'day' if is_charges else 'when'
    query_params = {
        'select_filters': {date_col: {'gte': start_timestamp, 'lte': end_timestamp}},
        'latest_first': params.get('latest_first', False),
        'limit': min(params.get('limit', 20), 100),
    }

    if is_charges:
        query_params['format'] = params.get('format', 'table')
        charge_types = params.get('charge_type', [])
        for ct in charge_types:
            filters = query_params['select_filters'].setdefault('type', {}).setdefault('in', [])
            if ct in {'i', 'instance'}:
                filters.append('instance')
            elif ct in {'v', 'volume'}:
                filters.append('volume')
            elif ct in {'s', 'serverless'}:
                filters.append('serverless')
    else:
        invoice_type_list = params.get('invoice_type', [])
        for it in invoice_type_list:
            filters = query_params['select_filters'].setdefault('service', {}).setdefault('in', [])
            if it in invoice_types_map:
                filters.append(invoice_types_map[it])

    next_token = params.get('next_token')
    if next_token:
        query_params['after_token'] = next_token

    endpoint = '/api/v0/charges/' if is_charges else '/api/v1/invoices/'
    r = client.get(endpoint, query_args=query_params)
    r.raise_for_status()
    return r.json()


def show_earnings(client, start_date=None, end_date=None, machine_id=None):
    """Get machine earning history reports.

    GET /users/me/machine-earnings

    Args:
        client: VastClient instance.
        start_date (str, optional): Start date/time for report.
        end_date (str, optional): End date/time for report.
        machine_id (int, optional): Machine ID to filter by.

    Returns:
        dict/list: Earnings data from the API.
    """
    Minutes = 60.0
    Hours = 60.0 * Minutes
    Days = 24.0 * Hours
    cday = time.time() / Days
    sday = cday - 1.0
    eday = cday - 1.0

    if end_date:
        eday = parse_date_arg(end_date, "end_date").timestamp() / Days
    if start_date:
        sday = parse_date_arg(start_date, "start_date").timestamp() / Days

    query_args = {
        "owner": "me",
        "sday": sday,
        "eday": eday,
        "machid": machine_id,
    }

    r = client.get("/users/me/machine-earnings", query_args=query_args)
    r.raise_for_status()
    return r.json()


def show_deposit(client, id):
    """Display reserve deposit info for an instance.

    GET /instances/balance/{id}/

    Args:
        client: VastClient instance.
        id (int): ID of instance to get deposit info for.

    Returns:
        dict: Deposit/balance information.
    """
    r = client.get(f"/instances/balance/{id}/", query_args={"owner": "me"})
    r.raise_for_status()
    return r.json()


def show_user(client):
    """Get current user data.

    GET /users/current

    Args:
        client: VastClient instance.

    Returns:
        dict: User data (with api_key removed).
    """
    r = client.get("/users/current")
    r.raise_for_status()
    user_blob = r.json()
    user_blob.pop("api_key", None)
    return user_blob


def set_user(client, params):
    """Update current user settings.

    PUT /users/

    Args:
        client: VastClient instance.
        params (dict): User settings to update. Possible keys include:
            ssh_key, api_key, billaddress_name, billaddress_addr1,
            billaddress_addr2, billaddress_city, billaddress_zip,
            billaddress_country, billaddress_taxinfo,
            balance_threshold_enabled, balance_threshold,
            autobill_threshold, phone_number.

    Returns:
        dict: API response data.
    """
    r = client.put("/users/", json_data=params)
    r.raise_for_status()
    return r.json()


def show_subaccounts(client):
    """Get current subaccounts.

    GET /subaccounts

    Args:
        client: VastClient instance.

    Returns:
        list: Subaccount user data.
    """
    r = client.get("/subaccounts", query_args={"owner": "me"})
    r.raise_for_status()
    return r.json()["users"]


def create_subaccount(client, email, username, password, host_only=False):
    """Create a subaccount.

    POST /users/

    Args:
        client: VastClient instance.
        email (str): Email address for the subaccount.
        username (str): Username for the subaccount.
        password (str): Password for the subaccount.
        host_only (bool): If True, create as host-only account. Default False.

    Returns:
        dict: API response data.
    """
    json_blob = {
        "email": email,
        "username": username,
        "password": password,
        "host_only": host_only,
        "parent_id": "me",
    }

    r = client.post("/users/", json_data=json_blob)
    r.raise_for_status()
    return r.json()


def fetch_contracts(client, label=None, contract_ids=None):
    """Fetch contracts, optionally filtered by label.

    POST /contracts/fetch/

    Args:
        client: VastClient instance.
        label (str, optional): Instance label to filter by.
        contract_ids (list, optional): List of contract IDs to filter.

    Returns:
        list: Matching contract dicts.
    """
    json_blob = {}
    if label is not None:
        json_blob["label"] = label
    if contract_ids is not None:
        json_blob["contract_ids"] = list(contract_ids)
    r = client.post("/contracts/fetch/", json_data=json_blob)
    r.raise_for_status()
    return r.json()["contracts"]


def show_ipaddrs(client):
    """Display user's history of IP addresses.

    GET /users/me/ipaddrs

    Args:
        client: VastClient instance.

    Returns:
        list: IP address access history.
    """
    r = client.get("/users/me/ipaddrs", query_args={"owner": "me"})
    r.raise_for_status()
    return r.json()["results"]
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall