# nbQA-dev/nbQA

Run ruff, isort, pyupgrade, mypy, pylint, flake8, and more on Jupyter Notebooks

Repository: https://github.com/nbQA-dev/nbQA
Canonical: https://ross.abutalabs.com/products/nbqa
Homepage: https://nbqa.readthedocs.io/en/latest/index.html
Language: Python
License: MIT
License Family: permissive
Topics: python, jupyter-notebook, pre-commit, codequality, lint, isort, black, flake8, doctest, pyupgrade, pylint, mypy, yapf, pre-commit-hook, ruff
Last push: 2026-08-24T18:31:20+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 2244, "days_push": 9, "days_rel": 661, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1204, forks 50 (observed 2026-08-28T04:03:59.061105+00:00)

## What it is
nbQA is a command-line tool that lets you run standard Python code quality tools like ruff, black, isort, mypy, pylint, flake8, and pyupgrade on Jupyter Notebooks. It handles IPython magics, respects existing config files, and integrates with pre-commit hooks.

## Use cases
- format jupyter notebooks with black
- lint notebook code cells with ruff or flake8
- sort imports in ipynb files with isort
- run mypy type checking on notebooks
- upgrade python syntax in notebooks with pyupgrade
- add notebook linting to pre-commit hooks
- format markdown cells in notebooks

## When to choose
- you want to apply standard Python linters and formatters to Jupyter notebooks without converting them
- you need notebook code quality checks in CI or pre-commit
- you want tools that respect your existing linting configuration files

## When to avoid
- you only work with plain Python scripts and never touch notebooks
- you need a notebook-specific linter with custom rules rather than a wrapper around existing tools

## Facets
- artifact type: cli-tool
- maturity: active
- function: linter, formatter, cli, developer-tools
- domain: developer-tools, testing
- platform: cli, python, cross-platform
- tags: jupyter-notebook, code-quality, pre-commit, black, ruff, isort, mypy, pylint, flake8, pyupgrade, command-line

## Member repositories
- nbQA-dev/nbQA (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:59.061105+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:19:40.279473+00:00, confidence not recorded.
  - readme: https://github.com/nbQA-dev/nbQA (fetched 2026-08-28T04:03:59.061105+00:00, sha bd035f112f16)
  - registry_pypi: https://pypi.org/pypi/nbqa/json (fetched 2026-08-29T12:27:56.483874+00:00, sha 1641e5edfd4e)
- Data as of 2026-08-30T08:39:29.467469+00:00.