Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

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.yml
index 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/xfce
tag_prefix: docker-xfce-v
docker_hub_org: trycua
+ # kicad/kicad:9.0 currently publishes an amd64 image only.
+ skip_arm64: true
secrets:
DOCKER_HUB_TOKEN: ${{ secrets.DOCKER_HUB_TOKEN }}
diff --git a/.github/workflows/ci-container-xfce.yml b/.github/workflows/ci-container-xfce.yml
index 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-xfce
context_dir: libs/xfce
+ # kicad/kicad:9.0 currently publishes an amd64 image only.
+ skip_arm64: true
diff --git a/libs/xfce/Development.md b/libs/xfce/Development.md
index b67199e834..98c96fda49 100644
--- a/libs/xfce/Development.md
+++ b/libs/xfce/Development.md
@@ -25,4 +25,17 @@ docker tag cua-xfce:dev cua-xfce:latest
docker 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:6901
diff --git a/libs/xfce/Dockerfile b/libs/xfce/Dockerfile
index 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 screens
RUN 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 scripts
COPY src/supervisor/ /etc/supervisor/conf.d/
COPY src/scripts/ /usr/local/bin/
diff --git a/libs/xfce/Dockerfile.dev b/libs/xfce/Dockerfile.dev
index 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-dir
RUN 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 pip
RUN chown -R cua:cua /home/cua/.cache
diff --git a/libs/xfce/README.md b/libs/xfce/README.md
index 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.txt
new file mode 100644
index 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