macOS
CLI available
Signed .dmg Not published
The signed desktop app is not published yet. Homebrew is the available path for the CLI and host runtime.
The curl installer also selects Homebrew on macOS. Installation
Install for this machine.
Asterism selects the best real path for your OS. Signed desktop artifacts will appear here when they ship.Available nowCLI · Homebrew, curl, source
macOS appSigned .dmg not published
Windows appNative backend not ready
LinuxExperimental
Selected platform
macOS is the accessible default. Detection runs after this page loads.
Windows
Native path unavailable
Windows .exe Not published
The Windows installer and native backend are not ready. Asterism runs on Windows hardware through Linux in WSL2.
Use the WSL / Linux path You can also inspect the source and follow native Windows progress on GitHub. Linux
Experimental
Source install Not published
Linux uses the curl or source path today. QEMU/KVM works, but the install path remains experimental and is not launch-verified.
Git, Rust, QEMU/KVM, and firmware must already be available.Install
Install the CLI
The script chooses the available path for this machine.
Before changes
The script prints each privileged command and asks for confirmation. It does not install Homebrew or Rust.
Read install.sh →Homebrew directlymacOS developer path · builds from the repository
Verify
Verify the installation
Check the binary and catalog without booting an instance.
ast 0.0.2
ubuntu:24.04 arm64, x86_64
debian:13 arm64, x86_64
fedora:42 arm64, x86_64
alpine:3.22 arm64, x86_64Create
Create the agent’s home
Create it once, then return to the same disk and identity.Create
Start and connect
ast snapshot agent-home cleanSave a known-good disk state.ast logs agent-home -fFollow the guest console.ast down agent-homeShut down cleanly.Agent
Hand installation to an agent
This prompt installs and verifies, then stops.Install the Asterism CLI on this machine and verify it, then report back.
1. Run `curl -fsSL https://asterism.run/install.sh | sh`. On macOS it installs through Homebrew. Linux builds from source and is not launch-verified. The script prints every privileged command and waits for a y, so set ASTERISM_YES=1 if you cannot answer prompts. If it stops because something is missing, tell me what it named; do not install anything else on your own.
2. Verify: `ast --version`, then `ast images`, which lists the image catalog without starting a daemon or touching the network.
3. Report the installed version and the catalog. Do not pull an image or boot an instance unless I ask for that separately.
State lives in ~/.asterism. `ast --help` lists every command.Notes
Platform notes
Current support boundaries.macOS
Homebrew builds Asterism. The native Virtualization.framework backend is the default when it satisfies the request.
Best testedLinux
The script builds from source into ~/.local/bin. Git, Rust, QEMU/KVM, and firmware must be available.
Windows
The native backend is not built. Use the Linux path inside WSL2 on supported Windows hardware.
WSL2 pathKeep the agent running after you disconnect.
Reconnect withast ssh agent-home.