fastvm 0.1.1

Async Python SDK for the FastVM microVM platform

FastVM Python SDK

Async Python SDK 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

Quick Start

export FASTVM_API_KEY="your-key"

from fastvm import FastVM

async with FastVM() 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

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
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