Ruff

An extremely fast Python linter and code formatter, written in Rust.

Shows a bar chart with benchmark results.

Linting the CPython codebase from scratch.

⚡️ 10-100x faster than existing linters (like Flake8) and formatters (like Black)
🐍 Installable via pip
🛠️ pyproject.toml support
🤝 Python 3.14 compatibility
⚖️ Drop-in parity with Flake8, isort, and Black
📦 Built-in caching, to avoid re-analyzing unchanged files
🔧 Fix support, for automatic error correction (e.g., automatically remove unused imports)
📏 Over 900 built-in rules, with native re-implementations of popular Flake8 plugins, like flake8-bugbear
⌨️ First-party editor integrations for VS Code and more
🌎 Monorepo-friendly, with hierarchical and cascading configuration

Ruff aims to be orders of magnitude faster than alternative tools while integrating more functionality behind a single, common interface.

Ruff can be used to replace Flake8 (plus dozens of plugins), Black, isort, pydocstyle, pyupgrade, autoflake, and more, all while executing tens or hundreds of times faster than any individual tool.

Ruff is extremely actively developed and used in major open-source projects like:

...and many more.

Ruff is backed by Astral, the creators of uv and ty.

Read the launch post, or the original project announcement.

Testimonials

Sebastián Ramírez, creator of FastAPI:

Ruff is so fast that sometimes I add an intentional bug in the code just to confirm it's actually running and checking the code.

Nick Schrock, founder of Elementl, co-creator of GraphQL:

Why is Ruff a gamechanger? Primarily because it is nearly 1000x faster. Literally. Not a typo. On our largest module (dagster itself, 250k LOC) pylint takes about 2.5 minutes, parallelized across 4 cores on my M1. Running ruff against our entire codebase takes .4 seconds.

Bryan Van de Ven, co-creator of Bokeh, original author of Conda:

Ruff is ~150-200x faster than flake8 on my machine, scanning the whole repo takes ~0.2s instead of ~20s. This is an enormous quality of life improvement for local dev. It's fast enough that I added it as an actual commit hook, which is terrific.

Timothy Crosley, creator of isort:

Just switched my first project to Ruff. Only one downside so far: it's so fast I couldn't believe it was working till I intentionally introduced some errors.

Tim Abbott, lead developer of Zulip (also here):

This is just ridiculously fast... ruff is amazing.

For more, see the documentation.

Getting Started
Configuration
Rules
Contributing
Support
Acknowledgements
Who's Using Ruff?
License

Getting Started

For more, see the documentation.

Installation

Ruff is available as ruff on PyPI.

Invoke Ruff directly with uvx:

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

Or install Ruff with uv (recommended), pip, or pipx:

# With uv.
uv tool install ruff@latest  # Install Ruff globally.
uv add --dev ruff            # Or add Ruff to your project.

# With pip.
pip install ruff

# With pipx.
pipx install ruff

Starting with version 0.5.0, Ruff can 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.16.0/install.sh | sh
powershell -c "irm https://astral.sh/ruff/0.16.0/install.ps1 | iex"

You can also install Ruff via Homebrew, Conda, and with a variety of other package managers.

Usage

To run Ruff as a linter, try any of the following:

ruff check                          # Lint all files in the current directory (and any subdirectories).
ruff check path/to/code/            # Lint all files in `/path/to/code` (and any subdirectories).
ruff check path/to/code/*.py        # Lint all `.py` files in `/path/to/code`.
ruff check path/to/code/to/file.py  # Lint `file.py`.
ruff check @arguments.txt           # Lint using an input file, treating its contents as newline-delimited command-line arguments.

Or, to run Ruff as a formatter:

ruff format                          # Format all files in the current directory (and any subdirectories).
ruff format path/to/code/            # Format all files in `/path/to/code` (and any subdirectories).
ruff format path/to/code/*.py        # Format all `.py` files in `/path/to/code`.
ruff format path/to/code/to/file.py  # Format `file.py`.
ruff format @arguments.txt           # Format using an input file, treating its contents as newline-delimited command-line arguments.

Ruff can also be used as a pre-commit hook via ruff-pre-commit:

- repo: https://github.com/astral-sh/ruff-pre-commit
  # Ruff version.
  rev: v0.16.0
  hooks:
    # Run the linter.
    - id: ruff-check
      args: [ --fix ]
    # Run the formatter.
    - id: ruff-format

Ruff can also be used as a VS Code extension or with various other editors.

Ruff can also be used as a GitHub Action via ruff-action:

name: Ruff
on: [ push, pull_request ]
jobs:
  ruff:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: astral-sh/ruff-action@v3

Configuration

Ruff can be configured through a pyproject.toml, ruff.toml, or .ruff.toml file (see: Configuration, or Settings for a complete list of all configuration options).

For the complete list of enabled rules, see Default Rules.

If left unspecified, Ruff's default configuration is equivalent to the following ruff.toml file:

# Exclude a variety of commonly ignored directories.
exclude = [
    ".bzr",
    ".direnv",
    ".eggs",
    ".git",
    ".git-rewrite",
    ".hg",
    ".ipynb_checkpoints",
    ".mypy_cache",
    ".nox",
    ".pants.d",
    ".pyenv",
    ".pytest_cache",
    ".pytype",
    ".ruff_cache",
    ".svn",
    ".tox",
    ".venv",
    ".vscode",
    "__pypackages__",
    "_build",
    "buck-out",
    "build",
    "dist",
    "node_modules",
    "site-packages",
    "venv",
]

# Same as Black.
line-length = 88
indent-width = 4

# Assume Python 3.10
target-version = "py310"

[lint]
# select = [...]  # See the Default Rules page for the full listing.
ignore = []

# Allow fix for all enabled rules (when `--fix`) is provided.
fixable = ["ALL"]
unfixable = []

# Allow unused variables when underscore-prefixed.
dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"

[format]
# Like Black, use double quotes for strings.
quote-style = "double"

# Like Black, indent with spaces, rather than tabs.
indent-style = "space"

# Like Black, respect magic trailing commas.
skip-magic-trailing-comma = false

# Like Black, automatically detect the appropriate line ending.
line-ending = "auto"

Note that, in a pyproject.toml, each section header should be prefixed with tool.ruff. For example, [lint] should be replaced with [tool.ruff.lint].

Some configuration options can be provided via dedicated command-line arguments, such as those related to rule enablement and disablement, file discovery, and logging level:

ruff check --select F401 --select F403 --quiet

The remaining configuration options can be provided through a catch-all --config argument:

ruff check --config "lint.per-file-ignores = {'some_file.py' = ['F841']}"

To opt in to the latest lint rules, formatter style changes, interface updates, and more, enable preview mode by setting preview = true in your configuration file or passing --preview on the command line. Preview mode enables a collection of unstable features that may change prior to stabilization.

See ruff help for more on Ruff's top-level commands, or ruff help check and ruff help format for more on the linting and formatting commands, respectively.

Rules

Ruff supports over 900 lint rules, many of which are inspired by popular tools like Flake8, isort, pyupgrade, and others. Regardless of the rule's origin, Ruff re-implements every rule in Rust as a first-party feature.

By default, Ruff enables rules from the F, E, B, UP, and RUF categories, as well as many more, omitting any stylistic rules that overlap with the use of a formatter, like ruff format or Black.

If you're just getting started with Ruff, the default rule set is a great place to start: it catches a wide variety of common errors (like unused imports) with zero configuration. See Default Rules for the complete list.

Beyond the defaults, Ruff re-implements some of the most popular Flake8 plugins and related code quality tools, including:

For a complete enumeration of the supported rules, see Rules.

Contributing

Contributions are welcome and highly appreciated. To get started, check out the contributing guidelines.

You can also join us on Discord.

Support

Having trouble? Check out the existing issues on GitHub, or feel free to open a new one.

You can also ask for help on Discord.

Acknowledgements

Ruff's linter draws on both the APIs and implementation details of many other tools in the Python ecosystem, especially Flake8, Pyflakes, pycodestyle, pydocstyle, pyupgrade, and isort.

In some cases, Ruff includes a "direct" Rust port of the corresponding tool. We're grateful to the maintainers of these tools for their work, and for all the value they've provided to the Python community.

Ruff's formatter is built on a fork of Rome's rome_formatter, and again draws on both API and implementation details from Rome, Prettier, and Black.

Ruff's import resolver is based on the import resolution algorithm from Pyright.

Ruff is also influenced by a number of tools outside the Python ecosystem, like Clippy and ESLint.

Ruff is the beneficiary of a large number of contributors.

Ruff is released under the MIT license.

Who's Using Ruff?

Ruff is used by a number of major open-source projects and companies, including:

Albumentations
Amazon (AWS SAM)
Anki
Anthropic (Python SDK)
Apache Airflow
AstraZeneca (Magnus)
Babel
Benchling (Refac)
Bokeh
Capital One (datacompy)
CrowdCent (NumerBlox)
Cryptography (PyCA)
CERN (Indico)
DVC
Dagger
Dagster
Databricks (MLflow)
Dify
FastAPI
Godot
Gradio
Great Expectations
HTTPX
Hatch
Home Assistant
Hugging Face (Transformers, Datasets, Diffusers)
IBM (Qiskit)
ING Bank (popmon, probatus)
Ibis
ivy
JAX
Jupyter
Kraken Tech
LangChain
Litestar
LlamaIndex
Matrix (Synapse)
MegaLinter
Meltano (Meltano CLI, Singer SDK)
Microsoft (Semantic Kernel, ONNX Runtime, LightGBM)
Modern Treasury (Python SDK)
Mozilla (Firefox)
Mypy
Nautobot
Netflix (Dispatch)
Neon
Nokia
NoneBot
NumPyro
ONNX
OpenBB
Open Wine Components
PDM
PaddlePaddle
Pandas
Pillow
Poetry
Polars
PostHog
Prefect (Python SDK, Marvin)
PyInstaller
PyMC
PyMC-Marketing
pytest
PyTorch
Pydantic
Pylint
PyScripter
PyVista
Reflex
River
Rippling
Robyn
Saleor
Scale AI (Launch SDK)
SciPy
Snowflake (SnowCLI)
Sphinx
Stable Baselines3
Starlette
Streamlit
The Algorithms
Vega-Altair
Weblate
WordPress (Openverse)
ZenML
Zulip
build (PyPA)
cibuildwheel (PyPA)
delta-rs
featuretools
meson-python
nox
pip

Show Your Support

If you're using Ruff, consider adding the Ruff badge to your project's README.md:

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

...or README.rst:

.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
    :target: https://github.com/astral-sh/ruff
    :alt: Ruff

...or, as HTML:

<a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff" style="max-width:100%;"></a>

License

This repository is licensed under the MIT License

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ruff_md-0.16.0.tar.gz (4.8 MB view details)

Uploaded Jul 26, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ruff_md-0.16.0-py3-none-win_arm64.whl (11.3 MB view details)

Uploaded Jul 26, 2026 Python 3Windows ARM64

ruff_md-0.16.0-py3-none-win_amd64.whl (11.9 MB view details)

Uploaded Jul 26, 2026 Python 3Windows x86-64

ruff_md-0.16.0-py3-none-win32.whl (10.8 MB view details)

Uploaded Jul 26, 2026 Python 3Windows x86

ruff_md-0.16.0-py3-none-musllinux_1_2_x86_64.whl (11.5 MB view details)

Uploaded Jul 26, 2026 Python 3musllinux: musl 1.2+ x86-64

ruff_md-0.16.0-py3-none-musllinux_1_2_i686.whl (11.0 MB view details)

Uploaded Jul 26, 2026 Python 3musllinux: musl 1.2+ i686

ruff_md-0.16.0-py3-none-musllinux_1_2_armv7l.whl (10.6 MB view details)

Uploaded Jul 26, 2026 Python 3musllinux: musl 1.2+ ARMv7l

ruff_md-0.16.0-py3-none-musllinux_1_2_aarch64.whl (10.9 MB view details)

Uploaded Jul 26, 2026 Python 3musllinux: musl 1.2+ ARM64

ruff_md-0.16.0-py3-none-manylinux_2_31_riscv64.whl (11.4 MB view details)

Uploaded Jul 26, 2026 Python 3manylinux: glibc 2.31+ riscv64

ruff_md-0.16.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (11.4 MB view details)

Uploaded Jul 26, 2026 Python 3manylinux: glibc 2.17+ x86-64

ruff_md-0.16.0-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl (11.6 MB view details)

Uploaded Jul 26, 2026 Python 3manylinux: glibc 2.17+ s390x

ruff_md-0.16.0-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (12.2 MB view details)

Uploaded Jul 26, 2026 Python 3manylinux: glibc 2.17+ ppc64le

ruff_md-0.16.0-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl (11.3 MB view details)

Uploaded Jul 26, 2026 Python 3manylinux: glibc 2.17+ i686

ruff_md-0.16.0-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (10.6 MB view details)

Uploaded Jul 26, 2026 Python 3manylinux: glibc 2.17+ ARMv7l

ruff_md-0.16.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (10.9 MB view details)

Uploaded Jul 26, 2026 Python 3manylinux: glibc 2.17+ ARM64

ruff_md-0.16.0-py3-none-macosx_11_0_arm64.whl (10.5 MB view details)

Uploaded Jul 26, 2026 Python 3macOS 11.0+ ARM64

ruff_md-0.16.0-py3-none-macosx_10_12_x86_64.whl (11.0 MB view details)

Uploaded Jul 26, 2026 Python 3macOS 10.12+ x86-64

ruff_md-0.16.0-py3-none-linux_armv6l.whl (10.8 MB view details)

Uploaded Jul 26, 2026 Python 3

File details

Details for the file ruff_md-0.16.0.tar.gz.

File metadata

Download URL: ruff_md-0.16.0.tar.gz
Upload date: Jul 26, 2026
Size: 4.8 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.11.31 {"installer":{"name":"uv","version":"0.11.31","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ruff_md-0.16.0.tar.gz
Algorithm	Hash digest
SHA256	`039d8a92311788f97cc7a19c477209190c8ca845fd4864838735f32e86d8e901`
MD5	`228b5deb9eba6d9cd9f4840bf15a8dd0`
BLAKE2b-256	`cfee4bddf84c9e3594429e6fa6acb874fe3f6594f13e9f6e52bad725dff31338`

Algorithm	Hash digest
SHA256	`d5ebf56e833821c485fdd611b6a65e9eb9a55fb0a6ad5539dfd2db1cadb9803c`
MD5	`7b80757f679f3515adc01f00cfa3a6b2`
BLAKE2b-256	`44109ad95b45fd173c1e62b1868190cc3ad7fe7e64ff4257b70250ef3a4ee069`

Algorithm	Hash digest
SHA256	`9038caa5f2aba180731a44fda1283b63cc0590ed5bff79505dbfebcc3427570f`
MD5	`863599d6773e82df8c30c0a9fdcdd594`
BLAKE2b-256	`66b8df9eee991e109b46d8a0a346f95c20d760dff2bbe275e8ecc5f1f4f6cee4`

Algorithm	Hash digest
SHA256	`e10c558eebfd2299eca94b3597b9ae3b4e65d30db110f3e5f769bac9060ed9af`
MD5	`4ed6900253b940c6952f21f9aac8ac66`
BLAKE2b-256	`14a5c4bcc8d5d7f5e96ff9c5324ba6465ac70f0be03822d5f43958dd7969dc85`

Algorithm	Hash digest
SHA256	`ed1d2a2763a9896d6c9b256fff097362798092071b9c0fcfb640789b6aa292c8`
MD5	`b09b3f7340d2adb88164bb9a4709d612`
BLAKE2b-256	`d4f390bd3855ea5d4e9eedb3b0449550f6166c3b53e3db5d6f5819ab0f7934d6`

Algorithm	Hash digest
SHA256	`5f8a5facb56acfbe1300315c7f73b2a3494601e8bd0b0ab392fb607386f61755`
MD5	`a74cfd55af67d6ed71cbe67077f33600`
BLAKE2b-256	`51c8452613220f265772e6eb9617d547ca30960739893237359934094aef0b71`

Algorithm	Hash digest
SHA256	`2e177ac06151a70f445836a2f34fc0bccf37e576f815505933e302befb72b635`
MD5	`570b81dafae1957e0f9f9e6a2aa2ece2`
BLAKE2b-256	`3f6bf2332cb9ea5eb6c8d676d127e26eba15725e6f439ff35f8f331352ef6755`

Algorithm	Hash digest
SHA256	`334e374259f239131c1146877fcca712ff5fead3351d7eed405d573896c82d86`
MD5	`aabe9e2b1e3bfee5e5b18a866a0abf6f`
BLAKE2b-256	`7594ad3acc41d74d8463d5f9c2f6aeac5e068441a3256fdc8abe3586fe1e929a`

Algorithm	Hash digest
SHA256	`1d679fa6c1f592d7569bb4bd03dbfe541268c699b5801075a4b31dd12fa9bc62`
MD5	`53be8fe668cb7a1de039fb83cea9d433`
BLAKE2b-256	`203130b6b089f9e313c275917951d39b38b96bf05d86b6fc9e15e55a7c86d195`

Algorithm	Hash digest
SHA256	`7fe847f10639055844031a14525019a89d435b5d233aa004de1e1c6764e1e3c2`
MD5	`d7b4c21ee6c4889db76e60b2b6a04b2b`
BLAKE2b-256	`0f7c6b451c29bc05c04569aff2df83c5869c22e24e7eafac9e79af54f2c44270`

Algorithm	Hash digest
SHA256	`9d6a833952eacc3c8ee92afbeec88b4e4c4dad2cf3da2178f7b6c1d4dcf4a125`
MD5	`82b04b412e4947c05b69e22210ed2cf9`
BLAKE2b-256	`7ba7c3cbb5b85954830672f2770582e1959bbefcddf56aa3b908a66231b7c67b`

Algorithm	Hash digest
SHA256	`6c39b86808b7d750af6ec9419872bf8fa34bcf4ca194bdde6c4e70901655da64`
MD5	`9d8214f745cddb58e81f5f09394c49f5`
BLAKE2b-256	`adcc936449efdda38c2333394f5064f6479c27fc3ae1bd2b36d7b40075319e86`

Algorithm	Hash digest
SHA256	`c21c39efbaf6f341d6154afc77ce546fffaceba43763c81318cf37a847129fc7`
MD5	`7c2eae53399a7a7a19cc79a9a4b629db`
BLAKE2b-256	`4cb31cd341ea07c90842719a4ea34f98887372fa89c7ee71350ad2ecf505c35f`

Algorithm	Hash digest
SHA256	`330fb46cda8201de9ef91f3942eec896b9dc211eba9e68db74ff7c21e04ebfde`
MD5	`1a98eea478939e4eba0bd239a4b3e5e5`
BLAKE2b-256	`c2f4e2ebedffb51e7910e351d6f7574c1127013c743ce8081662777a00d4a5df`

Algorithm	Hash digest
SHA256	`fbbcd43367ccc49cef4fcbdf440344e30fdb5cea5419b0da4d7dc9532a86c32d`
MD5	`226691b207bbac7579dd740545e32e05`
BLAKE2b-256	`df3b9df18e41e08d24a3bb5b47d5a16a5123fee2b8b0d8bd7a254f3109b006b7`

Algorithm	Hash digest
SHA256	`6c77c0a2f934ee8afc539e5ca8d20c06ba9341a5016f2c4e77c2d48555fb49f7`
MD5	`4c1b0fc7c4ee5affaace95ef9fbd0bde`
BLAKE2b-256	`ab0699a528dc0fc05d89bd6e24af49bcac86cb7a7f8ffe278baffdbf47a172e9`

Algorithm	Hash digest
SHA256	`eaccc74e38da34eaea13ceab23f5a07c05107a4288557ae3c3cff4d380fb35de`
MD5	`6e4b62cf4d2836fc4d9aff6f103bf55a`
BLAKE2b-256	`505542cbe4777f1072e40440112e7b9e2d60f412479de4dcd87b76892d30b892`

Algorithm	Hash digest
SHA256	`920b770a5669f24a1689b60d49d7a1c410a1d7898f5a3d51e129b68e60592693`
MD5	`39d51c0d27e985dfae899d4bf7f7d3d6`
BLAKE2b-256	`d6c8d3921aba80888543977da37f21a9188a3782e85aef6f0cf2ee935d780896`

ruff-md 0.16.0

Ruff

Testimonials

Table of Contents

Getting Started

Installation

Usage

Configuration

Rules

Contributing

Support

Acknowledgements

Who's Using Ruff?

Show Your Support

License

Project links

Key dates

1 maintainer

Credits

License expression

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes