# 使用 Homebrew 安装 lume

查看 lume 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:lume
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install lume
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:lume
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/lume>
- **版本:** 0.5.1
- **来源摘要:** Create and manage Apple Silicon-native virtual machines
- **主页:** <https://cua.ai>
- **仓库:** <https://github.com/trycua/cua>
- **上游文档:** <https://cua.ai>
- **许可证:** MIT
- **源码归档:** <https://github.com/trycua/cua/archive/refs/tags/lume-v0.5.1.tar.gz>
- **最后更新:** 2026-07-31T12:53:37Z
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- lume (cli)
- lume (别名)

## 安装行为

- post-install 钩子: 未定义
- 服务: declared
- Bottle: 可用 于 arm64_sequoia, arm64_tahoe

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 0.5.1
- 管理器更新时间: 2026-07-31
- 本地数据: OK
- 上游仓库: https://github.com/trycua/cua
- 检测到的最新版本: lume-v0.5.1 (当前)
## 项目历史与用法

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.

### 项目历史

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`.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- <https://api.github.com/repos/trycua/cua>
- <https://api.github.com/repos/trycua/cua/releases>
- <https://cua.ai/docs/lume/guide/getting-started/introduction>
- <https://formulae.brew.sh/formula/lume>
- <https://github.com/trycua/cua>
- <https://github.com/trycua/cua/tree/main/libs/lume>


## 安全说明

formula declares a Homebrew service. infrastructure mutation or orchestration signal.

- **Geiger 风险:** orange / 中
- formula declares a Homebrew service
- infrastructure mutation or orchestration signal

## 源数据库详情

- **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:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## 相关链接

- [Secret-risk packages](https://pkg.so/zh-hans/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Developer build packages](https://pkg.so/zh-hans/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://pkg.so/zh-hans/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [lima](https://pkg.so/zh-hans/brew/lima/) - Shares pkgdb curated category or tags: cli, macos, system, virtual-machines, virtualization.
- [qemu](https://pkg.so/zh-hans/brew/qemu/) - Shares pkgdb curated category or tags: cli, system, virtualization.
- [libosinfo](https://pkg.so/zh-hans/brew/libosinfo/) - Shares pkgdb curated category or tags: cli, system, virtualization.
- [osinfo-db-tools](https://pkg.so/zh-hans/brew/osinfo-db-tools/) - Shares pkgdb curated category or tags: cli, system, virtualization.
- [nemu](https://pkg.so/zh-hans/brew/nemu/) - Shares pkgdb curated category or tags: cli, system, virtualization.
- [cliclick](https://pkg.so/zh-hans/brew/cliclick/) - Shares pkgdb curated category or tags: automation, cli, macos, system.
- [mactop](https://pkg.so/zh-hans/brew/mactop/) - Shares pkgdb curated category or tags: apple-silicon, cli, macos, system.
- [macmon](https://pkg.so/zh-hans/brew/macmon/) - Shares pkgdb curated category or tags: apple-silicon, cli, macos, system.
- [m1ddc](https://pkg.so/zh-hans/brew/m1ddc/) - Local package facts share a topical domain. Shared terms: apple, apple-silicon, ci, cli, macos.
- [batt](https://pkg.so/zh-hans/brew/batt/) - Local package facts share a topical domain. Shared terms: apple, apple-silicon, cli, macos, silicon.

## Combined YAML source

View the package source record on GitHub. [combined/lume.yml](https://github.com/mxcl/pkgdb/blob/main/combined/lume.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- cross-ecosystem install command graph
