shuru offers a local-first microVM sandbox specifically designed for AI agents on macOS. It leverages lightweight Linux VMs powered by the Apple Virtualization.framework, ensuring near-native speed on ARM64 architecture without the need for Docker. This innovative tool is ephemeral by default, meaning every run starts from a clean root filesystem, allowing users to install and break anything without persistence unless explicitly saved.

Key Features

• Ephemeral by Default: Each session begins fresh, with nothing persisting unless saved, providing a clean slate for experimentation.

• Checkpoints: Save disk states as named snapshots, enabling restoration, branching, and iteration akin to git commits.

• Apple Silicon Native: Built on Virtualization.framework, it operates without an emulation layer, ensuring fast performance on ARM64.

• Simple CLI: Easily run, checkpoint, and restore environments with straightforward commands.

• Configurable Resources: Set CPUs, memory, and disk size per run or via configuration files for tailored performance.

• Port Forwarding: Expose guest ports to the host, facilitating communication without network access.

shuru is ideal for running AI-generated code in isolated environments, allowing agents to safely install packages, compile code, and use system tools. It supports parallel sandbox creation for reproducible evaluations and provides disposable Linux environments for testing, debugging, and prototyping. Installation is quick, requiring just a single command to get started.