From d8edc3bb515575b12bae39f91cd016af5440b1a0 Mon Sep 17 00:00:00 2001 From: Dillon DuPont Date: Tue, 14 Oct 2025 11:36:41 -0400 Subject: [PATCH 1/2] Add multiplatform build docs, fix incorrect image name --- docs/content/docs/computer-sdk/computers.mdx | 4 ++-- docs/content/docs/quickstart-cli.mdx | 2 +- libs/kasm/README.md | 23 +++++++++----------- libs/xfce/README.md | 17 +++++++++------ 4 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/content/docs/computer-sdk/computers.mdx b/docs/content/docs/computer-sdk/computers.mdx index 1c3558da..f2dce7ab 100644 --- a/docs/content/docs/computer-sdk/computers.mdx +++ b/docs/content/docs/computer-sdk/computers.mdx @@ -63,7 +63,7 @@ Cua provides two Docker images for running Linux desktops: 2. Pull the CUA XFCE image ```bash - docker pull --platform=linux/amd64 trycua/cua-xfce:latest + docker pull --platform=linux/amd64 trycua/cua-docker-xfce:latest ``` 3. Connect with Computer @@ -74,7 +74,7 @@ Cua provides two Docker images for running Linux desktops: computer = Computer( os_type="linux", provider_type="docker", - image="trycua/cua-xfce:latest", + image="trycua/cua-docker-xfce:latest", name="my-xfce-container" ) diff --git a/docs/content/docs/quickstart-cli.mdx b/docs/content/docs/quickstart-cli.mdx index 7bf53773..c8d4eafe 100644 --- a/docs/content/docs/quickstart-cli.mdx +++ b/docs/content/docs/quickstart-cli.mdx @@ -47,7 +47,7 @@ Choose how you want to run your cua computer. **Cloud Sandbox is recommended** f 2. Pull the CUA XFCE container (lightweight desktop) ```bash - docker pull --platform=linux/amd64 trycua/cua-xfce:latest + docker pull --platform=linux/amd64 trycua/cua-docker-xfce:latest ``` Or use KASM for a full-featured desktop: diff --git a/libs/kasm/README.md b/libs/kasm/README.md index 2a383535..884f7ed7 100644 --- a/libs/kasm/README.md +++ b/libs/kasm/README.md @@ -13,23 +13,20 @@ Containerized virtual desktop for Computer-Using Agents (CUA). Utilizes Kasm's M ## Usage -### Building the Container +### Build and Push (multi-arch) + +Use Docker Buildx to build and push a multi-architecture image for both `linux/amd64` and `linux/arm64` in a single command. Replace `trycua` with your Docker Hub username or your registry namespace as needed. ```bash -docker build -t cua-ubuntu:latest . -``` - -### Pushing to Registry - -```bash -# Tag for Docker Hub (replace 'trycua' with your Docker Hub username) -docker tag cua-ubuntu:latest trycua/cua-ubuntu:latest - -# Login to Docker Hub +# Login to your registry first (Docker Hub shown here) docker login -# Push to Docker Hub -docker push trycua/cua-ubuntu:latest +# Build and push for amd64 and arm64 in one step +docker buildx build \ + --platform linux/amd64,linux/arm64 \ + -t trycua/cua-ubuntu:latest \ + --push \ + . ``` ### Running the Container Manually diff --git a/libs/xfce/README.md b/libs/xfce/README.md index 9ecdff00..130f1296 100644 --- a/libs/xfce/README.md +++ b/libs/xfce/README.md @@ -41,17 +41,20 @@ Vanilla XFCE desktop container for Computer-Using Agents (CUA) with noVNC and co docker build -t cua-docker-xfce:latest . ``` -## Pushing to Registry +### Build and Push (multi-arch) + +Use Docker Buildx to build and push a multi-architecture image for both `linux/amd64` and `linux/arm64` in a single command. Replace `trycua` with your Docker Hub username or your registry namespace as needed. ```bash -# Tag for Docker Hub (replace 'trycua' with your Docker Hub username) -docker tag cua-docker-xfce:latest trycua/cua-docker-xfce:latest - -# Login to Docker Hub +# Login to your registry first (Docker Hub shown here) docker login -# Push to Docker Hub -docker push trycua/cua-docker-xfce:latest +# Build and push for amd64 and arm64 in one step +docker buildx build \ + --platform linux/amd64,linux/arm64 \ + -t trycua/cua-docker-xfce:latest \ + --push \ + . ``` ## Running the Container Manually From b9e73fc622485fc07a3f08eac4e5b195b3de693e Mon Sep 17 00:00:00 2001 From: Dillon DuPont Date: Wed, 15 Oct 2025 15:38:55 -0400 Subject: [PATCH 2/2] rename cua-docker-xfce to cua-xfce --- docs/content/docs/computer-sdk/computers.mdx | 4 ++-- docs/content/docs/quickstart-cli.mdx | 2 +- libs/python/computer/computer/providers/docker/provider.py | 2 +- libs/xfce/README.md | 6 +++--- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/content/docs/computer-sdk/computers.mdx b/docs/content/docs/computer-sdk/computers.mdx index f2dce7ab..1c3558da 100644 --- a/docs/content/docs/computer-sdk/computers.mdx +++ b/docs/content/docs/computer-sdk/computers.mdx @@ -63,7 +63,7 @@ Cua provides two Docker images for running Linux desktops: 2. Pull the CUA XFCE image ```bash - docker pull --platform=linux/amd64 trycua/cua-docker-xfce:latest + docker pull --platform=linux/amd64 trycua/cua-xfce:latest ``` 3. Connect with Computer @@ -74,7 +74,7 @@ Cua provides two Docker images for running Linux desktops: computer = Computer( os_type="linux", provider_type="docker", - image="trycua/cua-docker-xfce:latest", + image="trycua/cua-xfce:latest", name="my-xfce-container" ) diff --git a/docs/content/docs/quickstart-cli.mdx b/docs/content/docs/quickstart-cli.mdx index c8d4eafe..7bf53773 100644 --- a/docs/content/docs/quickstart-cli.mdx +++ b/docs/content/docs/quickstart-cli.mdx @@ -47,7 +47,7 @@ Choose how you want to run your cua computer. **Cloud Sandbox is recommended** f 2. Pull the CUA XFCE container (lightweight desktop) ```bash - docker pull --platform=linux/amd64 trycua/cua-docker-xfce:latest + docker pull --platform=linux/amd64 trycua/cua-xfce:latest ``` Or use KASM for a full-featured desktop: diff --git a/libs/python/computer/computer/providers/docker/provider.py b/libs/python/computer/computer/providers/docker/provider.py index 850300b6..97622a29 100644 --- a/libs/python/computer/computer/providers/docker/provider.py +++ b/libs/python/computer/computer/providers/docker/provider.py @@ -56,7 +56,7 @@ class DockerProvider(BaseVMProvider): image: Docker image to use (default: "trycua/cua-ubuntu:latest") Supported images: - "trycua/cua-ubuntu:latest" (Kasm-based) - - "trycua/cua-docker-xfce:latest" (vanilla XFCE) + - "trycua/cua-xfce:latest" (vanilla XFCE) verbose: Enable verbose logging ephemeral: Use ephemeral (temporary) storage vnc_port: Port for VNC interface (default: 6901) diff --git a/libs/xfce/README.md b/libs/xfce/README.md index 130f1296..cd7f2bb1 100644 --- a/libs/xfce/README.md +++ b/libs/xfce/README.md @@ -52,7 +52,7 @@ docker login # Build and push for amd64 and arm64 in one step docker buildx build \ --platform linux/amd64,linux/arm64 \ - -t trycua/cua-docker-xfce:latest \ + -t trycua/cua-xfce:latest \ --push \ . ``` @@ -111,7 +111,7 @@ from computer import Computer computer = Computer( os_type="linux", provider_type="docker", - image="trycua/cua-docker-xfce:latest", # Use docker-xfce instead of Kasm + image="trycua/cua-xfce:latest", # Use docker-xfce instead of Kasm display="1024x768", memory="4GB", cpu="2" @@ -147,7 +147,7 @@ computer_kasm = Computer( computer_xfce = Computer( os_type="linux", provider_type="docker", - image="trycua/cua-docker-xfce:latest", # docker-xfce image + image="trycua/cua-xfce:latest", # docker-xfce image ) ```