zerobrew README

The project's README from github.com/zerobrewhq/zerobrew. As one markdown file: README.md.

zerobrew

English · 中文

Lint Test Release Discord License: MIT License: Apache 2.0

zerobrew demo

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

[!WARNING] zerobrew is currently unmaintained. Please contact [email protected] or [email protected] for CVE's or other critical security issues

Install

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 lucasgelfond/zerobrew/zerobrew

Update 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

Quick start

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

Performance snapshot

Package Homebrew ZB (cold) ZB (warm) Cold Speedup Warm Speedup
Overall (top 100) 452s 226s 59s 2.0x 7.6x
ffmpeg 3034ms 3481ms 688ms 0.9x 4.4x
libsodium 2353ms 392ms 130ms 6.0x 18.1x
sqlite 2876ms 625ms 159ms 4.6x 18.1x
tesseract 18950ms 5536ms 643ms 3.4x 29.5x

Relationship with Homebrew

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

Our innovations focus on:

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.

Project status

Star History Chart

zerobrew (zerobrewhq/zerobrew)

Searching Database…

What is this?zerobrew is a performance-optimized client for the Homebrew package ecosystem on macOS and Linux, claiming up to 100x faster installs by bringing uv-style architecture to Homebrew packages.
Is this a replacement for Homebrew, or does it work alongside it?It is not a replacement; it is a client layered on top of the Homebrew ecosystem, reusing Homebrew's formula definitions, pre-built bottles, and package metadata while adding its own storage and copy optimizations.
Do I need Homebrew already set up to use it?Not stated explicitly, but since zerobrew relies on Homebrew's formula definitions, bottles, and metadata, having the Homebrew ecosystem available is implied.
Is it safe to fully replace Homebrew with this right now?No — the project is explicitly experimental and currently unmaintained, and the authors recommend running it alongside Homebrew rather than purging Homebrew in its favor.
Does it work on both macOS and Linux?Yes, it targets both macOS and Linux as part of the Homebrew ecosystem.
Where can I run zerobrew?On macOS and Linux systems, wherever Homebrew formulas are normally used.
How much faster is it than Homebrew in practice?On a top-100 package benchmark, zerobrew was about 2.0x faster on a cold cache and 7.6x faster on a warm cache overall; individual packages like 'tesseract' saw up to 29.5x speedup when warm.
What makes zerobrew faster than Homebrew?It adds content-addressable storage for deduplication, APFS clonefiles for zero-overhead copying on macOS, and falls back to source builds using Homebrew's Ruby DSL when no bottle is available.
Is the project still being actively developed?No — the README flags it as currently unmaintained, and security issues should be reported directly by email to the maintainers rather than through normal channels.
How do I update zerobrew after installing it?If installed via the standalone script, rerun that installer; if installed via Homebrew, update it the same way you update any Homebrew-installed formula.
What are similar projects?ripgrep, bashka, brew, homebrew-cask, rye, veet, dust, hexyl
Creator
zerobrewhq
Size
4.2 MB
Stars
8.2K
Age
8mo
Commits · 90 Days