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
# Cua Docker XFCE Container
# Vanilla XFCE desktop with noVNC and cua-spacesd
# Uses the official KiCad 9 image as base (Debian Bookworm + KiCad 9 pre-installed)
FROM kicad/kicad:9.0
# Avoid prompts from apt
ENV DEBIAN_FRONTEND=noninteractive
# Set environment variables
ENV HOME=/home/cua
ENV DISPLAY=:1
ENV VNC_PORT=5901
ENV NOVNC_PORT=6901
ENV CUA_ENV_PORT=3211
ENV VNC_RESOLUTION=1024x768
ENV VNC_COL_DEPTH=24
USER root
# Install system dependencies
RUN apt-get update && apt-get install -y \
# System utilities
sudo \
unzip \
zip \
xdg-utils \
# DHCP client for networking
isc-dhcp-client \
# Qt/XCB runtime deps for KiCad/XFCE
libxcb-icccm4 \
libxcb-image0 \
libxcb-keysyms1 \
libxcb-render-util0 \
libxcb-xinerama0 \
libxcb-shape0 \
libxcb-randr0 \
libxcb-xfixes0 \
libxcb-sync1 \
libxcb-util1 \
libxcb-cursor0 \
libxkbcommon-x11-0 \
# Desktop environment
xfce4 \
xfce4-terminal \
dbus-x11 \
# VNC server
tigervnc-standalone-server \
tigervnc-tools \
# noVNC dependencies
git \
net-tools \
netcat-openbsd \
supervisor \
# Desktop tooling (screenshot, window control, clipboard)
gnome-screenshot \
wmctrl \
ffmpeg \
socat \
xclip \
# Browser (used by agent)
wget \
ca-certificates \
curl \
firefox-esr \
# GTK/WebKit for pywebview (cua-bench-ui task display)
gir1.2-gtk-3.0 \
gir1.2-webkit2-4.1 \
libgirepository1.0-dev \
libcairo2-dev \
pkg-config \
gobject-introspection \
# Python pip to bootstrap uv
python3-pip \
&& rm -rf /var/lib/apt/lists/*
# CUA-1948: the compromised eMudhra intermediates. Ubuntu's ca-certificates >= 20260816ubuntu0.<release>.1 drops the
# roots they chain to; Debian has not shipped that yet, so disable both roots explicitly (a no-op once they are gone).
RUN apt-get update \
&& apt-get install -y --no-install-recommends ca-certificates \
&& sed -i -E 's#^(mozilla/(emSign_ECC_Root_CA_-_G3|Comodo_AAA_Services_root)\.crt)$#!\1#' /etc/ca-certificates.conf \
&& update-ca-certificates \
&& rm -rf /var/lib/apt/lists/*
# Install uv, Python 3.13, and create venv at /opt/venv
# Python 3.13 satisfies cua-bench-ui's >=3.12 requirement (Bookworm only has 3.11)
RUN pip3 install --break-system-packages uv && \
uv python install 3.13 && \
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 \
xfce4-power-manager \
xfce4-screensaver \
light-locker \
xscreensaver || true
# Create cua user
RUN useradd -m -s /bin/bash -G sudo cua && \
echo "cua:cua" | chpasswd && \
echo "cua ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers
# Configure Firefox ESR
RUN echo 'pref("datareporting.policy.firstRunURL", "");\npref("datareporting.policy.dataSubmissionEnabled", false);\npref("datareporting.healthreport.service.enabled", false);\npref("datareporting.healthreport.uploadEnabled", false);\npref("trailhead.firstrun.branches", "nofirstrun-empty");\npref("browser.aboutwelcome.enabled", false);' > /usr/lib/firefox-esr/browser/defaults/preferences/firefox.js && \
update-alternatives --install /usr/bin/x-www-browser x-www-browser /usr/bin/firefox-esr 100 && \
update-alternatives --install /usr/bin/gnome-www-browser gnome-www-browser /usr/bin/firefox-esr 100
# Install noVNC
RUN git clone https://github.com/trycua/noVNC.git /opt/noVNC && \
git clone https://github.com/novnc/websockify /opt/noVNC/utils/websockify && \
ln -s /opt/noVNC/vnc.html /opt/noVNC/index.html
# Install Python packages into /opt/venv (Python 3.13)
RUN uv pip install --python /opt/venv/bin/python3 \
"cua-agent[all]" \
"pywebview[gtk]" \
"cua-bench-ui>=0.7.0" \
"aiohttp>=3.9.0" \
"aiofiles>=23.0.0" \
"websockets>=12.0" \
"rich>=14.2.0" \
"tqdm>=4.66.0" \
"jinja2>=3.1.0" \
"pyquery>=2.0.1" \
"html5lib>=1.1" \
"beautifulsoup4>=4.14.2" \
"pillow>=11.0.0" \
"numpy>=2.0.0" \
"python-dotenv>=1.0.0" \
"psutil>=5.9.0" \
"datasets>=3.0.0" \
"matplotlib>=3.8.0" \
"anthropic>=0.26.0"
# Install the typed Cua Driver SDK and its bundled executable for co-located
# applications. The remote API is cua-spacesd (installed below).
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
# Install cua-spacesd, the in-sandbox daemon (gRPC + gRPC-Web on :3211).
# Same artifact as libs/cua-spacesd/packaging/install.sh installs.
ARG CUA_SPACESD_VERSION=0.1.0
# release (default) installs the published cua-spacesd; none leaves it out
# (pull-request builds before that version is published).
ARG CUA_SPACESD_SOURCE=release
ARG TARGETARCH
RUN set -eux; \
if [ "$CUA_SPACESD_SOURCE" = none ]; then \
echo "CUA_SPACESD_SOURCE=none: cua-spacesd not installed"; exit 0; \
fi; \
[ "$CUA_SPACESD_SOURCE" = release ] || { echo "CUA_SPACESD_SOURCE must be release or none" >&2; exit 1; }; \
case "${TARGETARCH:-$(dpkg --print-architecture)}" in \
amd64|x86_64) arch=x86_64 ;; \
arm64|aarch64) arch=aarch64 ;; \
*) echo "unsupported arch" >&2; exit 1 ;; \
esac; \
url="https://github.com/trycua/cua/releases/download/cua-spacesd-v${CUA_SPACESD_VERSION}/cua-spacesd-${arch}-unknown-linux-gnu.tar.gz"; \
curl -fsSL "$url" | tar -xz -C /usr/local/bin cua-spacesd; \
chmod 0755 /usr/local/bin/cua-spacesd; \
ln -s cua-spacesd /usr/local/bin/cua-env-driver; \
ln -s cua-spacesd /usr/local/bin/cua-guestd
RUN install -d -o cua -g cua -m 0700 /run/cua
# Copy startup scripts
COPY src/supervisor/ /etc/supervisor/conf.d/
COPY src/scripts/ /usr/local/bin/
RUN chmod +x /usr/local/bin/*.sh
# Set ownership and switch to cua user
RUN chown -R cua:cua /home/cua
USER cua
WORKDIR /home/cua
# Create VNC directory
RUN mkdir -p $HOME/.vnc
# Configure XFCE for first start
RUN mkdir -p $HOME/.config/xfce4/xfconf/xfce-perchannel-xml $HOME/.config/xfce4 $HOME/.config/autostart
# Copy XFCE config to disable browser launching and welcome screens
COPY --chown=cua:cua src/xfce-config/helpers.rc $HOME/.config/xfce4/helpers.rc
COPY --chown=cua:cua src/xfce-config/xfce4-session.xml $HOME/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-session.xml
COPY --chown=cua:cua src/xfce-config/xfce4-power-manager.xml $HOME/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-power-manager.xml
# Disable autostart for screensaver, lock screen, and power manager
RUN echo "[Desktop Entry]\nHidden=true" > $HOME/.config/autostart/xfce4-tips-autostart.desktop && \
echo "[Desktop Entry]\nHidden=true" > $HOME/.config/autostart/xfce4-screensaver.desktop && \
echo "[Desktop Entry]\nHidden=true" > $HOME/.config/autostart/light-locker.desktop && \
echo "[Desktop Entry]\nHidden=true" > $HOME/.config/autostart/xfce4-power-manager.desktop
# Create storage and shared directories
RUN mkdir -p $HOME/storage $HOME/shared $HOME/.cache/dconf $HOME/.mozilla/firefox
USER root
# Expose ports
EXPOSE $VNC_PORT $NOVNC_PORT $CUA_ENV_PORT
# Start services via supervisor
CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/supervisord.conf"]