fastvm 0.2.0

Async Python SDK and CLI for the FastVM microVM platform

FastVM Python SDK & CLI

Async Python SDK and CLI for the FastVM microVM platform. Launch, snapshot, restore, and run commands on microVMs over HTTP/2 with multiplexed connections.

Installation

pip install fastvm

or with uv:

uv add fastvm

For CLI-only use (isolated install, puts fastvm on your PATH):

pipx install fastvm
# or
uv tool install fastvm

CLI Quick Start

# Set your API key (one-time)
export FASTVM_API_KEY=your-key
# or persist it:
fastvm config set api_key your-key

# Launch a VM and open an interactive console
fastvm launch --name dev --console

# List VMs
fastvm vm ls

# Run a command on a VM (by name or short ID)
fastvm vm exec dev "uname -a"

# Ephemeral one-shot: launch, run, destroy
fastvm run "apt update && python3 --version"

# Snapshots
fastvm snapshot create dev --name my-snap
fastvm snapshot restore my-snap --console

# Quotas
fastvm quota

VMs and snapshots can be referenced by full ID, short ID prefix (git-style), or name.

Enable tab completion (one-time):

# bash
eval "$(_FASTVM_COMPLETE=bash_source fastvm)"
# zsh
eval "$(_FASTVM_COMPLETE=zsh_source fastvm)"

Run fastvm --help for the full command reference.

SDK Quick Start

from fastvm import FastVM

# Also configurable via the FASTVM_API_KEY environment variable.
async with FastVM(api_key="your-key") as client:
    vm = await client.launch(machine="c1m2")
    snapshot = await client.snapshot(vm, name="my-snap")
    restored = await client.restore(snapshot)
    result = await client.run(restored, "echo hello")

    print(result.stdout)  # hello

SDK API Overview

Method	Description
launch()	Launch a new microVM
restore()	Restore a VM from a snapshot
run()	Execute a command on a VM
snapshot()	Create a point-in-time snapshot
get() / list()	Fetch VM state
remove()	Delete a VM
list_snapshots() / remove_snapshot()	Manage snapshots
set_firewall() / patch_firewall()	Configure IPv6 ingress firewall
console_token()	Request a console session token
quotas()	Fetch organization quota usage

Documentation

See the FastVM documentation for the full API reference and guides.

Examples

uv run examples/create-vm.py      # launch a VM and run commands
uv run examples/large_fanout.py   # snapshot + restore 10 VMs concurrently

License

Apache-2.0