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

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

Or install separately:

pip install quick-sandbox
quicksand install ubuntu

Usage

Simple (recommended)

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

from quicksand import UbuntuSandbox

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

Or using Sandbox directly:

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