zerobrewhq/zerobrew

zerobrew

English · 中文

zerobrew brings uv-style architecture to Homebrew packages on macOS and Linux.

curl -fsSL https://zerobrew.rs/install | bash

The installer updates your shell config. After it finishes, restart your terminal or run the source command it prints.

Or via Homebrew:

brew install zerobrewhq/tap/zerobrew

If you used the standalone installer, rerun it:

curl -fsSL https://zerobrew.rs/install | bash
zb --version

If you installed with Homebrew:

brew update && brew upgrade zerobrew

If you installed from the old lucasgelfond/zerobrew tap, it's no longer updated. Switch to the new one:

brew uninstall zerobrew
brew untap lucasgelfond/zerobrew
brew install zerobrewhq/tap/zerobrew

The cachebag/zerobrew and zerobrewhq/zerobrew taps were moved to zerobrewhq/tap and keep updating; nothing to do.

To opt in to a brew compatibility entrypoint:

zb install-alias brew
brew install jq
zb install-alias brew --remove

This creates brew -> zb-brew beside zb; ensure that directory is on PATH. You can also enable it during installation:

curl -fsSL https://zerobrew.rs/install | bash -s -- --brew-compat

Enabling it refuses existing Homebrew or other brew entrypoints on PATH and standard Homebrew locations, and never replaces an existing file. Removing it only deletes zerobrew's own symlink. If zb-brew is missing, reinstall zerobrew.

The entrypoint supports install, uninstall, list, info, outdated, upgrade, doctor, bundle, and update, using the arguments and output supported by zb. cleanup runs zb gc and only removes unreferenced store entries. update refreshes the formula index; it does not update zerobrew itself. Commands such as search, services, and tap, and flags such as --cask and list --formula, are not implemented and fail with a compatibility error. zb migrate requires real Homebrew on PATH and refuses this entrypoint.

zb install jq                   # install one package
zb install wget git             # install multiple
zb bundle                       # install from Brewfile
zb bundle install -f myfile     # install from custom file
zb bundle dump                  # export installed packages to Brewfile
zb bundle dump -f out --force   # dump to custom file (overwrite)
zb uninstall jq                 # uninstall one package
zb outdated                     # list packages with newer versions
zb upgrade                      # upgrade all outdated packages
zb upgrade jq wget              # upgrade specific packages
zb reset                        # uninstall everything
zb gc                           # garbage collect unused store entries
zbx jq --version                # run without linking

Automatic initialization (--auto-init or ZEROBREW_AUTO_INIT=true) and zb reset create data directories without changing shell configuration. Run zb init explicitly to configure your shell, or zb init --no-modify-path to leave it unchanged.

Measured on 2026-10-23 with zerobrew 0.4.2 and Homebrew 7.0.10 on macOS 26.6.2, MacBook Pro (M3 Pro, 18 GB RAM), wired, ~436 Mbit/s download bandwidth. Homebrew started with nothing installed.

• Cold: the package and all of its dependencies uninstalled, empty download cache.
• Warm: the package and all of its dependencies uninstalled, downloads from the cold run still cached.
• The median package was 7.5x faster cold and 62x faster warm. Per package, cold ranged from 1.7x (go) to 27x (certifi) and warm from 4.0x (fontconfig) to 275x (p11-kit). 86 of the 100 packages installed at least 5x faster cold, and 19 installed 100x faster or more warm.
• Both tools run post-install steps. ca-certificates' step builds the CA bundle from the system keychain, which costs Homebrew about 8 seconds and used to cost zerobrew the same on every package that depends on it, most of the table. Since 0.4.2 zerobrew builds that bundle in process, byte for byte, in well under a second; the run from before that (results/2026-10-12) was 3.6x cold. fontconfig's fc-cache is the same kind of step and is not ported yet (#448), which is what holds fontconfig, harfbuzz, cairo and pango under 10x warm.
• Cold installs are bound by the link. The same run on a ~80 Mbit/s connection two days earlier (results/2026-10-21) came out at 3.7x cold overall, with go and llvm at the speed of the download, while the median package was still 6.2x. Homebrew's total barely moves with bandwidth; zerobrew's is mostly bandwidth.
• Warm installs use more disk. After an uninstall brew keeps the bottle, we keep the bottle and the unpacked keg in the store. That is the main tradeoff here.

To reproduce, run just bench --full results/ on a machine with nothing installed in Homebrew. It resets zerobrew, uninstalls everything it installed in Homebrew, and writes a table to results/benchmark.md.

A smaller version runs in CI: the parity workflow installs a fixed set of formulae with both tools on the same runner and compares the resulting prefixes byte for byte, and the timing workflow times those formulae plus node and python@3.14, cold and warm, with both tools and with the last zerobrew release.

The nightly timing run fails if zerobrew is less than 1.5x faster than Homebrew cold or 3x warm on any of them, or more than 20% slower than the last release overall.

WRT Homebrew, I want it to be clear that both brew and zerobrew install the same bottles from Homebrew's build farm.

The difference is what happens after the download: Homebrew runs Ruby to evaluate the formula, unpacks, rewrites paths with install_name_tool, and re-signs each binary one at a time, while zerobrew does the relocation in-process and links from a content-addressed store, so it pays for the download once and almost nothing after.

I want it to be clear that we are basically nothing without Homebrew's bottle build farm. Every package zerobrew installs is one they built, tested and published. We don't compile anything, we don't maintain formulae, and none of these numbers exist without that work. The speed comes from how the artifacts are installed, not from what's in them.

This is a good read, if you're interested in what zerobrew is and isn't: Standing on the shoulders of Homebrew by Andrew Nesbitt. It makes the point better than I can.

nanobrew:

nanobrew’s published numbers time a “warm install” of a package that is already installed, which is an early exit, not an install, and compare against zerobrew 0.1.0.

Every number above is a real install from an uninstalled state, with the script and the full log in this repo, so you can run it yourself.

zerobrew is more of a performance-optimized client for the Homebrew ecosystem. We rely on:

• Homebrew's formula definitions (homebrew-core)
• Homebrew's pre-built bottles when available
• Homebrew's package metadata and infrastructure

Our innovations focus on:

• Content-addressable storage for deduplication
• APFS clonefiles for zero-overhead copying
• Source build fallback using Homebrew's Ruby DSL

zerobrew is experimental. We recommend running it alongside Homebrew rather than as a replacement, and do not recommend purging homebrew and replacing it with zerobrew unless you are absolutely sure about the implications of doing so.

• Status: Experimental, but quite useful. I (@cachebag) daily drive it myself.
• Feedback: If you hit incompatibilities, please open an issue or PR.
• License: Dual-licensed under Apache 2.0 OR MIT, at your choice. The source build shim and the post-install runner are derived from Homebrew and are covered by its BSD 2-Clause license.