Quicksand
Jak działa
Każdy sandbox to pełna maszyna wirtualna QEMU z własnym jądrem, startowana (ok. 2 s) przez asynchroniczne API Pythona jako kontekst (async context manager). Izolacja sieci opiera się na SLIRP NAT z restrict=on; dostęp do sieci (NetworkMode.FULL) i przekierowania portów (guestfwd/hostfwd) są opcjonalne. Akceleracja korzysta z KVM, a przy jej braku z emulacji TCG. Stan dysku trzymany jest w nakładkach qcow2, a migawki/checkpointy i przywracanie realizuje mechanizm savevm. Katalogi hosta montuje się przez CIFS lub 9p. Działa na macOS, Linux i Windows, na architekturach x86_64 i ARM64.
Rozwiązany problem
Agenci AI wykonujący wygenerowany kod lub sterujący komputerem potrzebują mocnej izolacji od maszyny hosta. Kontenery współdzielą jądro hosta, a rozwiązania chmurowe wymagają infrastruktury i kont. Quicksand daje izolację na poziomie VM lokalnie, bez roota, Dockera i chmury.
Komponenty
Pełna VM z własnym jądrem stanowiąca pojedynczy sandbox; izolacja na poziomie hipernadzorcy zamiast współdzielenia jądra hosta jak w kontenerach.
Interfejs (async context manager) do uruchamiania sandboxa, wykonywania poleceń (stdout/stderr/exit code) i sterowania pulpitem.
Checkpoint, revert i zapis stanu dysku w nakładkach qcow2; stan można wznowić później lub na innej maszynie.
Domyślne odcięcie od sieci (restrict=on); opcjonalny internet (NetworkMode.FULL) oraz dwukierunkowe przekierowanie portów.
Obrazy Ubuntu 24.04 i Alpine 3.23 (bazowe i z pulpitem Xfce4) oraz pod agentów: quicksand-agent i quicksand-cua (Playwright, Chromium).
Implementacja
Ewolucja
Dodano konta użytkowników w systemie gościa oraz strumieniowe stdin (2026-09-14).
Dodano dwukierunkowe przekierowanie portów między hostem a gościem (2026-10-14).
Hiperparametry (konfigurowalne osie)
Domyślnie izolacja; NetworkMode.FULL włącza dostęp do internetu.
Wybór bazowego obrazu/systemu (Ubuntu/Alpine, desktop, obrazy agentowe).
Montowanie katalogów hosta w VM przez CIFS lub 9p.
Sprzętowa akceleracja KVM lub programowa emulacja TCG przy jej braku.
Wymagania sprzętowe
Działa na dowolnym hoście x86_64 lub ARM64 (macOS/Linux/Windows); korzysta z akceleracji sprzętowej (KVM), a przy jej braku z emulacji TCG.