# 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 --image alpine -- echo "hello from a microVM"

# interactive shell
smolvm machine run -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 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

# my-app.smolfile
# cpus = 2
# memory = 1024
# net = true
# ports = ["8080:8080"]
# init = ["apk add python3"]

smolvm machine create myvm -s my-app.smolfile
smolvm machine start --name myvm

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