HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
astral-sh
ruff
Rust2022–2026
astral-sh / ruff

ruff

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

68Distinct people
79Mentions
2Explicit recommenders
51.2KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

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

GitHub

Where it is used

No documented product use was verified in the last source check.

What people are saying

I love Ruff and I'm glad that Charlie and the rest of the team are able to work on such tools full-time. I'm also happy to see that the author of Maturin (Rust+Python interop)…

akprasad used a recommendation phrase. 2 indexed comments match. This is a phrase match, not a verdict.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

Mentioned in the same Hacker News threads. That is not proof they are substitutes.

This week on Hacker News

Nov 9–Nov 16 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/16/2026, 4:59:52 AM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year79 dated mentions

Observed mentions: 2022-08-30 18:10:15 UTC to 2026-10-26 19:35:38 UTC.

01020302022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 6 mentions; 2 submissions, 4 comments20222023-01-01 00:00:00 UTC to 2024-01-01 00:00:00 UTC (exclusive): 31 mentions; 3 submissions, 28 comments2024-01-01 00:00:00 UTC to 2025-01-01 00:00:00 UTC (exclusive): 9 mentions; 1 submissions, 8 comments20242025-01-01 00:00:00 UTC to 2026-01-01 00:00:00 UTC (exclusive): 23 mentions; 2 submissions, 21 comments2026-01-01 00:00:00 UTC to 2027-01-01 00:00:00 UTC (exclusive): 10 mentions; 1 submissions, 9 comments. Incomplete calendar period.2026*

* An incomplete calendar period is marked with an outlined bar. Its count is not directly comparable with a full period.

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC624
20232023-01-01 00:00:00 UTC2024-01-01 00:00:00 UTC31328
20242024-01-01 00:00:00 UTC2025-01-01 00:00:00 UTC918
20252025-01-01 00:00:00 UTC2026-01-01 00:00:00 UTC23221
2026 (partial)2026-01-01 00:00:00 UTC2027-01-01 00:00:00 UTC1019

From the project README

An excerpt from the repository, fetched Nov 12, 2026.

Read the project’s introduction
Ruff Docs | Playground An extremely fast Python linter and code formatter, written in Rust. 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.15 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 actively developed and used in major open-source projects like: Apache Airflow Apache Superset FastAPI Hugging Face Pandas SciPy 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. Table of Contents For more, see the documentation. Getting Started Configuration Rules Contributing Support Acknowledgements Show Your Support License Getting Started For more, see the documentation. Installation Ruff is available as ruff on PyPI. Invoke Ruff directly with uvx: uvx ruff@0.17.3 check # Lint all files in the current directory. uvx ruff@0.17.3 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.17.3/install.sh | sh powershell -c "irm https://astral.sh/ruff/0.17.3/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.17.3 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",
Read the full README on GitHub

What Hacker News says

9 sources
I have no relation with the Astral team but have been an early and aggressive adopter of everything they've released and it's all been easy, fast, and ergonomic. Over the past eighteen months I've: 1. Replaced `flake8` with `ruff`; 2. Replaced `black` with `ruff`; 3. Replaced `pip` with `uv`; 4. Replaced `poetry` with `uv`. Their next project appears to be exactly what I _wish_ their next project to be — a replacement for pyright et al (https://github.com/astral-sh/ruff/discussions/10581). Type checking is my least favorite part of my Python toolchain at the moment; I can't wait to take it for a spin.
In Astral: Next-Gen Python Tooling
The survey didn’t explain what any of these are, so I didn’t want to make assumptions. Running the list through gpt-4o seems to have produced the correct annotations: - Phoenix (84% admire, 2% use) – Web development framework for Elixir. <https://www.phoenixframework.org/> - Ruff (84%, 3%) – Fast Python linter and code formatter. <https://github.com/charliermarsh/ruff> - Elixir (77%, 2%) – Functional, concurrent language for scalable applications. <https://elixir-lang.org/> - Bun (76%, 4%) – Fast JavaScript runtime and package manager. <https://bun.sh/> - Hetzner (75%, 5%) – German web hosting and cloud service provider. <https://www.hetzner.com/> - Roslyn (74%, 2%) – .NET compiler platform for code analysis. <https://github.com/dotnet/roslyn> - Tauri (74%, 2%) – Lightweight framework for building desktop apps with web techn
Read the rest
ologies. <https://tauri.app/> - Godot (74%, 4%) – Open-source game engine for 2D and 3D games. <https://godotengine.org/> - Zig (74%, 1%) – General-purpose programming language for better performance and safety. <https://ziglang.org/> - Signal (74%, 11%) – Secure messaging app with end-to-end encryption. <https://signal.org/> - Htmx (73%, 3%) – JavaScript library for dynamic HTML interactions. <https://htmx.org/> - Nix (73%, 3%) – Package manager for reproducible builds. <https://nixos.org/> - DataGrip (73%, 5%) – Database IDE by JetBrains for efficient SQL development. <https://www.jetbrains.com/datagrip/> - Hugging Face (73%, 5%) – AI community and platform for machine learning models. <https://huggingface.co/> - Pacman (73%, 5%) – Package manager for Arch Linux. <https://archlinux.org/pacman/> - Rider (73%, 6%) – Cross-platform .NET IDE by JetBrains. <https://www.jetbrains.com/rider/> - Svelte (73%, 7%) – JavaScript framework for building fast web applications. <https://svelte.dev/> - Astro (72%, 3%) – Modern static site builder for fast websites. <https://astro.build/> - Datomic (71%, 0.4%) – Distributed database designed for immutability. <https://www.datomic.com/> - ZMK (71%, 1%) – Open-source firmware for Bluetooth-enabled mechanical keyboards. <https://zmkfirmware.dev/> - Matrix (71%, 3%) – Open network for secure, decentralized communication. <https://matrix.org/> - DuckDB (70%, 1%) – Fast, in-process SQL OLAP database management system. <https://duckdb.org/> - Ktor (70%, 1%) – Framework for building asynchronous servers and clients in Kotlin. <https://ktor.io/> - Linear (70%, 3%) – Project management software for modern teams. <https://linear.app/>
In Dev tools that should be more popular according to the 2024 Developer Survey
A Python code abstract syntax tree (AST) parser and formatter in Go. Because the Python's "ast" modules is too slow, and lacks proper "format" feature (it has unparse but it removes comments, and forgets the current style completely). I use "ruff" a lot (https://github.com/astral-sh/ruff) which is in Rust. But I want to be able to implement fast custom linters in Go (linters that ruff / fixit lack, and Python linters lack or are too slow).
In Ask HN: What interesting project ideas you've got but have no time to work on?
I think it’s interesting that rye uses ruff (https://github.com/astral-sh/ruff) for linting and formatting. That’s the right call, and it’s also correct to bundle that in for an integrated dev experience. I had to guess, that’s the path that the Astral team would take as well - expand ruff’s capabilities so it can do everything a Python developer needs. So the vision that Armin is describing here might be achieved by ruff eventually. They’d have an advantage that they’re not a single person maintenance team, but the disadvantage of needing to show a return to their investors.
In Rye: A Vision Continued

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.