CuaReferenceDesktop Sandbox

QEMU Container

Full virtual machines running in Docker via QEMU/KVM for Computer-Using Agents

Full virtual machines running in Docker via QEMU/KVM. Complete OS isolation with support for Windows, Linux, and Android.

Available Containers

ContainerOSDescription
WindowsWindows 11Windows desktop with KVM
LinuxUbuntu 22.04Full Ubuntu VM
AndroidAndroid 11Android emulator

Key Features

  • Complete OS isolation — Full virtual machines with dedicated kernels
  • Windows support — Run Windows 11 in Docker
  • Memory snapshots — Save and restore full VM state including running processes
  • KVM acceleration — Near-native performance on Linux hosts with KVM support

Requirements

  • Linux host with KVM support
  • Docker with --device=/dev/kvm access

Quick Start

from computer import Computer

async with Computer(
    os_type="windows",
    provider_type="docker",
    image="trycua/cua-qemu-windows:latest",
) as computer:
    screenshot = await computer.interface.screenshot()

Was this page helpful?


On this page