NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #1769 most downloaded on PyPI
Command line utility to show dependency tree of packages.
Latest stable
4.2.14
Last release 16 days ago
04 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
108 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
🐍 PyPI release 📜 Full Changelog
Fix graphviz CLI failing (#271) by @gaborbernat.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Drop 3.7 support (#263) by @gaborbernat.
<a name="release-2-10-0-added"></a>
<a name="release-2-10-0-changes"></a>
<a name="release-2-10-0-fixed"></a>
Drop 3.7 support ( PR #263 ) by @gaborbernat .
Split project to parts ( PR #261 ) by @gaborbernat .
Improve CLI ( PR #265 ) by @gaborbernat .
Fix entrypoints ( PR #264 ) by @gaborbernat .
Drop 3.7 support (263) by gaborbernat.
Split project to parts (261) by gaborbernat.
Improve CLI (265) by gaborbernat.
Fix entrypoints (264) by gaborbernat.
🐍 PyPI release 📜 Full Changelog
Add type information (#258) by @gaborbernat.
Allow to force encoding (#255) by @gaborbernat.
Retain casing of required package names (#248) by @kemzeb.
<a name="release-2-9-3-fixed"></a>
Retain casing of required package names ( PR #248 ) by @kemzeb .
Resolve relative interpreter paths before inspecting a virtual environment (#247) by @gaborbernat.
<a name="release-2-9-2-fixed"></a>
Resolve relative interpreter paths before inspecting a virtual environment (247) by gaborbernat.
🐍 PyPI release 📜 Full Changelog
Implement -d/--depth argument (#240) by @kemzeb.
<a name="release-2-9-0-added"></a>
Use unicode characters when rendering text (#239) by @kemzeb.
<a name="release-2-8-0-changes"></a>
Add 3.12 support (#228) by @gaborbernat.
<a name="release-2-7-1-added"></a>
Implement: Use fnmatch for include and exclude #213 (#215) by @jensens.
<a name="release-2-7-0-changes"></a>
Implement: Use fnmatch for include and exclude #213 (215) by jensens.
Handle mermaid output for a reversed tree by @ajkerrigan.
<a name="release-2-6-0-fixed"></a>
Fix Mermaid not working with reserved keyword package names by @kdeldycke.
<a name="release-2-5-2-fixed"></a>
Fix Mermaid not working with reserved keyword package names by @kdeldycke .
Fix Mermaid not working with reserved keyword package names by kdeldycke.
Fix Mermaid flag by @kdeldycke.
Implements Mermaid output (#195) by @kdeldycke.
Make the output of the dot format deterministic and stable (#189) by @kdeldycke.
<a name="release-2-4-0-fixed"></a>
Make the output of the dot format deterministic and stable (189) by kdeldycke.
Update README for tested Python versions (#178) by @tomkins.
<a name="release-2-3-3-documentation"></a>
Update README for tested Python versions (178) by tomkins.
Generalize license (#179) by @gaborbernat.
Use importlib.metadata to guess version of package before fallback to pkg.__version__ by @saaketp and @gaborbernat.
<a name="release-2-3-1-fixed"></a>
importlib.metadata to guess version of package before fallback to pkg.__version__ by @saaketp and @gaborbernat.Use importlib.metadata to guess version of package before fallback to pkg.__version__ by saaketp and gaborbernat.
Add support for invocation via -m by @gaborbernat.
<a name="release-2-3-0-added"></a>
-m by @gaborbernat.<a name="release-2-3-0-packaging"></a>
Add support for invocation via -m by gaborbernat.
Support Python 3.11 by dqkqd.
Now packaged via hatchling instead of setuptools by gaborbernat.
Fix --user-only and --freeze flags which were broken after the last release by @naiquevin.
<a name="release-2-2-1-fixed"></a>
--user-only and --freeze flags which were broken after the last release by @naiquevin.graphviz (>= 0.18.1) by @rodrigomologni and @naiquevin.Fix --user-only and --freeze flags which were broken after the last release by naiquevin.
Fix for compatibility with new version of graphviz (>= 0.18.1) by rodrigomologni and naiquevin.
Fix pipdeptree to work with pip version 21.3. The \_internal pip api that was being used earlier is now replaced with new functions (#154) by @stonebi
Fix pipdeptree to work with pip version 21.3. The _internal pip api that was being used earlier is now replaced with new functions (154) by stonebig.
Fix --freeze option due to breaking changes in pip's internal api in version > 21.1.1 by @naiquevin.
<a name="release-2-1-0-changes"></a>
<a name="release-2-1-0-fixed"></a>
<a name="release-2-1-0-packaging"></a>
JSON output is sorted alphabetically to make it deterministic by pjw91.
Fix --freeze option due to breaking changes in pip's internal api in version > 21.1.1 by naiquevin.
Include license file in dist package by milos-korenciak.
Support for running in the context of a virtualenv (without installing pipdeptree inside the virtualenv) by @gaborbernat.
<a name="release-2-0-0-added"></a>
<a name="release-2-0-0-fixed"></a>
Support for running in the context of a virtualenv (without installing pipdeptree inside the virtualenv) by gaborbernat.
Avoid crash when rendering cyclic dependencies by StephenWeber.
Fix graphviz (dot file) output by foreignmeloman.
Handle a (rare) case while guessing version of a package by naiquevin.
Support Python 3.7 and 3.8; drop Python 3.3 support by @naiquevin.
<a name="release-2-0-0b1-added"></a>
3.7 and 3.8; drop Python 3.3 support by @naiquevin.<a name="release-2-0-0b1-changes"></a>
2.0.0, the underlying code is heavily refactored to make different CLI options work well with each other. This was a serious limitation in older version <=1.0.0 which made it difficult to extend the tool. For more information about the plans for 2.0.0 release, please check docs/v2beta-opts.org file by @naiquevin.--reverse, --packages and --exclude flags now work with --json-tree and --graph-output by @naiquevin.Support Python 3.7 and 3.8; drop Python 3.3 support by naiquevin.
In this first beta release targeting 2.0.0, the underlying code is heavily refactored to make different CLI options work well with each other. This was a serious limitation in older version <=1.0.0 which made it difficult to extend the tool. For more information about the plans for 2.0.0 release, please check docs/v2beta-opts.org file by naiquevin.
The --reverse, --packages and --exclude flags now work with --json-tree and --graph-output by naiquevin.
Use pkg_resources vendored with pip by @sinoroc.
<a name="release-1-0-0-changes"></a>
pkg_resources vendored with pip by @sinoroc.Fixed call to FrozenRequirement.to_dist to handle changes to the internal api of pip version 19.0. The api change is because dependency links support
<a name="release-0-13-2-fixed"></a>
FrozenRequirement.to_dist to handle changes to the internal api of pip version 19.0. The api change is because dependency links support has been removed in pip 19.0 See more: https://github.com/pypa/pip/pull/6060 https://github.com/pypa/pip/pull/5881/commits/46ffb13f13f69c509fd253329da49889008f8e23 by @naiquevin.Fixed call to FrozenRequirement.to_dist to handle changes to the internal api of pip version 19.0. The api change is because dependency links support has been removed in pip 19.0 See more: https://github.com/pypa/pip/pull/6060 https://github.com/pypa/pip/pull/5881/commits/46ffb13f13f69c509fd253329da49889008f8e23 by naiquevin.
Fixed import after changes in pip.\_internal introduced in pip version 18.1 by @naiquevin.
<a name="release-0-13-1-fixed"></a>
Fixed import after changes in pip._internal introduced in pip version 18.1 by naiquevin.
Added --exclude option to exclude packages specified as CSV by @ciarancourtney.
<a name="release-0-13-0-added"></a>
--exclude option to exclude packages specified as CSV by @ciarancourtney.<a name="release-0-13-0-fixed"></a>
Added --exclude option to exclude packages specified as CSV by @ciarancourtney .
In case of multiple version specs eg. <x,>=y, fix the order to ensure consistent output. The sorting is naive - puts the ‘>’ prior to ‘<’, and ‘!’ by @pjw91 .
Added --exclude option to exclude packages specified as CSV by ciarancourtney.
In case of multiple version specs eg. <x,>=y, fix the order to ensure consistent output. The sorting is naive - puts the '>' prior to '<', and '!' by pjw91.
Fix import of 'FrozenRequirement' for pip 10.0.0 by @naiquevin.
<a name="release-0-12-1-fixed"></a>
Fix import of ‘FrozenRequirement’ for pip 10.0.0 by @naiquevin .
Support pip 10.0.0 without dropping older pip versions by @sourcenouveau.
<a name="release-0-12-0-fixed"></a>
Support pip 10.0.0 without dropping older pip versions by sourcenouveau.
Added support for nested json output (--json-tree flag). Behavior of --json stays the same by @haikoschol.
<a name="release-0-11-0-added"></a>
--json-tree flag). Behavior of --json stays the same by @haikoschol.Added support for nested json output (--json-tree flag). Behavior of --json stays the same by haikoschol.
Revert PR #65 to restore --json with --packages by @naiquevin.
<a name="release-0-10-1-fixed"></a>
--json with --packages by @naiquevin.Dropped support for Python 2.6 by @naiquevin.
<a name="release-0-10-0-added"></a>
--json and --packages options can now be used together by @kdeldycke.<a name="release-0-10-0-fixed"></a>
Dropped support for Python 2.6 by @naiquevin .
--json and --packages options can now be used together by @kdeldycke .
Fixed binary graphviz output on Python 3 by @jmbowman .
Dropped support for Python 2.6 by naiquevin.
--json and --packages options can now be used together by kdeldycke.
Fixed binary graphviz output on Python 3 by jmbowman.
Support for visualizing dependency tree of packages using Graphviz in various formats by @johnyf and @Dunedan.
<a name="release-0-9-0-added"></a>
<a name="release-0-9-0-fixed"></a>
Support for visualizing dependency tree of packages using Graphviz in various formats by johnyf and Dunedan.
Support to consider only packages installed in the user directory by naiquevin.
CLI option to print version by naiquevin.
Fix the output to use a better term, "Any" instead of "None" if a dependency doesn't need to be of a specific version by naiquevin.
Use pip's list of excluded default packages. This means that the pipdeptree package itself is no longer excluded and will appear in the output tree by
<a name="release-0-8-0-changes"></a>
pipdeptree package itself is no longer excluded and will appear in the output tree by @jimbocoder.<a name="release-0-8-0-fixed"></a>
Use pip's list of excluded default packages. This means that the pipdeptree package itself is no longer excluded and will appear in the output tree by jimbocoder.
Fix the bug that caused a package to appear in conflicting deps although it's installed version could be guessed by naiquevin.
Alphabetical sorting of packages in the output by @naiquevin.
<a name="release-0-7-0-changes"></a>
<a name="release-0-7-0-fixed"></a>
Alphabetical sorting of packages in the output by @naiquevin .
Fix for a bug in reverse mode by @naiquevin .
Fallback to guess installed version of packages “skipped” by pip by @naiquevin .
Alphabetical sorting of packages in the output by naiquevin.
Fix for a bug in reverse mode by naiquevin.
Fallback to guess installed version of packages "skipped" by pip by naiquevin.
Better checking for possibly "confusing" dependencies, hence the word "confusing" in the warning message is now replaced with "conflicting" (#37) by @
<a name="release-0-6-0-changes"></a>
--nowarn flag is now replaced with --warn with 'silence', 'suppress' and 'fail' as possible values, thus giving more control over what should happen when there are warnings. The default behavior (ie. when the flag is not specified) remains the same (#39) by @t0m.<a name="release-0-6-0-fixed"></a>
Better checking for possibly "confusing" dependencies, hence the word "confusing" in the warning message is now replaced with "conflicting" (37) by t0m.
The --nowarn flag is now replaced with --warn with 'silence', 'suppress' and 'fail' as possible values, thus giving more control over what should happen when there are warnings. The default behavior (ie. when the flag is not specified) remains the same (39) by t0m.
Fix a bug when rendering dependencies of packages (38) by chsava.
Fixes for Python 3.5 support (40) by adamchainz.
Add --reverse flag to show the dependency tree upside down by @naiquevin.
<a name="release-0-5-0-added"></a>
--reverse flag to show the dependency tree upside down by @naiquevin.--packages flag to show only select packages in output by @naiquevin.--json flag to output dependency tree as json that may be used by external tools by @naiquevin.Add --reverse flag to show the dependency tree upside down by @naiquevin .
Add --packages flag to show only select packages in output by @naiquevin .
Add --json flag to output dependency tree as json that may be used by external tools by @naiquevin .
On this page
Changelog
Unreleased (2026-11-14)
Packaging
4.2.14 (2026-11-04)
4.2.13 (2026-10-29)
Fixed
Security
4.2.12 (2026-10-29)
Fixed
Packaging
4.2.11 (2026-10-29)
Security
4.2.10 (2026-10-27)
Fixed
4.2.9 (2026-10-19)
Packaging
4.2.8 (2026-10-15)
Added
4.2.7 (2026-10-10)
Added
4.2.6 (2026-10-10)
Fixed
4.2.5 (2026-09-08)
Packaging
4.2.4 (2026-09-08)
Fixed
4.2.3 (2026-08-31)
Added
4.2.2 (2026-08-26)
Fixed
4.2.1 (2026-08-15)
Fixed
Documentation
4.2.0 (2026-07-31)
Added
Fixed
Packaging
4.1.0 (2026-07-21)
Added
Packaging
4.0.0 (2026-07-20)
Changes
Performance
Packaging
3.1.1 (2026-07-03)
Fixed
3.1.0 (2026-06-03)
Added
3.0.0 (2026-06-03)
Added
Changes
2.35.3 (2026-05-17)
Performance
2.35.2 (2026-05-01)
Fixed
2.35.1 (2026-04-10)
Fixed
2.35.0 (2026-04-10)
Added
Fixed
Documentation
2.34.0 (2026-03-23)
Documentation
2.33.0 (2026-03-21)
Fixed
Packaging
2.32.0 (2026-03-19)
Added
Fixed
Documentation
2.31.0 (2026-02-20)
Added
2.30.0 (2025-11-12)
Added
2.29.0 (2025-10-10)
Added
Changes
2.28.0 (2025-07-20)
Added
2.27.0 (2025-07-11)
Added
2.26.1 (2025-04-20)
Fixed
2.26.0 (2025-03-24)
Added
2.25.1 (2025-03-11)
Documentation
Packaging
2.25.0 (2025-01-26)
Added
2.24.0 (2024-11-26)
Added
2.23.4 (2024-09-17)
2.23.3 (2024-09-07)
2.23.2 (2024-09-07)
Added
2.23.1 (2024-07-12)
Changes
Fixed
2.23.0 (2024-06-17)
Changes
2.22.0 (2024-06-03)
Fixed
2.21.0 (2024-05-20)
Added
2.20.0 (2024-05-07)
Fixed
2.19.1 (2024-04-29)
Documentation
2.19.0 (2024-04-28)
Fixed
2.18.1 (2024-04-13)
2.18.0 (2024-04-10)
Fixed
2.17.0 (2024-04-04)
Changes
Fixed
2.16.2 (2024-03-25)
Packaging
2.16.1 (2024-03-04)
2.16.0 (2024-03-02)
Fixed
2.15.1 (2024-02-24)
Fixed
2.15.0 (2024-02-23)
Changes
2.14.0 (2024-02-15)
Added
2.13.2 (2024-01-10)
Fixed
2.13.1 (2023-11-09)
Documentation
2.13.0 (2023-08-14)
Added
Fixed
2.12.0 (2023-07-30)
Fixed
2.11.0 (2023-07-22)
Fixed
2.10.2 (2023-07-17)
2.10.1 (2023-07-17)
Fixed
2.10.0 (2023-07-15)
Added
Changes
Fixed
2.9.6 (2023-07-14)
2.9.5 (2023-07-11)
Packaging
2.9.4 (2023-07-07)
Added
2.9.3 (2023-06-16)
Fixed
2.9.2 (2023-06-15)
Fixed
2.9.1 (2023-06-14)
2.9.0 (2023-06-07)
Added
2.8.0 (2023-06-06)
Changes
2.7.1 (2023-05-11)
Added
2.7.0 (2023-03-25)
Changes
2.6.0 (2023-03-18)
Fixed
2.5.2 (2023-03-04)
Fixed
2.5.1 (2023-03-03)
Fixed
2.5.0 (2023-02-18)
Added
2.4.0 (2023-02-17)
Fixed
2.3.3 (2022-10-30)
Documentation
2.3.2 (2022-10-30)
Changes
2.3.1 (2022-09-08)
Fixed
2.3.0 (2022-09-06)
Added
Packaging
2.2.1 (2022-01-09)
Fixed
2.2.0 (2021-10-12)
Fixed
2.1.0 (2021-07-31)
Changes
Fixed
Packaging
2.0.0 (2020-12-25)
Added
Fixed
2.0.0b1 (2020-06-13)
Added
Changes
1.0.0 (2020-06-13)
Changes
0.13.2 (2019-01-23)
Fixed
0.13.1 (2018-10-08)
Fixed
0.13.0 (2018-07-01)
Added
Fixed
0.12.1 (2018-04-15)
Fixed
0.12.0 (2018-04-15)
Fixed
0.11.0 (2018-02-24)
Added
0.10.1 (2017-03-19)
Fixed
0.10.0 (2017-03-19)
Added
Fixed
0.9.0 (2017-01-07)
Added
Fixed
0.8.0 (2016-10-23)
Changes
Fixed
0.7.0 (2016-08-21)
Changes
Fixed
0.6.0 (2016-04-09)
Changes
Fixed
0.5.0 (2015-11-14)
Added
Add --reverse flag to show the dependency tree upside down by naiquevin.
Add --packages flag to show only select packages in output by naiquevin.
Add --json flag to output dependency tree as json that may be used by external tools by naiquevin.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.