fastvm 0.1.0

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 with zero-poll status waits over a persistent WebSocket channel.

Installation

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

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 25 VMs concurrently

Benchmarks

uv sync
uv run pytest

License

Apache-2.0