Quicksand Alpine Desktop

Minimal Alpine Linux 3.23 desktop VM (Xfce4) for the quicksand agent harness. Lightweight and fast-booting — ideal when you need GUI automation without the overhead of a full Ubuntu desktop.

Installation

pip install quick-sandbox
quicksand install alpine-desktop

Usage

import asyncio
from quicksand import Key
from quicksand_alpine_desktop import AlpineDesktopSandbox

async def main():
    async with AlpineDesktopSandbox() as sb:
        await sb.screenshot("desktop.png")
        await sb.type_text("echo hello world")
        await sb.press_key(Key.RET)
        result = await sb.execute("cat /etc/os-release")
        print(result.stdout)

asyncio.run(main())

What's Included

Alpine 3.23 with Xfce4 desktop + LightDM (auto-login)
Chromium browser
Python 3, bash, curl
The quicksand guest agent (pre-installed)

Default Config

Setting	Default
Memory	1G
CPUs	2
Display	Enabled (always)
Boot timeout	60s
Init system	OpenRC
Image size	~300MB

License

MIT

Metadata

Release files for quicksand-alpine-desktop 0.9.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for quicksand-alpine-desktop 0.9.11
File	Interpreter	ABI	Platform	Reset
quicksand_alpine_desktop-0.9.11-py3-none-any.whl 3.3 kB Oct 14, 2026	Python 3	none	any	Details

Release files / quicksand_alpine_desktop-0.9.11-py3-none-any.whl

Download URL	quicksand_alpine_desktop-0.9.11-py3-none-any.whl
Size	3.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c22fa6cf4536409737128edd0ae7456a9725ebce4ae565bb19ebf7f10f8522d8`
BLAKE2b-256 checksum How to use checksums	`899d2af35e3c55b5f2d23fef203c657400ead1724079b1de69012db1f7afed4b`
Upload date	Oct 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`