# Install lume with Homebrew Create and manage Apple Silicon-native virtual machines. Version 0.3.10 via Homebrew; verified 2026-06-15. ## Install ```sh sudo av install brew:lume ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install lume ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:lume - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.3.10 - **Source summary:** Create and manage Apple Silicon-native virtual machines - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-15T10:20:20-04:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - lume (cli) - lume (alias) ## Install behavior - Post-install hook: not defined - Service: declared - Bottle: available on arm64_sequoia, arm64_tahoe ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.3.10 - Package-manager updated: 2026-06-15 - Local data: ok - Upstream repository: https://github.com/trycua/cua - Upstream latest detected: lume-v0.3.10 (current) ## Project history and usage Lume is the Cua project's Apple-Silicon-focused VM runtime and CLI for creating and managing macOS and Linux virtual machines with Apple's Virtualization Framework. ### Project history Lume lives inside the `trycua/cua` repository, which was created publicly in January 2025 as open-source infrastructure for computer-use agents, sandboxes, SDKs, and benchmarks. The Lume README describes it as a CLI and framework for macOS and Linux VMs using Apple's Virtualization Framework. The official Lume introduction frames the project around agent workloads, CI/CD, and macOS automation. It exposes a single binary with an HTTP API, can create and run VMs headlessly, and is designed to be used directly from the CLI or programmatically through `lume serve`. ### Adoption history Lume's adoption is tied to the rapid growth of computer-use agents and the practical need for reproducible macOS sandboxes on Apple Silicon. The Cua repository accumulated substantial GitHub attention during 2025-2026, and the README positions Lume alongside Cua drivers, sandbox SDKs, and benchmarks as one of the monorepo's core packages. Homebrew packages the `lume` binary, while upstream docs also advertise install scripts and VM image pull/run workflows. The project is newer than traditional VM managers, so its package history is still forming around AI-agent, local CI, and macOS automation use cases. ### How it is used The official docs show `lume create test-vm --os macos --ipsw latest` followed by `lume run test-vm`, and the repository README shows pulling and starting a macOS VM image with `lume run macos-sequoia-vanilla:latest`. Lume is intended for testing across macOS versions, automating macOS tasks, running local CI/CD, sandboxing risky operations, and building AI agents that interact with virtualized desktops through the broader Cua stack. ### Why package nerds care Lume is significant to package nerds because it packages a native macOS virtualization workflow into a CLI, not a heavyweight desktop app. Its constraints are also unusually concrete: Apple Silicon only, Apple's Virtualization Framework, IPSW-based macOS setup, sparse VM storage, headless operation, registries such as GHCR or GCS, and integration with agent tooling. ### Timeline - 2025: Cua repository created publicly. - 2025-2026: Lume documented as the monorepo's macOS/Linux VM management package. - 2026: Cua repository shows hundreds of releases across monorepo components and active Lume documentation. - 2026: Homebrew formula available for the `lume` CLI. ### Related projects - Cua Computer SDK uses Lume's API for macOS automation workflows. - Apple Virtualization Framework is the native virtualization layer Lume builds on. - The Cua monorepo also includes Cua drivers, Cua sandbox packages, and Cua Bench. ### Sources - - - - - - ## Security Notes formula declares a Homebrew service. infrastructure mutation or orchestration signal. - **Geiger risk:** orange / medium - formula declares a Homebrew service - infrastructure mutation or orchestration signal ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** lume - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Requirements:** arch, macos, xcode - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [lima](https://www.automicvault.com/pkg/brew/lima/) - Shares av.db curated category or tags: cli, macos, system, virtual-machines, virtualization. - [libosinfo](https://www.automicvault.com/pkg/brew/libosinfo/) - Shares av.db curated category or tags: cli, system, virtualization. - [nemu](https://www.automicvault.com/pkg/brew/nemu/) - Shares av.db curated category or tags: cli, system, virtualization. - [osinfo-db-tools](https://www.automicvault.com/pkg/brew/osinfo-db-tools/) - Shares av.db curated category or tags: cli, system, virtualization. - [qemu](https://www.automicvault.com/pkg/brew/qemu/) - Shares av.db curated category or tags: cli, system, virtualization. - [virt-manager](https://www.automicvault.com/pkg/brew/virt-manager/) - Shares av.db curated category or tags: cli, system, virtualization. - [vmdktool](https://www.automicvault.com/pkg/brew/vmdktool/) - Shares av.db curated category or tags: cli, system, virtualization. - [asitop](https://www.automicvault.com/pkg/brew/asitop/) - Shares av.db curated category or tags: apple-silicon, cli, macos, system. - [m1ddc](https://www.automicvault.com/pkg/brew/m1ddc/) - Local package facts share a topical domain. Shared terms: apple, apple-silicon, ci, cli, macos. ## Combined YAML source View the package source record on GitHub. [combined/lume.yml](https://github.com/automic-vault/db/blob/main/combined/lume.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph