Pipdeptree
A command line utility to display dependency tree of the installed Python packages
A command-line utility for displaying installed Python packages as a dependency tree. While `pip freeze` shows a flat list, `pipdeptree` reveals which packages are top-level and what they depend on, including conflicting or circular dependencies. The project is written primarily in Python, distributed under the MIT License license, first published in 2014. It has gained significant community traction with 3,002 stars and 162 forks on GitHub. Key topics include: dependency-graph, pip, python.
pipdeptree
A command-line utility for displaying installed Python packages as a dependency tree. While pip freeze shows a flat
list, pipdeptree reveals which packages are top-level and what they depend on, including conflicting or circular
dependencies.
Quick start
bashpip install pipdeptree pipdeptree
textFlask==0.10.1 - itsdangerous [required: >=0.21, installed: 0.24] - Jinja2 [required: >=2.4, installed: 2.11.2] - MarkupSafe [required: >=0.23, installed: 0.22] - Werkzeug [required: >=0.7, installed: 0.11.2]
Find out why a package is installed:
bashpipdeptree --reverse --packages markupsafe
Output as JSON, Mermaid, or Graphviz:
bashpipdeptree -o json pipdeptree -o mermaid pipdeptree -o graphviz-svg > deps.svg
Get a one-block environment health report (counts, depth, conflicts, cycles, licenses, size):
bashpipdeptree --summary # aligned text pipdeptree --summary -o rich # styled table pipdeptree --summary -o json # machine-readable
Inspect a tree without installing it. Resolve requirements against a package index (needs the index extra), or read an
already-resolved PEP 751 lock offline:
bashpip install pipdeptree[index] pipdeptree from-index "flask" # i is a shorthand alias pipdeptree from-index --requirements requirements.txt pipdeptree from-lock pylock.toml # l is a shorthand alias
Every render flag above, including --summary, works with both subcommands.
For the full documentation, visit pipdeptree.readthedocs.io.
Contributors
Showing top 12 contributors by commit count.
