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.

2.0 KB
Raw Blame

Lume

CLI and framework for macOS and Linux VMs using Apple Virtualization Framework.

Documentation - Installation, guides, and API reference.

Vanilla macOS VMs

Create a fresh macOS VM from an Apple restore image with the offline unattended setup enabled:

lume create macos-tahoe --ipsw ~/Downloads/macos-tahoe.ipsw --unattended tahoe
lume run macos-tahoe

The built-in sequoia and tahoe presets configure the installed guest without GUI automation. They create the lume user, enable SSH, configure autologin, and disable sleep and screen locking. The default SSH credentials are lume / lume.

Tahoe is E2E verified from a local IPSW. Sequoia can still present the Accessibility step of Setup Assistant on its first display boot; this is tracked in #2155.

To use the other built-in preset, replace tahoe with sequoia in the --unattended option and choose a matching VM name.

Optional dependencies

The lume sip command uses vncdotool to control macOS Recovery over VNC. Install it only if you need to enable or disable SIP:

pip3 install vncdotool

Other Lume commands do not require this package.

Telemetry

Lume telemetry is enabled by default and records pseudonymous installation, release, command, and API-event metadata. It does not collect prompts, VM/image names, file paths, command arguments, or VM contents.

lume config telemetry status
lume config telemetry disable
lume config telemetry enable
lume config telemetry reset-id

LUME_TELEMETRY_ENABLED overrides the persisted preference for the current process. A normal uninstall preserves the preference and pseudonymous installation ID so a reinstall is recognized as returning. uninstall.sh --purge deletes the ID, markers, configuration, cache, and VMs.

See Telemetry and privacy for the exact schema-v3 events, integrity controls, and excluded data.