MicroVM platform for AI sandboxing, cloud desktops, and ephemeral dev environments. Built on Cloud Hypervisor / Firecracker and Kubernetes.
Documentation: cocoonstack.github.io
| Repository | Description | Docs |
|---|---|---|
| cocoon | Lightweight MicroVM engine β OCI/cloud images, instant snapshot & clone, Windows 11 support, CNI networking, Docker-like CLI | docs |
| cocoon-agent | In-VM exec agent β vsock command channel behind cocoon vm exec / logs and per-clone identity reseed, no SSH |
docs |
| cocoon-macos | macOS guests via QEMU + OpenCore + OVMF, reusing cocoon's cloudimg store and clone/snapshot model | docs |
| cloud-hypervisor | Patched Cloud Hypervisor fork β DISCARD fix, virtio-net ctrl_queue tolerance, upstream cherry-picks | β |
| rust-hypervisor-firmware | Patched UEFI firmware β ACPI ResetSystem fix for Windows graceful shutdown | β |
| windows | Windows 11 25H2 image factory β unattended QEMU build, Cloud Hypervisor validation (DHCP, RDP, SAC, ACPI shutdown), published to GHCR as OCI artifacts | β |
| Repository | Description | Docs |
|---|---|---|
| vk-cocoon | Virtual Kubelet provider β maps pod lifecycle to VM operations (run, clone, snapshot, hibernate) | docs |
| cocoon-operator | Kubernetes operator β CocoonSet and CocoonHibernation CRDs for stateful VM workflows | docs |
| cocoon-webhook | Admission webhook β sticky scheduling plus CocoonSet and CocoonHibernation validation | docs |
| cocoon-net | VPC-native networking β embedded DHCP plus alias IPs (GKE) or ENI secondary IPs (Volcengine) for direct VM DHCP | docs |
| cocoon-common | Shared Go library β CRD types, annotation contract, Kubernetes helpers, OCI registry + snapshot packages | β |
| Repository | Description | Docs |
|---|---|---|
| sandbox | Fast cold-boot AI-agent sandbox on cocoon β warm pools, in-guest daemon, per-node control plane, Go SDK | docs |
| sandbox-operator | Kubernetes operator and aggregated apiserver for the agents.x-k8s.io agent-sandbox API β warm microVM pools, claims through any Kubernetes SDK, etcd off the claim path |
docs |
| vk-sandbox | Virtual Kubelet provider for sandbox-operator β serves runtime: sandboxd claims from node-local hot pools and publishes NodeInventory |
docs |