brew

# 🍺 Homebrew

[![Latest GitHub release](https://img.shields.io/github/release/Homebrew/brew.svg)](https://github.com/Homebrew/brew/releases)
[![BSD-2-Clause License](https://img.shields.io/github/license/Homebrew/brew)](https://github.com/Homebrew/brew/blob/HEAD/LICENSE.txt)
[![GitHub Sponsors](https://img.shields.io/github/sponsors/homebrew?label=GitHub%20Sponsors)](https://github.com/sponsors/Homebrew)
[![Open Collective backers and sponsors](https://img.shields.io/opencollective/all/homebrew?label=Open%20Collective)](https://opencollective.com/homebrew)

See [Homebrew's homepage at `brew.sh`](https://brew.sh) for installation instructions, what homebrew does, packages, `brew bundle` and more.

<img src="https://brew.sh/assets/img/brew-install.gif" alt="Homebrew install demo" width="580" height="424">

## 💸 Donations

Homebrew is a non-profit project run entirely by volunteers, not employees.
We need your funds to pay for software, hardware and hosting around continuous integration and future improvements to the project.
Every donation will be spent on making Homebrew better for our users.

Please consider a regular donation through [GitHub Sponsors](https://github.com/sponsors/Homebrew), [Open Collective](https://opencollective.com/homebrew) or [Patreon](https://www.patreon.com/homebrew).
Read about [sponsoring Homebrew](https://docs.brew.sh/Sponsoring-Homebrew).
Homebrew is fiscally hosted by the [Open Source Collective](https://opencollective.com/opensource).

## 📚 Documentation

Read the Homebrew manual with [`man brew`](https://docs.brew.sh/Manpage).

Read [installation](https://docs.brew.sh/Installation),
[troubleshooting](https://docs.brew.sh/Troubleshooting),
[contribution](https://github.com/Homebrew/brew/blob/HEAD/docs/How-To-Open-a-Homebrew-Pull-Request.md)
including the [FAQ](https://docs.brew.sh/FAQ) on [`docs.brew.sh`](https://docs.brew.sh/).

Read the [Homebrew Blog](https://brew.sh/blog/) for release notes, project updates and announcements.

## 📦 Packages
Find [formulae](https://formulae.brew.sh/formula/), [casks](https://formulae.brew.sh/cask/), dependencies, versions and package metadata on [`formulae.brew.sh`](https://formulae.brew.sh).

View anonymised install, build and operating system usage data at [`formulae.brew.sh/analytics`](https://formulae.brew.sh/analytics/).
Read how Homebrew uses [Anonymous Analytics](https://docs.brew.sh/Analytics).

## 🔧 Get Help

First, please run `brew update` and run (and **read**) `brew doctor`.

Second, read the [Troubleshooting Checklist](https://docs.brew.sh/Troubleshooting).

**If you don't read these it will take us far longer to help you with your problem.**

After this, if you still need help, please ask in
[Homebrew/discussions](https://github.com/orgs/Homebrew/discussions)
or follow (and **read**) the
[Homebrew/brew new issue chooser](https://github.com/Homebrew/brew/issues/new/choose).

## 💬 Social

Follow Homebrew on [Mastodon](https://fosstodon.org/@homebrew),
[Bluesky](https:/