Installing Ruff

Ruff is available as ruff on PyPI.

Ruff can be invoked directly with uvx:

uvx ruff check   # Lint all files in the current directory.
uvx ruff format  # Format all files in the current directory.

Or installed with uv (recommended), pip, or pipx:

$ # Install Ruff globally.
$ uv tool install ruff@latest

$ # Or add Ruff to your project.
$ uv add --dev ruff

$ # With pip.
$ pip install ruff

$ # With pipx.
$ pipx install ruff

Once installed, you can run Ruff from the command line:

$ ruff check   # Lint all files in the current directory.
$ ruff format  # Format all files in the current directory.

Starting with version 0.5.0, Ruff can also be installed with our standalone installers:

$ # On macOS and Linux.
$ curl -LsSf https://astral.sh/ruff/install.sh | sh

$ # On Windows.
$ powershell -c "irm https://astral.sh/ruff/install.ps1 | iex"

$ # For a specific version.
$ curl -LsSf https://astral.sh/ruff/0.5.0/install.sh | sh
$ powershell -c "irm https://astral.sh/ruff/0.5.0/install.ps1 | iex"

For macOS Homebrew and Linuxbrew users, Ruff is also available as ruff on Homebrew:

$ brew install ruff

For Conda users, Ruff is also available as ruff on conda-forge:

$ conda install -c conda-forge ruff

For pkgx users, Ruff is also available as ruff on the pkgx registry:

$ pkgx install ruff

For Arch Linux users, Ruff is also available as ruff on the official repositories:

$ pacman -S ruff

For Alpine users, Ruff is also available as ruff on the testing repositories:

$ apk add ruff

For openSUSE Tumbleweed users, Ruff is also available in the distribution repository:

$ sudo zypper install python3-ruff

On Docker, it is published as ghcr.io/astral-sh/ruff, tagged for each release and latest for the latest release.

$ docker run -v .:/io --rm ghcr.io/astral-sh/ruff check
$ docker run -v .:/io --rm ghcr.io/astral-sh/ruff:0.3.0 check

$ # Or, for Podman on SELinux.
$ docker run -v .:/io:Z --rm ghcr.io/astral-sh/ruff check