Skip to main content

Dump the license list of packages installed with pip.

Project description

Build Status PyPI version GitHub Release Codecov BSD License Requirements Status

Dump the license list of packages installed with pip.


pip-licenses is a CLI tool for checking the software license of installed packages with pip.

Implemented with the idea inspired by composer licenses command in Composer (a.k.a PHP package management tool).


Install it via PyPI using pip command.

$ pip install pip-licenses


Execute the command with your venv (or virtualenv) environment.

# Install packages in your venv environment
(venv) $ pip install Django pip-licenses

# Check the licenses with your venv environment
(venv) $ pip-licenses
 Name    Version  License
 Django  2.0.2    BSD
 pytz    2017.3   MIT

Command-Line Options


By default, system packages such as pip and setuptools are ignored.

If you want to output all including system package, use the --with-system option.

(venv) $ pip-licenses --with-system
 Name          Version  License
 Django        2.0.2    BSD
 PTable        0.9.2    BSD (3 clause)
 pip           9.0.1    MIT
 pip-licenses  1.0.0    MIT License
 pytz          2017.3   MIT
 setuptools    38.5.0   UNKNOWN


When executed with the --with-authors option, output with the author of the package.

(venv) $ pip-licenses --with-authors
 Name    Version  License  Author
 Django  2.0.2    BSD      Django Software Foundation
 pytz    2017.3   MIT      Stuart Bishop


For packages without METADATA, the license is output as UNKNOWN. To get more package information, use the --with-urls option.

(venv) $ pip-licenses --with-urls
 Name    Version  License  URL
 Django  2.0.2    BSD
 pytz    2017.3   MIT


By default, it is ordered by package name.

If you give arguments to the --order option, you can output in other sorted order.

(venv) $ pip-licenses --order=license

More Information

Other, please make sure to execute the --help option.


MIT License



  • First stable release version


  • Implement new option --order
    • Default behavior is --order=name


  • First implementation version
    • Support options
      • --with-system
      • --with-authors
      • --with-urls

Project details

Download files

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

Files for pip-licenses, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size pip_licenses-1.0.0-py2.py3-none-any.whl (7.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size pip-licenses-1.0.0.tar.gz (5.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page