RepoPilot

astral-sh/ruff

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

Healthy

Strong maintenance signals

MixedDependency

dependency CVE scan unavailable

HealthyFork & modify

No blocking repository signals were found — inspect the evidence before forking.

HealthyLearn from

Documented and popular — useful reference codebase to read through.

MixedDeploy as-is

Scorecard "Branch-Protection" is 0/10; dependency CVE scan unavailable

  • ⚠Scorecard: default branch unprotected (0/10)
  • ✓Last commit today
  • ✓22+ active contributors
  • ✓Distributed ownership (top contributor 26% of recent commits)
  • ✓MIT licensed
  • ✓CI configured
  • ✓Tests present

Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against OpenSSF Scorecard

Informational only. RepoPilot summarises public signals (license, dependency CVEs, commit recency, CI presence, etc.) at the time of analysis. Signals can be incomplete or stale. Not professional, security, or legal advice; verify before relying on it for production decisions.

Repository brief

Repo brief: astral-sh/ruff

Generated by RepoPilot · document generated 2026-09-17 · concise human review Evidence snapshot · analyzed 2026-09-17T03:49:36.051Z · commit e7adf82ff005

Verdict

Healthy — Strong maintenance signals

  • Last commit today
  • 22+ active contributors
  • Distributed ownership (top contributor 26% of recent commits)
  • MIT licensed
  • 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against OpenSSF Scorecard

What it is

Ruff is an extremely fast Python linter and code formatter written in Rust that achieves 10-100x performance gains over tools like Flake8 and Black. It consolidates the functionality of multiple tools (Flake8 + plugins, Black, isort, pydocstyle, pyupgrade) into a single binary with over 900 built-in rules and native re-implementations of popular linter plugins. It's installable via pip, supports pyproject.toml configuration, and includes built-in caching and automatic fix capabilities. Multi-crate Rust workspace in crates/: core crates/ruff contains the main CLI and commands (check, format, add_noqa, analyze_graph, check_stdin), with specialized sub-crates for linting (ruff_linter),…

Start here

Read these in order:

  • crates/ruff_benchmark/benches/ty_shared/mod.rs — Foundation: doesn't import anything internally and is imported by 2 other files. Read first to learn the vocabulary.
  • crates/ruff_benchmark/resources/tomllib/_types.py — Foundation: imported by 2, no internal dependencies of its own.
  • crates/ruff_linter/src/checkers/ast/analyze/mod.rs — Built on the foundation; imported by 1 downstream file.
  • crates/ruff_formatter/src/printer/mod.rs — Built on the foundation; imported by 1 downstream file.
  • crates/ruff_benchmark/resources/tomllib/_parser.py — Layer 2 — application-level code that wires the lower layers together.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/astral-sh/ruff.git
cd ruff
cargo build --release

Verify Cargo.toml and build.rs (in crates/ruff/) exist before running. The workspace resolver is set to "2" and edition is 2024, requiring Rust 1.96+.

Daily commands:

Inferred from structure: cargo build for development, cargo run -- check <file> to run the linter on a file. Exact commands should be verified in crates/ruff/README.md and build.rs. The main entry point is crates/ru…

…shortened for this brief.

Key cautions & unknowns

  • Scorecard: default branch unprotected (0/10)
  • Rust edition constraint: Project uses edition 2024 with minimum Rust 1.96 — older Rust toolchains will fail. Workspace resolver: Set to "2", which has specific dependency resolution behavior; don't manually…
  • Published-advisory coverage was unavailable for the captured dependencies.
  • Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

For the complete agent context, use the CLAUDE.md or Cursor rules export.

Save as

Full context for agent files, or a concise PDF for human review.

View complete agent reference

Open to load every section of the agent reference.

Want this for your own repo?

Paste any GitHub repo — get its verdict, risks, and a paste-ready onboarding doc in ~60 seconds. Free, no sign-up.

Embed the "Healthy" badge

Paste into your README — live-updates from the latest cached analysis.

Variant:
RepoPilot: Healthy
[![RepoPilot: Healthy](https://repopilot.app/api/badge/astral-sh/ruff)](https://repopilot.app/r/astral-sh/ruff)

Paste at the top of your README.md — renders inline like a shields.io badge.

▸Preview social card

This card auto-renders when someone shares https://repopilot.app/r/astral-sh/ruff on X, Slack, or LinkedIn.

Ask AI about astral-sh/ruff

Grounded in the actual source code. Pick a starter question or write your own.

What does this repo do, in one paragraph?How would I get started using it?What are the main alternatives?Show me the entry point.
Or write your own question

Similar Rust repos

Other healthy-signal Rust repos by stars.

More from astral-sh

See all

Recent Q&A

Public conversations other people have had about this repo.

Embed this chat in your README

Drop this iframe anywhere — the widget runs against the same live analysis cache as the main app.

<iframe
  src="https://repopilot.app/embed/astral-sh/ruff"
  width="100%" height="500"
  style="border:1px solid #d0d7de; border-radius:8px;"
  allow="microphone"
  loading="lazy"
></iframe>