Skip to main content

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.10

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.10
File Interpreter ABI Platform
quicksand_alpine_desktop-0.9.10-py3-none-any.whl Python 3 none any Details

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

Download URL quicksand_alpine_desktop-0.9.10-py3-none-any.whl
Size 3.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7c46fcb6b15fcbd47ed55b8de14717e4d6948dd7310f1b0ef821fb964fa41709
BLAKE2b-256 checksum
How to use checksums
03ef5add9c790bee46aede3e647f40fa531c8af32e59874d6192059c6c40c0ca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","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}

Release history Release notifications | RSS feed

0.9.11

1 release file

This release

0.9.10 This release

1 release file

0.9.9

1 release file

0.9.8

1 release file

0.9.7

1 release file

0.9.6

1 release file

0.9.5

1 release file

0.9.4

1 release file

0.9.3

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page