Quicksand

Appearance

Quicksand Ubuntu ​

This package bundles a pre-built Ubuntu 24.04 VM image for the quicksand agent harness. No downloads required after installation.

Ubuntu is ideal for AI agents that need a full Linux environment with the apt package manager and broad software compatibility.

Installation ​

bash
pip install 'quick-sandbox[qemu,ubuntu]'

Or install separately:

bash
pip install quick-sandbox
quicksand install ubuntu

Usage ​

python
import asyncio
from quicksand import UbuntuSandbox

async def main():
    async with UbuntuSandbox() as sb:
        result = await sb.execute("cat /etc/os-release")
        print(result.stdout)

asyncio.run(main())

With custom config ​

python
from quicksand import UbuntuSandbox

async with UbuntuSandbox(memory="2G", cpus=4) as sb:
    result = await sb.execute("uname -a")

Or using Sandbox directly:

python
from quicksand import Sandbox

async with Sandbox(image="ubuntu", memory="2G", cpus=4) as sb:
    result = await sb.execute("uname -a")

What's Included ​

The Ubuntu 24.04 image includes:

  • Python 3
  • Bash, curl, ca-certificates
  • Networking tools
  • The quicksand agent (pre-installed and configured)

Package Size ​

The wheel is ~300MB because it includes the full VM image. This is intentional - it eliminates runtime downloads and ensures reproducible environments.

License ​

MIT