Skip to content

Install the CLI or an SDK

The microvm CLI runs agents and commands in sandboxed AWS Lambda MicroVMs. Install it first to prepare an image, run a coding agent, or try the SDKs.

Download the archive for your machine from the latest release, extract it, and put microvm (microvm.exe on Windows) on your PATH. Releases cover Linux x64/ARM64, macOS Intel/Apple silicon, and Windows x64. No Rust compiler is required.

If cargo-binstall is already installed, it selects and installs the release for you:

Terminal window
cargo binstall microvms-cli --no-confirm
microvm --version

With a Rust toolchain, compiling from crates.io is another option:

Terminal window
cargo install microvms-cli --locked

microvm --version works without AWS credentials. To see the installed command surface, use microvm --help; microvm manifest emits it as JSON.

Next: configure AWS and start an agent.

Choose your language:

Language Install Runtime
Python pip install microvms Python 3.11+
Node.js / TypeScript npm install microvms Node.js 22.13+
Rust cargo add microvms-core Rust toolchain

Run sandboxed tools from your application has complete examples, including cleanup. The SDKs connect to the same AWS service as the CLI.

agent-up, run, build, and quickstart download the matching agentd release binary when needed and cache it locally. The CLI checks the release workflow’s Sigstore attestation itself, so it needs neither gh nor curl. A release that says it has no attestation for the download is refused. Only when GitHub can’t be reached for one at all (neither the release’s bundle asset nor the attestations API answers) does it check the release’s SHA256 checksum instead. When the progress line blames the API’s rate limit, set GITHUB_TOKEN to raise it. The guest daemon is a static ARM64 Linux binary on every host platform.

For a daemon you build or manage yourself, set MICROVM_AGENTD to its path, or pass the path as the positional argument to agent-up, run, or build. A MICROVM_AGENTD binary that is not an ARM64 ELF is refused before any build. microvm doctor --binary ./agentd checks a positional binary’s architecture.

From a clone with Rust installed:

Terminal window
cargo install --path crates/microvms-cli --locked

This builds the host CLI. It can still download the guest daemon automatically. Repository contributors can use mise install and mise run install to install the pinned tools and Git hooks.