kumobad 0.2.2

HTTP daemon and per-VM worker serving kumoba microVM sandboxes
kumobad-0.2.2 is not a library.

kumobad

crates.io CI License

The kumoba daemon. Serves microVM sandboxes over an HTTP API on a Unix socket or loopback TCP, and ships two more binaries: kumoba, the command-line client, and kumoba-worker, the per-VM process that loads libkrun and boots one sandbox.

The quickest route is the installer, which also fetches a guest image and the libraries:

curl -fsSL https://raw.githubusercontent.com/Parassharmaa/kumoba/main/scripts/install.sh | bash
~/.kumoba/bin/kumobad

From crates.io:

cargo install kumobad
kumobad --help
kumoba run -- echo hello        # once kumobad is running

With no configuration kumobad uses ~/.kumoba: it boots every images/<name>.raw, creates a token and listens on kumobad.sock. Hosts need libkrun and libkrunfw, from Homebrew slp/krun on Apple silicon or scripts/prepare-linux-host.sh on Linux with /dev/kvm. On macOS a cargo installed kumoba-worker must also be signed with the com.apple.security.hypervisor entitlement; the install section has the commands.

Clients: the kumoba npm package, or any HTTP client following docs/http-api.md.