nbQA
Run Python linters and formatters like ruff, black, and mypy directly on Jupyter Notebooks.
What is nbQA?
nbQA is a command-line utility that allows developers to run standard Python code quality and formatting tools on Jupyter Notebooks. It solves the problem of maintaining consistent code standards in notebook-driven projects by enabling tools like black, ruff, and mypy to process .ipynb files directly. This ensures notebooks meet the same style and quality benchmarks as regular Python scripts.
Python developers and data scientists who use Jupyter Notebooks for prototyping, analysis, or documentation and want to enforce code quality standards. Teams collaborating on notebook-based projects that require consistent linting and formatting across contributions.
Developers choose nbQA because it seamlessly integrates existing Python tooling into the notebook workflow without requiring manual conversion steps. Its unique selling point is robust handling of notebook-specific features like IPython magics while preserving the configuration and behavior of the underlying linters and formatters.
Overview
Run ruff, isort, pyupgrade, mypy, pylint, flake8, and more on Jupyter Notebooks
Use Cases
Best For
- Enforcing code style consistency across Jupyter Notebooks in a team repository
Related Projects
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
