Skip to main content

A formatter for finding and removing unused import statements.

Project description


A formatter for finding and removing unused import statements.

Pycln Docs CI CD FUZZ Codacy Badge Codecov Maintainability

PYPI - Python Version PYPI - Pycln Version Total Downloads Downloads

Forks Stars Issues Pull Requests Contributors Last Commit License

Docstrings: reStructuredText Code style: black Code style: prettier

Read the documentation on Github pages!

Installation and usage


Pycln requires Python 3.7+ and can be easily installed using the most common Python packaging tools. We recommend installing the latest stable release from PyPI with pip:

$ pip install pycln


By default Pycln will remove any unused import statement, So the simplest usage is to specify the path only:

$ pycln [PATH]

Also, it's possible to run pycln as a package:

$ python3 -m pycln [PATH]

NOTE: you may need to use -a/--all option for more satisfying results. see -a/--all flag.

Further information can be found in our docs:


Pycln is able to read project-specific default values for its command line options from a configuration file like pyproject.toml or setup.cfg. This is especially useful for specifying custom CLI arguments/options like path/paths, --include, --exclude/--extend-exclude, or even --all.

You can find more details in our documentation:

And if you're looking for more general configuration documentation:

Used by

The following notable open-source projects trust and use Pycln:

The following organizations use Pycln:

Are we missing anyone? Let us know.




A big welcome for considering contributing to make the project better!

You can get started by reading this:

You can also dive directly into the technicalities:

Change log

The log has become rather long. It moved to its own file.



The author list is quite long nowadays, so it lives in its own file.


Code of Conduct

Everyone participating in the Pycln project, and in particular in the issue tracker, and pull requests is expected to treat other people with respect.

Give a ⭐️ if this project helped you!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pycln-2.4.0.tar.gz (35.5 kB view hashes)

Uploaded Source

Built Distribution

pycln-2.4.0-py3-none-any.whl (39.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page