flake8-isort

What it is and what it does

flake8-isort is a flake8 plugin that delegates import checking to isort. Instead of flake8 checking imports with its own logic, it runs isort's rules and reports violations as flake8 errors (codes I001–I005). You configure behavior by adding an .isort.cfg file to your project, then run flake8 normally—the plugin automatically checks whether imports match expectations.

The package requires flake8 and isort as runtime dependencies and supports Python 3.10, 3.11, 3.12, 3.13 and PyPy3. It is designed for teams that already use isort and want linting enforcement of those same rules in CI/CD pipelines. The plugin reports five specific error codes covering wrong position, missing config, blank line issues, and unexpected imports.

Use it for:

• Enforce import rules in CI/CD pipelines by failing flake8 checks when imports don't match project configuration.
• Catch import violations during code review without manually running isort as a separate tool.
• Maintain consistent import style across a team by combining isort with flake8's linting workflow.
• Migrate existing projects by using flake8-isort to report violations before auto-sorting with isort itself.
• Integrate import checks into pre-commit hooks alongside other flake8 plugins for unified linting.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Integrates isort into flake8 linting, reporting import violations as flake8 errors with configurable rules via .isort.cfg.

Yes, if you already use isort and flake8 in your workflow. The plugin is low-friction to install, has no known vulnerabilities, and solves the specific problem of enforcing rules in linting. The aging maintenance status (last release 293 days ago) is a minor concern but not a blocker—the repository remains active. The GPLv2 copyleft license requires source disclosure if you distribute derivative works, which is typical for development tools.

Install

flake8-isort on PyPI

pip install flake8-isort

uv add flake8-isort

poetry add flake8-isort

Installing flake8-isort

Before you install

Low friction install with only flake8 and isort as runtime dependencies. Maintenance status is aging (last release 293 days ago), but the repository remains active and unarchived with recent commits.

License in practice

Licensed under GPLv2 (copyleft). If you distribute software using this package, you must make source code available under the same license terms.

Quickstart

pip install flake8-isort

# Create .isort.cfg in your project root:
# [settings]
# profile=black

# Run flake8 as usual:
flake8 your_module.py

Requires flake8 and isort to be installed; flake8-isort is a plugin that cannot function standalone.

Verify before relying

• Whether the package works correctly with the latest versions of flake8 and isort given the aging maintenance status.
• Performance impact when running flake8 on large codebases with many import statements.
• Compatibility with Python 3.14 listed in classifiers but not explicitly mentioned in requirements.

Package facts

Evidence: flake8_isort-7.0.0-py3-none-any.whl

Keywords: flake8, imports, isort, pep8, python

Tags

More Software Development packages