THE FIELD GUIDE

Installation

fxcss is on PyPI. Install it with pipx, which gives it its own environment and puts fxcss on your PATH:

bash
pipx install "fxcss[images]"

No pipx yet? brew install pipx (macOS), sudo apt install pipx (Debian and Ubuntu), or python3 -m pip install --user pipx elsewhere.

Why not plain pip? On current Homebrew, Debian and Ubuntu Pythons, python3 -m pip install refuses with error: externally-managed-environment — that's PEP 668 protecting your system Python, not fxcss being broken. pipx is the intended answer for installing an application. pip still works fine inside a virtual environment:

bash
python3 -m venv ~/.venvs/fxcss && ~/.venvs/fxcss/bin/pip install "fxcss[images]"

For CI, or anywhere a surprise upgrade would be unwelcome, pin the release — the releases page has the latest. CI runners' Pythons are not externally managed, so plain pip is fine there:

bash
pip install "fxcss[images]==0.22.1"

Upgrade an existing pipx installation with pipx upgrade fxcss.