Lume

Lume is a lightweight CLI and local API server for creating, running, and managing macOS and Linux virtual machines with near-native performance on Apple Silicon.

Built on Apple's Virtualization.Framework, Lume was the first open-source product released by trycua - providing the foundation for the Computer Use Agent SDK.

Key Features

• Near-native performance - Run macOS VMs at native speed using Apple's Virtualization Framework
• Simple CLI - Create, run, and manage VMs with intuitive commands
• Unattended setup - Automate macOS installation and configuration with YAML files
• HTTP API - Integrate with your tools via the built-in REST API server

Quick Start

# Install Lume
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

# Create a custom macOS VM
lume create my-vm --os macos --ipsw latest

# Run the VM
lume run my-vm

Next Steps

• Installation Guide - Detailed installation options
• Quickstart - Create your first VM
• Unattended Setup - Automate VM configuration
• CLI Reference - Full command reference
• HTTP API Reference - REST API documentation