Install faxl

Get the code, install it, install your key. If you do not have a key yet, get one — it is free.

This page covers one Mac. To run faxl across several machines, see faxl on a cluster.

The code

Get the code

The Mac release lives on GitHub: two Python wheels, the tester instructions, and an AGENTS.md so your agent can drive it directly over MCP.

The code is free to take. It needs your licence key to accelerate: without one the proxy still serves, it just stops skipping prefill. The console shows the countdown to expiry.

Apple silicon

Install

You need a Mac with an M-series chip, Python 3.12, and about 40 GB free for the default model's one-time download.

From the folder holding the two wheel files:

python3.12 -m venv faxl-env && source faxl-env/bin/activate
pip install ./faxl-0.1.0-cp39-abi3-macosx_11_0_arm64.whl \
            ./UltraDim-0.3.7-cp312-cp312-macosx_11_0_arm64.whl \
            mlx mlx-lm

# persistent cache dirs, so warmed state survives restarts
export FAXL_BLOBS="$HOME/faxl-cache/blobs" FAXL_DB="$HOME/faxl-cache/db"
faxl-proxy

The whole engine ships inside the wheel. The console is at http://faxl.localhost:8767/console. To use a different model from the mlx-community collection, set FAXL_MODEL before starting.

Install your key

Save the key from your confirmation email to ~/.faxl-licence, or point FAXL_LICENCE at it, then restart the proxy. It verifies offline — no phone-home, no licence server, works on a plane. The console shows whose key it is and how long it has left.

Other platforms

NVIDIA and Windows

The NVIDIA/vLLM port passes the same byte-identity tests on GPU and is not yet released. If you want it, tell us what you run and we will come back to you when it is ready — andrew@gamakon.ai.