What's New

April 6

Grab yer updates:

> heyvm --upgrade
Upgraded heyvm 0.15.12 -> 0.16.0

We heard y'all like Firecracker

Big updates to the firecracker driver in heyvm this week including a build utility to create root filesystems from Dockerfiles, shell session support, and proxies and more.

# Build a firecracker file system image from a container:
> heyvm mvm build -f Dockerfile --name cool-firecracker-stuff

# hint: there's a new skill to help you build compatible images, install it!
> heyvm install-skills
# or
> npx skills add heyo-computer/skills

# Create a local firecracker instance with your image (Linux only with KVM enabled): 
> heyvm create \                                                                    
    --name my-fc-sandbox \                                                          
    --backend-type msb \                                                            
    --image my-custom-rootfs \                                                      
    --memory 512m \                                                                 
    --open-port 8080  

# Deploy firecracker with a custom image:
> heyvm deploy . \
  --name my-custom-vm \
  --driver firecracker \
  --image my-custom-rootfs \
  --port 3000\                                                                   
  --start-command "node /workspace/server.js" \
  --health-path /health \                                                         
  --health-timeout 60s \
  --env "NODE_ENV=production"

Apple Virtualization Framework

The apple_vf driver wraps the Apple Container APIs, a nifty OCI compatibility layer for the virtualization framework. Its cool, and there's great features that make creating VMs feel like container workflows. We don't want everyone to have to install tools to work with Heyo Computer however, so we developed our own bindings for the native virtualization Swift APIs.

If you are on Mac, choose the apple_virt driver to create a sandbox. The current default is an Ubuntu 24.04 VM, with a builder feature coming soon. (We also renamed apple_vf to apple_container to avoid confusion).

System Tests

You can now run a quick test to confirm if your system is prepared for virtualization.

# on MacOS
> heyvm test-apple-virt

# on Linux
> heyvm test-firecracker

PS - there's a new skill heyvm-system that lets an agent run the tests and help provide diagnostics.

Bugs Bugs Bugs