bux

Embedded micro-VM sandbox for running AI agents.

lib.rs:

Embedded micro-VM sandbox for running AI agents.

bux wraps libkrun into a safe Rust API for creating, running, and managing lightweight virtual machines powered by KVM (Linux) or Hypervisor.framework (macOS).

Quick start — one-shot execution

use bux::Vm;

let vm = Vm::builder()
    .vcpus(2)
    .ram_mib(512)
    .root("/path/to/rootfs")
    .exec("/bin/bash", &["--login"])
    .build()
    .expect("invalid VM config");

// Takes over the process — only returns on error.
vm.start().expect("failed to start VM");