# install (macOS + Linux)
# option 1: download from GitHub releases
# https://github.com/smol-machines/smolvm/releases

# option 2: install script
curl -sSL https://smolmachines.com/install.sh | bash

# run a command in an ephemeral VM (cleaned up after exit)
smolvm machine run --net --image alpine -- echo "hello from a microVM"

# interactive shell
smolvm machine run --net -it --image alpine

# persistent machine (survives stop/start)
smolvm machine create --net myvm
smolvm machine start --name myvm
smolvm machine exec --name myvm -- apk add sl
smolvm machine exec --name myvm -it -- /bin/sh
# try: sl, ls, uname -a — type 'exit' to leave
smolvm machine stop --name myvm

# mount host directories (explicit — host is protected by default)
smolvm machine create --net -v ./src:/workspace myvm

# pack - portable, executable virtual machine
smolvm pack create --image python:3.12-alpine -o ./my-pythonvm
./my-pythonvm run -- python3 -c "print('hello from a packed VM')"

# uninstall
curl -sSL https://smolmachines.com/install.sh | bash -s -- --uninstall

smolvm machine run --image alpine -- sh -c "pip install sketchy-package"
# runs in its own kernel — can't touch your host filesystem or network

smolvm pack create --image python:3.12-alpine -o ./my-app
./my-app run -- python3 -c "print('runs anywhere — no dependencies')"

smolvm machine run --ssh-agent --net --image alpine -- ssh-add -l
# lists your host keys, but they can't be extracted from inside the VM

smolvm machine exec --name myvm -- git clone [email protected]:org/private-repo.git

# Smolfile
# image = "python:3.12-alpine"
# net = true
# [dev]
# init = ["pip install -r requirements.txt"]
# volumes = ["./src:/app"]
# [auth]
# ssh_agent = true

smolvm machine create myvm -s Smolfile
smolvm machine start --name myvm