Lume
Create and run macOS and Linux VMs on Apple silicon from the CLI, a local HTTP API or MCP.
Lume runs macOS and Linux virtual machines (VMs) on an Apple silicon Mac, using
Apple's Virtualization.framework. It builds a vanilla macOS VM straight from
Apple's restore image, with SSH and autologin ready. You control the same VMs
from the lume command, a local HTTP API or an MCP server for AI clients.
lume create macos-tahoe --ipsw latest --unattended tahoe
lume run macos-tahoe
lume ssh macos-tahoe 'sw_vers'The cua SDK installs and drives Lume for you when you ask for a local macOS sandbox. Use Lume directly when you want to manage the VMs yourself.
| Requirement | Detail |
|---|---|
| Host | Apple silicon, macOS 13 or later |
| Memory | 8 GB free (16 GB for an 8 GB guest) |
| Disk | 50 GB free per macOS guest plus its restore image |
| Concurrency | Up to two macOS guests at a time (Apple's limit) |
Next#
- Quickstart: install Lume, create a Tahoe VM, SSH in.
- Manage VMs: run, share folders, clone, resize, turn SIP off, update, and use the HTTP API or MCP.
- GPU passthrough: unlock more Metal features for one workload.
- Linux guests: Omarchy on ARM64, and an OpenClaw gateway.
- How Lume works: unattended setup, SIP, disk growth and telemetry.