pycodestyle
pycodestyle is a free Python checker that evaluates selected conventions from PEP 8.
What pycodestyle is
pycodestyle is a free Python checker that evaluates selected conventions from PEP 8. It runs on Linux, macOS, and Windows, and its parseable output can direct an editor to an error location. The command line can show source and PEP 8 guidance, count errors, and format reports as default, pylint, or custom output. Configuration is available at user and project levels, including setup.cfg and tox.ini. Its plugin architecture allows additional checks, while Flake8 is described as a wrapper around pycodestyle and similar tools with plugin support. The project describes the package as a single Python file using only the standard library and includes a comprehensive test suite. Installation, upgrades, and removal are documented through pip. pycodestyle does not enforce every PEP 8 rule; naming conventions, docstrings, and automatic fixing are outside its scope. The listed plan is free, MIT licensed, and requires Python >=3.10.
Good
- Runs on Linux, macOS, and Windows
- Parseable output supports editor navigation
- Configurable at user and project levels
- Plugin architecture adds checks
- Free MIT-licensed package
Watch out
- Does not enforce every PEP 8 rule
- No automatic fixing
- Naming and docstring checks are out of scope
- Requires Python >=3.10
Who it suits
pycodestyle suits Python developers who want configurable PEP 8 checks in editors or CI. Users needing naming, docstring, or automatic fixes need other tools or plugins.
Verdict
pycodestyle provides lightweight, configurable style checking with editor-friendly reports and plugin support. Its limited rule coverage means it should be paired with other tools when broader conventions or autofixing are needed.
Plans and prices
From pycodestyle's own pricing page, checked 9 Oct 2026.
| Plan | Price | What it gives you |
|---|---|---|
| pycodestyle | Free | MIT licensed Python package · requires Python >=3.10 |
The facts
Each one read from pycodestyle's own pages, with the date it was checked.
What it does
- Compatibility
- PyPI classifies the package as OS independent and lists CPython and PyPy implementations.checked 9 Oct 2026
- Configuration
- Users can configure pycodestyle at user and project levels, including through setup.cfg or tox.ini.checked 9 Oct 2026
- Editor output
- Its parseable output lets users jump to an error location in an editor.checked 9 Oct 2026
- Installation
- The documentation gives pip install, upgrade, and uninstall commands for pycodestyle.checked 9 Oct 2026
- Integration
- Flake8 is described as a wrapper around pycodestyle and similar tools that supports plugins.checked 9 Oct 2026
- Lightweight
- The project says it is a single Python file that requires only the standard library.checked 9 Oct 2026
- Limitations
- The checker does not enforce every PEP 8 rule and does not aim to be exhaustive.checked 9 Oct 2026
- Out of scope
- Naming conventions, docstring conventions, and automatic fixing are outside the library’s scope; the documentation points to plugins or related tools for these needs.checked 9 Oct 2026
- Plugins
- Its plugin architecture makes it easy to add new checks.checked 9 Oct 2026
- Purpose
- pycodestyle checks Python code against some of the style conventions in PEP 8.checked 9 Oct 2026
- Reporting
- The CLI can show source and PEP 8 guidance, count errors, and format output as default, pylint, or custom.checked 9 Oct 2026
- Security and trust
- PyPI lists the 2.15.0 source distribution and wheel as not uploaded using Trusted Publishing.checked 9 Oct 2026
- Test suite
- The project says it comes with a comprehensive test suite.checked 9 Oct 2026
Alternatives to pycodestyle
- 1

Cppcheck
Free planOpen sourceLinuxmacOSSelf-hostedWindows7.4Free plan - 2
JSHint
Free planOpen sourceWebAPIExtensionLinux7.4Free plan - 3
Flake8
Free planOpen sourceAPILinuxmacOSSelf-hosted7.3Free plan - 4
PMD
Free planLinuxmacOSSelf-hostedWindows6.8Free plan - 5

Ruff
Free planWebLinuxmacOSSelf-hosted6.6Free plan - 6
SwiftLint
Free planLinuxmacOSWindows6.6Free plan
