Packages
Quicksand is a monorepo with 15 packages organized into four groups.
Runtime
| Package | What it is |
|---|---|
| quicksand | User-facing wrapper — re-exports core + images, CLI |
| quicksand-core | Core VM sandbox implementation |
| quicksand-qemu | Bundled QEMU binaries (per-platform) |
| quicksand-smb | Pure-Python SMB3 server for host-guest mounts |
Images
| Package | What it is |
|---|---|
| quicksand-ubuntu | Ubuntu 24.04 headless (~341 MB) |
| quicksand-alpine | Alpine 3.23 headless (~78 MB) |
| quicksand-ubuntu-desktop | Ubuntu 24.04 + Xfce4 + Firefox |
| quicksand-alpine-desktop | Alpine 3.23 + Xfce4 + Chromium |
| quicksand-agent | Ubuntu + Python 3.12, uv, build tools |
| quicksand-cua | Agent Sandbox + Playwright, Chromium |
Dev tools
| Package | What it is |
|---|---|
| quicksand-image-tools | CLI and API for building custom VM images |
| quicksand-base-scaffold | Scaffold new base image packages |
| quicksand-overlay-scaffold | Scaffold new overlay image packages |
| quicksand-build-tools | Shared build utilities for native binary bundling |
| quicksand-gh-runners | GitHub Actions self-hosted runner management |