Ruff
Ruff is an extremely fast Python linter and formatter that consolidates Flake8, isort, Black, and dozens of other tools into a single binary. The handbook covers initial setup, recommended defaults, security rules, and the architecture that makes Ruff fast.
Get started with Ruff
Use Ruff in your workflow
More Ruff pages
Everything else tagged ruff, grouped by section. Pages featured above are not repeated here.
Tutorial
How To
- How to configure Cursor for Ruff
- How to configure Ruff for Django
- How to configure Ruff with Claude Code
- How to configure VS Code for a uv project
- How to Disable Ruff Rules for a Block of Code
- How to Disable the Ruff Formatter for a Block of Code
- How to install OpenAI's Astral plugins for Claude Code
- How to migrate from Black to Ruff formatter
- How to replace Black, isort, flake8, and pyupgrade with Ruff
Explanation
Reference
From the blog
Posts tagged ruff.
-
Astral Shuts Down pyx, Open-Sources the Part That Mattered
On Talk Python #552, Charlie Marsh says Astral is winding down the commercial pyx registry and open-sourcing its GPU index and prebuilt-wheel infrastructure with free artifacts.
-
Ruff Already Rewrites Your Python to Be More Idiomatic
Ruff's FURB rules catch non-idiomatic patterns and auto-fix them into cleaner Python. 36 rules, all with auto-fix, and most projects haven't enabled them.
-
How Astral Uses Its Own Tools
A teardown of the ruff, ty, and uv repositories shows how Astral wires its own toolchain into the projects that produce it.
-
OpenAI to Acquire Astral
OpenAI announced plans to acquire Astral, the company behind uv, Ruff, and ty, folding its team into the Codex coding agent.
-
Charlie Marsh on uv, Coding Agents, and the Changing Open Source Contract
Charlie Marsh discusses uv's adoption strategy, coding agents reshaping Astral's development, and open source when code is cheap.
-
uv format: Code Formatting Comes to uv (experimentally!)
uv 0.8.13 adds experimental uv format command that runs Ruff's formatter, similar to how cargo fmt wraps rustfmt.
-
How Python's RFC Process Paved the Way for uv, Ruff, and Ty
How PEP standards enabled Astral to build ruff, uv, and ty that work seamlessly within the Python ecosystem without being part of core.
-
The Python Tooling Revolution
Lewis Gaul examines how Astral's ruff and uv are transforming Python development workflows with speed and intelligent design.
-
Simple, Modern Python
Joshua Levy's simple-modern-uv Copier template combines uv, ruff, mypy, and pytest for new Python projects.
-
Effective Python Developer Tooling in December 2024
An opinionated guide to Python developer tooling covering uv, ruff, pytest, mypy, and principles for productive Python development.