quicksand-agent 0.4.2__py3-none-any.whl

quicksand_agent/__init__.py

@@ -0,0 +1,46 @@
+"""quicksand-agent: pre-built overlay on quicksand-ubuntu."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from .sandbox import AgentSandbox
+
+__version__ = "0.2.5"
+
+PACKAGE_DIR = Path(__file__).parent
+IMAGES_DIR = PACKAGE_DIR / "images"
+
+
+class _AgentSandboxImageProvider:
+    """ImageProvider for the bundled agent sandbox overlay."""
+
+    name = "quicksand-agent"
+    type = "overlay"
+    images_dir = IMAGES_DIR
+
+    def resolve(self, arch: str | None = None):
+        from quicksand_core.qemu.image_resolver import ImageResolver
+
+        if not (IMAGES_DIR / "manifest.json").exists():
+            from quicksand_core._auto_install import auto_install_images
+
+            if not auto_install_images("quicksand-agent", IMAGES_DIR):
+                raise FileNotFoundError(
+                    "No bundled save found. If you installed from PyPI, download images with:\n"
+                    "  quicksand install quicksand-agent"
+                )
+        return ImageResolver()._resolve_save(IMAGES_DIR)
+
+
+# Module-level instance — registered as quicksand.images entry point
+image = _AgentSandboxImageProvider()
+
+
+__all__ = [
+    "IMAGES_DIR",
+    "PACKAGE_DIR",
+    "AgentSandbox",
+    "__version__",
+    "image",
+]

quicksand_agent/sandbox.py

@@ -0,0 +1,38 @@
+"""Pre-configured Sandbox using the bundled agent sandbox overlay."""
+
+from __future__ import annotations
+
+from collections.abc import Callable
+from pathlib import Path
+from typing import Unpack
+
+from quicksand_core import Sandbox
+from quicksand_core._types import SandboxConfigParams
+
+
+class AgentSandbox(Sandbox):
+    """Pre-configured Sandbox that boots from the bundled agent sandbox overlay.
+
+    Requires quicksand-ubuntu to be installed (the overlay is built on top of it).
+
+    Usage::
+
+        async with AgentSandbox() as sb:
+            result = await sb.execute("python3 --version")
+    """
+
+    def __init__(
+        self,
+        *,
+        progress_callback: Callable[[str, int, int], None] | None = None,
+        save: str | None = None,
+        workspace: str | Path | None = None,
+        **kwargs: Unpack[SandboxConfigParams],
+    ) -> None:
+        kwargs.setdefault("image", "quicksand-agent")
+        super().__init__(
+            progress_callback=progress_callback,
+            save=save,
+            workspace=workspace,
+            **kwargs,
+        )

quicksand_agent-0.4.2.dist-info/METADATA

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: quicksand-agent
+Version: 0.4.2
+Summary: Overlay image package for quicksand
+License-Expression: MIT
+Requires-Python: >=3.11
+Requires-Dist: quicksand-core<0.12.0,>=0.11.7
+Requires-Dist: quicksand-ubuntu<0.10.0,>=0.9.4
+Description-Content-Type: text/markdown
+
+# Quicksand Agent Sandbox
+
+An overlay image package for [quicksand](https://github.com/microsoft/quicksand) that provides a Python 3.12 environment with common AI agent tools pre-installed. Built on top of `quicksand-ubuntu`.
+
+## Installation
+
+```bash
+quicksand install quicksand-agent
+```
+
+## Usage
+
+### Simple (recommended)
+
+```python
+import asyncio
+from quicksand_agent import AgentSandbox
+
+async def main():
+    async with AgentSandbox() as sb:
+        result = await sb.execute("python3 --version")
+        print(result.stdout)
+
+asyncio.run(main())
+```
+
+### With custom config
+
+```python
+from quicksand_core import Sandbox
+
+async with Sandbox(image="quicksand-agent", memory="4G", cpus=4) as sb:
+    result = await sb.execute("pip list")
+```
+
+## What's Included
+
+Built on Ubuntu 24.04, this overlay adds:
+
+- **Python 3.12** virtual environment at `/opt/python` (with `pip`)
+- **uv** fast Python package manager
+- **build-essential** (gcc, make, etc.)
+- **requests** HTTP library
+- **pyyaml** YAML parsing
+- **ddgs** DuckDuckGo Search API
+- **markitdown** Markdown conversion tool
+
+## License
+
+MIT

quicksand_agent-0.4.2.dist-info/RECORD

@@ -0,0 +1,6 @@
+quicksand_agent/__init__.py,sha256=AI5C308_GDCApoq6Ty1CGS1AEDQJH7TcqT9pE-IYoLE,1239
+quicksand_agent/sandbox.py,sha256=oX4gFmaRj1VjXGWr9p2b8WRAv5yP1x8APlv4E2CGHt0,1078
+quicksand_agent-0.4.2.dist-info/METADATA,sha256=8N_0jpOFubGgta7o3RmJZ85ZX0j8xGr3YmzR5xNr75Y,1388
+quicksand_agent-0.4.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+quicksand_agent-0.4.2.dist-info/entry_points.txt,sha256=XUEGIQdCc7ZROmfZ8wrBrpEdcbODsMAM5mlt2hO_A7I,59
+quicksand_agent-0.4.2.dist-info/RECORD,,

quicksand_agent-0.4.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

quicksand_agent-0.4.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[quicksand.images]
+quicksand-agent = quicksand_agent:image