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/machines.py

View on GitHub
"""Machine management operations for hosts."""
from vastai.api.client import VastClient


def show_machine(client: VastClient, id: int) -> list:
    """Show a single hosted machine.

    Args:
        client: VastClient instance.
        id: Machine ID.

    Returns:
        List of machine data dicts (API returns list even for single machine).
    """
    r = client.get(f"/machines/{id}", query_args={"owner": "me"})
    r.raise_for_status()
    return r.json()


def show_machines(client: VastClient) -> list:
    """Show all hosted machines for the current user.

    Args:
        client: VastClient instance.

    Returns:
        List of machine dicts.
    """
    r = client.get("/machines", query_args={"owner": "me"})
    r.raise_for_status()
    return r.json()["machines"]


def show_maints(client: VastClient, machine_ids: list) -> list:
    """Show maintenance information for host machines.

    Args:
        client: VastClient instance.
        machine_ids: List of machine ID integers.

    Returns:
        List of maintenance info dicts.
    """
    r = client.get("/machines/maintenances", query_args={"owner": "me", "machine_ids": machine_ids})
    r.raise_for_status()
    return r.json()


def list_machine(client: VastClient, id: int, price_gpu: float = None,
                 price_disk: float = None, price_inetu: float = None,
                 price_inetd: float = None, price_min_bid: float = None,
                 min_chunk: int = None, end_date: float = None,
                 discount_rate: float = None, duration: str = None,
                 vol_size: int = None, vol_price: float = None) -> dict:
    """List a machine for rent (create offers).

    Args:
        client: VastClient instance.
        id: Machine ID.
        price_gpu: Per GPU rental price in $/hour.
        price_disk: Storage price in $/GB/month.
        price_inetu: Price for upload bandwidth in $/GB.
        price_inetd: Price for download bandwidth in $/GB.
        price_min_bid: Per GPU minimum bid price floor in $/hour.
        min_chunk: Minimum number of GPUs.
        end_date: Contract offer expiration as unix epoch timestamp.
        discount_rate: Max long-term prepay discount rate fraction.
        duration: Duration string or seconds.
        vol_size: Volume contract offer size in GB.
        vol_price: Volume disk price.

    Returns:
        Response dict.
    """
    json_blob = {
        "machine": id,
        "price_gpu": price_gpu,
        "price_disk": price_disk,
        "price_inetu": price_inetu,
        "price_inetd": price_inetd,
        "price_min_bid": price_min_bid,
        "min_chunk": min_chunk,
        "end_date": end_date,
        "credit_discount_max": discount_rate,
        "duration": duration,
        "vol_size": vol_size,
        "vol_price": vol_price,
    }
    r = client.put("/machines/create_asks/", json_data=json_blob)
    r.raise_for_status()
    return r.json()


def unlist_machine(client: VastClient, id: int) -> dict:
    """Unlist a listed machine (remove all offers).

    Args:
        client: VastClient instance.
        id: Machine ID.

    Returns:
        Response dict.
    """
    r = client.delete(f"/machines/{id}/asks/")
    r.raise_for_status()
    return r.json()


def cancel_maint(client: VastClient, id: int) -> dict:
    """Cancel scheduled maintenance window(s) for a machine.

    Args:
        client: VastClient instance.
        id: Machine ID.

    Returns:
        Response dict.
    """
    json_blob = {"client_id": "me", "machine_id": id}
    r = client.put(f"/machines/{id}/cancel_maint/", json_data=json_blob)
    r.raise_for_status()
    return r.json()


def schedule_maint(client: VastClient, id: int, sdate: float = None,
                   duration: float = None, maintenance_category: str = None) -> dict:
    """Schedule a maintenance window for a machine.

    Args:
        client: VastClient instance.
        id: Machine ID.
        sdate: Start date as unix epoch timestamp.
        duration: Duration in hours.
        maintenance_category: Category of maintenance.

    Returns:
        Response dict.
    """
    json_blob = {
        "client_id": "me",
        "sdate": sdate,
        "duration": duration,
        "maintenance_category": maintenance_category,
    }
    r = client.put(f"/machines/{id}/dnotify/", json_data=json_blob)
    r.raise_for_status()
    return r.json()


def cleanup_machine(client: VastClient, id: int) -> dict:
    """Remove all expired storage instances from a machine.

    Args:
        client: VastClient instance.
        id: Machine ID.

    Returns:
        Response dict.
    """
    r = client.put(f"/machines/{id}/cleanup/", json_data={})
    r.raise_for_status()
    return r.json()


def defrag_machines(client: VastClient, machine_ids: list) -> dict:
    """Defragment machines to rearrange GPU assignments.

    Args:
        client: VastClient instance.
        machine_ids: List of machine ID integers.

    Returns:
        Response dict with defragmentation results.
    """
    json_blob = {"machine_ids": machine_ids}
    r = client.put("/machines/defrag_offers/", json_data=json_blob)
    r.raise_for_status()
    return r.json()


def delete_machine(client: VastClient, id: int) -> dict:
    """Force delete a machine if not in use by clients.

    Args:
        client: VastClient instance.
        id: Machine ID.

    Returns:
        Response dict.
    """
    r = client.post(f"/machines/{id}/force_delete/")
    r.raise_for_status()
    return r.json()


def reports(client: VastClient, id: int) -> dict:
    """Get user reports for a given machine.

    Args:
        client: VastClient instance.
        id: Machine ID.

    Returns:
        Reports dict.
    """
    json_blob = {"machine_id": id}
    r = client.get(f"/machines/{id}/reports/", json_data=json_blob)
    r.raise_for_status()
    return r.json()


def set_defjob(client: VastClient, id: int, price_gpu: float = None,
               price_inetu: float = None, price_inetd: float = None,
               image: str = None, args: list = None) -> dict:
    """Create default jobs for a machine.

    Args:
        client: VastClient instance.
        id: Machine ID.
        price_gpu: Per GPU rental price in $/hour.
        price_inetu: Price for upload bandwidth in $/GB.
        price_inetd: Price for download bandwidth in $/GB.
        image: Docker container image to launch.
        args: List of arguments passed to container launch.

    Returns:
        Response dict.
    """
    json_blob = {
        "machine": id,
        "price_gpu": price_gpu,
        "price_inetu": price_inetu,
        "price_inetd": price_inetd,
        "image": image,
        "args": args,
    }
    r = client.put("/machines/create_bids/", json_data=json_blob)
    r.raise_for_status()
    return r.json()


def remove_defjob(client: VastClient, id: int) -> dict:
    """Remove default jobs from a machine.

    Args:
        client: VastClient instance.
        id: Machine ID.

    Returns:
        Response dict.
    """
    r = client.delete(f"/machines/{id}/defjob/")
    r.raise_for_status()
    return r.json()


def set_min_bid(client: VastClient, id: int, price: float = None) -> dict:
    """Set the minimum bid/rental price for a machine.

    Args:
        client: VastClient instance.
        id: Machine ID.
        price: Per GPU min bid price in $/hour.

    Returns:
        Response dict.
    """
    json_blob = {"client_id": "me", "price": price}
    r = client.put(f"/machines/{id}/minbid/", json_data=json_blob)
    r.raise_for_status()
    return r.json()


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