Repository navigation
kumoba v0.1.0
Added
- libkrun microVM runtime (
kumoba): boot, exec with streaming output, files, host mounts, snapshot images, secrets that stay on the host, egress allowlists with wildcard domains, intranet allowlists, corporate upstream proxies and an access log of every proxied connection. kumobaddaemon: HTTP API over a Unix socket or loopback TCP with bearer auth, concurrency limit, auto-stop, restart reconciliation, signed preview links, network updates on stopped sandboxes and a paged access-log feed.kumoba-guest: PID 1 agent for guest images with command execution, files, port forwarding and an optional xfce desktop with screenshots, input and a VNC live view.- TypeScript SDK (
kumobaon npm):Kumoba,Sandbox,Files,Desktop,accessLog()async iterator andawait usingdisposal. - Default Debian guest image with Python, Node, Chromium and the desktop, plus an Alpine test image that needs no Docker.
- Sparse disk copies with reflinks where the filesystem supports them.
- Zero-config start: with no environment
kumobaduses~/.kumoba(orKUMOBA_HOME) for images, state, a generated token and its socket, findskumoba-workernext to itself and libkrun in../lib, andnew Kumoba()connects to it with no options. scripts/install.sh: one-line install of the daemon, worker and a prebuiltdefaultortestimage, verified against the release checksums.- Releases ship the four crates, the npm package, host tarballs for Linux x86_64, Linux arm64 and macOS arm64, and prebuilt guest images for both architectures. Every release is installed and booted before it is published.
Install
curl -fsSL https://raw.githubusercontent.com/Parassharmaa/kumoba/main/scripts/install.sh | KUMOBA_VERSION=0.1.0 bash
npm install kumoba@0.1.0The installer puts kumobad, kumoba-worker and the default image into ~/.kumoba; on macOS install libkrun first with brew tap slp/krun && brew install slp/krun/libkrun slp/krun/libkrunfw zstd. cargo install kumobad@0.1.0 builds the daemon and worker from crates.io instead, and the Rust library is cargo add kumoba@0.1.0.
The files below are the host tarballs (Linux ones bundle the patched libkrun and libkrunfw; the macOS worker is signed for Hypervisor.framework), the default and test guest images for each architecture, and SHA256SUMS. Guest images from an earlier release must be replaced when the protocol version changes.
Full Changelog: https://github.com/Parassharmaa/kumoba/commits/v0.1.0