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.
CLI: use a prebuilt binary
Section titled “CLI: use a prebuilt binary”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:
cargo binstall microvms-cli --no-confirmmicrovm --versionWith a Rust toolchain, compiling from crates.io is another option:
cargo install microvms-cli --lockedmicrovm --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.
The guest daemon is automatic
Section titled “The guest daemon is automatic”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.
Build the CLI from this repository
Section titled “Build the CLI from this repository”From a clone with Rust installed:
cargo install --path crates/microvms-cli --lockedThis 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.