axio-tools-docker 0.2.0__tar.gz → 0.2.2__tar.gz

axio_tools_docker-0.2.2/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: axio-tools-docker
+Version: 0.2.2
+Summary: Docker sandbox tools for Axio
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: axio
+Description-Content-Type: text/markdown
+
+# axio-tools-docker
+
+[![PyPI](https://img.shields.io/pypi/v/axio-tools-docker)](https://pypi.org/project/axio-tools-docker/)
+[![Python](https://img.shields.io/pypi/pyversions/axio-tools-docker)](https://pypi.org/project/axio-tools-docker/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Docker sandbox tools for [axio](https://github.com/axio-agent/axio).
+
+Run agent-generated code and commands inside isolated Docker containers. The agent gets `sandbox_exec`, `sandbox_write`, and `sandbox_read` tools that operate entirely within the sandbox — the host filesystem stays untouched.
+
+## Features
+
+- **Isolated execution** — code runs inside a Docker container, not on the host
+- **Configurable image** — use any Docker image as the sandbox environment
+- **Three sandboxed tools** — execute commands, write files, read files — all inside the container
+- **Persistent sandbox** — container is reused across tool calls within a session for faster execution
+- **TUI integration** — configure image, memory limits, and CPU from the `axio-tui` settings screen
+
+## Requirements
+
+Docker must be installed and running:
+
+```bash
+docker info   # should succeed
+```
+
+## Installation
+
+```bash
+pip install axio-tools-docker
+```
+
+## Usage
+
+```python
+from axio import Agent
+from axio.context import MemoryContextStore
+from axio_transport_openai import OpenAITransport
+from axio_tools_docker.plugin import DockerPlugin
+
+async def main() -> None:
+    plugin = DockerPlugin()
+    await plugin.init()   # uses default config (python:3.12-slim)
+
+    agent = Agent(
+        system=(
+            "You are a coding assistant. Use sandbox_exec to run code safely. "
+            "Never attempt to access the host filesystem directly."
+        ),
+        tools=plugin.all_tools,
+        transport=OpenAITransport(api_key="sk-...", model="gpt-4o"),
+    )
+
+    ctx = MemoryContextStore()
+    result = await agent.run(
+        "Write a Python script that computes the first 20 Fibonacci numbers and run it.",
+        ctx,
+    )
+    print(result)
+```
+
+## Sandbox tools
+
+| Tool | Description |
+|---|---|
+| `sandbox_exec` | Run a shell command inside the container; returns stdout + stderr |
+| `sandbox_write` | Write a file into the container's filesystem |
+| `sandbox_read` | Read a file from the container's filesystem |
+
+## Configuration
+
+```python
+from axio_tools_docker.config import SandboxConfig
+
+config = SandboxConfig(
+    image="python:3.12-slim",
+    memory_limit="512m",
+    cpu_quota=100000,    # 1 CPU
+    work_dir="/workspace",
+)
+```
+
+## Plugin registration
+
+```toml
+[project.entry-points."axio.tools.settings"]
+docker = "axio_tools_docker.plugin:DockerPlugin"
+```
+
+## Part of the axio ecosystem
+
+[axio](https://github.com/axio-agent/axio) · [axio-tools-local](https://github.com/axio-agent/axio-tools-local) · [axio-tools-mcp](https://github.com/axio-agent/axio-tools-mcp) · [axio-tui](https://github.com/axio-agent/axio-tui)
+
+## License
+
+MIT

{axio_tools_docker-0.2.0 → axio_tools_docker-0.2.2}/pyproject.toml

@@ -1,7 +1,8 @@
 [project]
 name = "axio-tools-docker"
-version = "0.2.0"
+version = "0.2.2"
 description = "Docker sandbox tools for Axio"
+readme = "README.md"
 requires-python = ">=3.12"
 license = {text = "MIT"}
 dependencies = ["axio"]

{axio_tools_docker-0.2.0 → axio_tools_docker-0.2.2}/uv.lock

@@ -13,19 +13,19 @@ wheels = [
 
 [[package]]
 name = "axio"
-version = "0.1.1"
+version = "0.2.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "pydantic" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/d5/c4/9fb5beefc5fa3090de3bfbdbf761fa14b0467e04d60f464166ccc0e9ca4c/axio-0.1.1.tar.gz", hash = "sha256:c59d8b246355379653dc967306189d997328dbfe145bbddf8873ec5786f48420", size = 53962, upload-time = "2026-03-22T18:38:36.497Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/0b/df/df4f46276669df7bf3c62e5bef60fee611e9fa902ee714a3cbc77e510022/axio-0.2.0.tar.gz", hash = "sha256:10ae13271c3f097c0e20b1f3e5b039cfca04f52533fb926b8254828199f55206", size = 53963, upload-time = "2026-03-22T19:22:50.096Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/19/07/74deca7e757a5e66fe58ad0c54e605764e8407c49021dd5fe4d9947c9f8b/axio-0.1.1-py3-none-any.whl", hash = "sha256:b764858e311825e5648354fda579894cc522a10d3bc4cf939e8517ffc2fb1b54", size = 16836, upload-time = "2026-03-22T18:38:35.348Z" },
+    { url = "https://files.pythonhosted.org/packages/26/c0/a27ce8b4ff865d15cbb45cd4f1a8d63cc8d3bd34295ee5091d8d5e1f9175/axio-0.2.0-py3-none-any.whl", hash = "sha256:a1372d44f1102d18d123ced7a5c70dda2bc007ee5f653250e7c65a68866c75a4", size = 16833, upload-time = "2026-03-22T19:22:48.974Z" },
 ]
 
 [[package]]
 name = "axio-tools-docker"
-version = "0.2.0"
+version = "0.2.2"
 source = { editable = "." }
 dependencies = [
     { name = "axio" },

axio_tools_docker-0.2.0/PKG-INFO

@@ -1,8 +0,0 @@
-Metadata-Version: 2.4
-Name: axio-tools-docker
-Version: 0.2.0
-Summary: Docker sandbox tools for Axio
-License: MIT
-License-File: LICENSE
-Requires-Python: >=3.12
-Requires-Dist: axio