Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.
Rust agentai-agentapplecomputer-usecomputer-use-agentcontainerizationcuadesktop-automationhacktoberfestlumemacosmanusoperatorswiftvirtualizationvirtualization-frameworkwindowswindows-sandbox
feat(xfce): install Cua Driver SDK in container images (#2533)
Francesco Bonacci0823de495758
diff --git a/.github/workflows/cd-container-xfce.yml b/.github/workflows/cd-container-xfce.ymlindex 1c72b9d261..c928f00ff6 100644--- a/.github/workflows/cd-container-xfce.yml+++ b/.github/workflows/cd-container-xfce.yml@@ -14,5 +14,7 @@ jobs:context_dir: libs/xfcetag_prefix: docker-xfce-vdocker_hub_org: trycua+ # kicad/kicad:9.0 currently publishes an amd64 image only.+ skip_arm64: truesecrets:DOCKER_HUB_TOKEN: ${{ secrets.DOCKER_HUB_TOKEN }}diff --git a/.github/workflows/ci-container-xfce.yml b/.github/workflows/ci-container-xfce.ymlindex 3b604aa2c7..cce88bd926 100644--- a/.github/workflows/ci-container-xfce.yml+++ b/.github/workflows/ci-container-xfce.yml@@ -13,3 +13,5 @@ jobs:with:image_name: cua-xfcecontext_dir: libs/xfce+ # kicad/kicad:9.0 currently publishes an amd64 image only.+ skip_arm64: truediff --git a/libs/xfce/Development.md b/libs/xfce/Development.mdindex b67199e834..98c96fda49 100644--- a/libs/xfce/Development.md+++ b/libs/xfce/Development.md@@ -25,4 +25,17 @@ docker tag cua-xfce:dev cua-xfce:latestdocker run -p 6901:6901 -p 8000:8000 cua-xfce:dev```+Verify that the image contains both the Python SDK and bundled executable:++```bash+docker run --rm cua-xfce:dev cua-driver --version+docker run --rm cua-xfce:dev \+ python -c "from cua_driver import CuaDriver, get_binary_path; print(get_binary_path())"+```++Installing Cua Driver does not replace or start another GUI service. The image+continues to expose computer-server on port 8000. A future transport adapter can+host the typed Python SDK without coupling the base image to HTTP, gRPC, or+another remote protocol.+Access noVNC at: http://localhost:6901diff --git a/libs/xfce/Dockerfile b/libs/xfce/Dockerfileindex 7108b7ea65..355342d37e 100644--- a/libs/xfce/Dockerfile+++ b/libs/xfce/Dockerfile@@ -80,6 +80,7 @@ RUN pip3 install --break-system-packages uv && \uv venv /opt/venv --python 3.13 && \ln -sf /opt/venv/bin/python3 /usr/local/bin/python3 && \ln -sf /opt/venv/bin/python3 /usr/local/bin/python+ENV PATH="/opt/venv/bin:${PATH}"# Remove screensavers and power manager to avoid popups and lock screensRUN apt-get remove -y \@@ -126,6 +127,15 @@ RUN uv pip install --python /opt/venv/bin/python3 \"matplotlib>=3.8.0" \"anthropic>=0.26.0"+# Install the typed Cua Driver SDK and its bundled executable. The image keeps+# computer-server as its active remote API until a transport adapter is chosen.+COPY requirements-cua-driver.txt /tmp/requirements-cua-driver.txt+RUN uv pip install --python /opt/venv/bin/python3 --no-cache-dir \+ -r /tmp/requirements-cua-driver.txt && \+ /opt/venv/bin/python3 -c \+ "from pathlib import Path; from cua_driver import CuaDriver, get_binary_path; assert Path(get_binary_path()).is_file()" && \+ /opt/venv/bin/cua-driver --version+# Copy startup scriptsCOPY src/supervisor/ /etc/supervisor/conf.d/COPY src/scripts/ /usr/local/bin/diff --git a/libs/xfce/Dockerfile.dev b/libs/xfce/Dockerfile.devindex bc77e02707..d4d12f1b9d 100644--- a/libs/xfce/Dockerfile.dev+++ b/libs/xfce/Dockerfile.dev@@ -147,6 +147,16 @@ RUN uv pip install --system cua-bench-ui>=0.7.0 --no-cache-dirRUN uv pip install --system playwright && \python3.12 -m playwright install --with-deps firefox+# Install the same released Cua Driver SDK used by the production image. This+# makes the Python API and bundled executable available without changing the+# existing computer-server runtime or port contract.+COPY xfce/requirements-cua-driver.txt /tmp/requirements-cua-driver.txt+RUN uv pip install --system --no-cache-dir \+ -r /tmp/requirements-cua-driver.txt && \+ python3.12 -c \+ "from pathlib import Path; from cua_driver import CuaDriver, get_binary_path; assert Path(get_binary_path()).is_file()" && \+ cua-driver --version+# Fix any cache files created by pipRUN chown -R cua:cua /home/cua/.cachediff --git a/libs/xfce/README.md b/libs/xfce/README.mdindex 0834edd4e1..62a1b5108e 100644--- a/libs/xfce/README.md+++ b/libs/xfce/README.md@@ -2,4 +2,11 @@Vanilla XFCE desktop container for Computer-Using Agents.+The image includes both `cua-computer-server` and the released `cua-driver`+Python SDK with its bundled executable. Computer-server remains the active+remote API on port 8000; Cua Driver is installed for co-located applications+and future transport-adapter experiments but is not started automatically.+The pinned Driver version is declared in+[`requirements-cua-driver.txt`](requirements-cua-driver.txt).+**[Documentation](https://cua.ai/docs/cua/reference/desktop-sandbox/linux-container/xfce)** - Setup and configuration.diff --git a/libs/xfce/requirements-cua-driver.txt b/libs/xfce/requirements-cua-driver.txtnew file mode 100644index 0000000000..fe430e9909--- /dev/null+++ b/libs/xfce/requirements-cua-driver.txt@@ -0,0 +1,2 @@+# Keep this pinned so released XFCE image builds are reproducible.+cua-driver==0.12.3