Add Homebrew installation and usage documentation

- Add Homebrew quick start section to getting-started.md
- Add Homebrew usage section to running.md
- Update README with Homebrew option in Try MFC table
- Add macOS Homebrew quick start section to README
- Clarify that -n X sets the number of MPI processes

Author: sbryngelson

README.md

@@ -60,6 +60,7 @@ MFC runs at exascale on the world's fastest supercomputers:
 | Path | Command |
 | --- | --- |
 | **Codespaces** (fastest) | Click the "Codespaces" badge above to launch in 1 click |
+| **Homebrew (macOS)** | `brew install mflowcode/mfc/mfc && mfc run $(brew --prefix mfc)/examples/1D_sodshocktube/case.py -n 2` |
 | **Local build** | `./mfc.sh build -j $(nproc) && ./mfc.sh test -j $(nproc)` |
 
 **Welcome!**
@@ -136,7 +137,23 @@ Click <kbd> <> Code</kbd> (green button at top right) → <kbd>Codespaces</kbd>
 
 You can navigate [to this webpage](https://mflowcode.github.io/documentation/md_getting-started.html) to get you get started using MFC on your local machine, cluster, or supercomputer!
 It's rather straightforward.
-We'll give a brief introdocution for MacOS below.
+
+### macOS quick start (Homebrew)
+
+Install the prebuilt package and run an example:
+
+```bash
+brew install mflowcode/mfc/mfc
+mkdir -p ~/mfc_quickstart && cd ~/mfc_quickstart
+cp $(brew --prefix mfc)/examples/1D_sodshocktube/case.py .
+mfc run case.py -n 2
+```
+
+Use `-n X` to select the number of MPI processes. For developer commands (`build`, `test`, etc.), clone the repo and use `./mfc.sh`.
+
+### macOS from source
+
+We'll give a brief introduction for building from source on MacOS below.
 Using [brew](https://brew.sh), install MFC's dependencies:
 ```shell
 brew install coreutils python cmake fftw hdf5 gcc boost open-mpi lapack

docs/documentation/getting-started.md

@@ -9,6 +9,28 @@ git clone https://github.com/MFlowCode/MFC.git
 cd MFC
 ```
 
+## Install via Homebrew (macOS)
+
+On macOS, install prebuilt MFC via Homebrew:
+
+```bash
+brew install mflowcode/mfc/mfc
+```
+
+Run a quick example:
+
+```bash
+mkdir -p ~/mfc_quickstart && cd ~/mfc_quickstart
+cp $(brew --prefix mfc)/examples/1D_sodshocktube/case.py .
+# Use -n X to choose the number of MPI processes
+mfc run case.py -n 2
+```
+
+Notes:
+- The Homebrew wrapper supports only `mfc run ...`. Developer commands like `build`, `test`, `clean` are available when you clone the repo and use `./mfc.sh`.
+- The package bundles a Python venv and prebuilt binaries; no additional setup is required.
+- Examples are installed at `$(brew --prefix mfc)/examples/`.
+
 ## Build Environment
 
 MFC can be built in multiple ways on various operating systems.

docs/documentation/running.md

@@ -8,6 +8,20 @@ A full (and up-to-date) list of available arguments can be acquired with `./mfc.
 MFC supports running simulations locally (Linux, MacOS, and Windows) as well as
 several supercomputer clusters, both interactively and through batch submission.
 
+## Using the Homebrew package (macOS)
+
+If you installed MFC via Homebrew, run cases with the `mfc` wrapper:
+
+```bash
+mfc run <path/to/case.py> -n 2
+```
+
+- Use `-n X` to control the number of MPI processes (ranks).
+- Only the `run` command is supported in the Homebrew wrapper.
+- To use developer commands (`build`, `test`, `clean`, etc.), clone the repository and use `./mfc.sh`.
+- The wrapper passes through runtime flags like `-t pre_process simulation`, `-n`, and others; it always runs with preinstalled binaries.
+- Examples live at `$(brew --prefix mfc)/examples/`.
+
 > [!IMPORTANT]
 > Running simulations locally should work out of the box. On supported clusters,
 > you can append `-c <computer name>` on the command line to instruct the MFC toolchain