pipdeptree
Command line utility to show dependency tree of packages.
Decision gist · record as of 2026-08-14
Yes. pipdeptree is actively maintained, has no known vulnerabilities, and solves a real problem that pip freeze does not address. The MIT license is permissive, and medium install friction is acceptable for a development tool. Install it if you regularly need to understand or troubleshoot Python dependency relationships.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; depends on nab-index and nab-python runtime dependencies.
- Medium install friction due to Rust-based compilation (classifiers include Programming Language :: Rust), though pre-built wheels are available for common platforms.
- Active maintenance with a release 14 days ago and 3019 repository stars.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution in both open-source and commercial contexts.
last release 2026-07-31 (14 days) · last repo commit 2026-08-14 · 3,019 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 8,843,679 downloads/mo, #1,589 on PyPI
Alternatives
Verify before relying
pip install pipdeptree
pipdeptree
# Show reverse dependencies for a package:
pipdeptree --reverse --packages markupsafe
# Output as JSON:
pipdeptree -o json- Whether nab-index and nab-python are pure-Python or compiled, and their availability on all target platforms.
- Performance characteristics when analyzing large dependency trees or complex resolution scenarios.
What it is and what it does
pipdeptree is a command-line tool that transforms pip's flat package list into a tree structure, exposing the parent-child dependency relationships that pip freeze hides. It detects and reports version conflicts (when a package requires a version different from what is installed) and dependency cycles, making it easier to understand and debug complex dependency graphs.
The tool works in two modes: inspecting the current environment's installed packages, or resolving dependencies offline from a lock file (PEP 751 format) or from a package index without installation. It supports multiple output formats—plain text with visual tree markers, JSON for programmatic consumption, and diagram formats like Mermaid and Graphviz for visualization. It can also generate summaries showing package counts, tree depth, conflicts, cycles, licenses, and sizes.
Use it for
- Debug version conflicts when a transitive dependency is installed at a version that doesn't satisfy a parent's requirement.
- Visualize the full dependency graph of a project before installing to understand what will be pulled in.
- Detect circular dependencies that might cause installation or runtime issues.
- Generate a dependency diagram in SVG or Mermaid format for documentation or architecture review.
- Audit installed packages to understand which top-level packages depend on a specific library.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
pipdeptree is actively maintained, has no known vulnerabilities, and solves a real problem that pip freeze does not address. The MIT license is permissive, and medium install friction is acceptable for a development tool. Install it if you regularly need to understand or troubleshoot Python dependency relationships.
Install
pipdeptree on PyPI
Before you install
Medium install friction due to Rust-based compilation (classifiers include Programming Language :: Rust), though pre-built wheels are available for common platforms. Active maintenance with a release 14 days ago and 3019 repository stars.
Requires Python 3.10 or later; depends on nab-index and nab-python runtime dependencies.
License in practice
MIT license permits unrestricted use, modification, and distribution in both open-source and commercial contexts.
Quickstart
pip install pipdeptree
pipdeptree
# Show reverse dependencies for a package:
pipdeptree --reverse --packages markupsafe
# Output as JSON:
pipdeptree -o jsonVerify before relying
- Whether nab-index and nab-python are pure-Python or compiled, and their availability on all target platforms.
- Performance characteristics when analyzing large dependency trees or complex resolution scenarios.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 2 packagesnab-indexnab-python |
| Maintenance | Actively maintained 14 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 8,843,679 / month, #1,589 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: DevelopersProgramming Language :: PythonProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.15Programming Language :: Rust |
Evidence: pipdeptree-4.2.0-cp310-abi3-macosx_10_15_x86_64.whl; pipdeptree-4.2.0-cp310-abi3-macosx_11_0_arm64.whl; pipdeptree-4.2.0-cp310-abi3-manylinux_2_28_aarch64.whl; pipdeptree-4.2.0-cp310-abi3-manylinux_2_28_x86_64.whl; pipdeptree-4.2.0-cp310-abi3-musllinux_1_2_aarch64.whl; pipdeptree-4.2.0-cp310-abi3-musllinux_1_2_x86_64.whl; pipdeptree-4.2.0-cp310-abi3-win_amd64.whl; pipdeptree-4.2.0-cp314-cp314t-macosx_10_15_x86_64.whl; pipdeptree-4.2.0-cp314-cp314t-macosx_11_0_arm64.whl; pipdeptree-4.2.0-cp314-cp314t-manylinux_2_28_aarch64.whl; pipdeptree-4.2.0-cp314-cp314t-manylinux_2_28_x86_64.whl; pipdeptree-4.2.0-cp314-cp314t-musllinux_1_2_aarch64.whl; pipdeptree-4.2.0-cp314-cp314t-musllinux_1_2_x86_64.whl; pipdeptree-4.2.0-cp314-cp314t-win_amd64.whl; pipdeptree-4.2.0-cp315-cp315t-macosx_10_15_x86_64.whl; pipdeptree-4.2.0-cp315-cp315t-macosx_11_0_arm64.whl; pipdeptree-4.2.0-cp315-cp315t-manylinux_2_28_aarch64.whl; pipdeptree-4.2.0-cp315-cp315t-manylinux_2_28_x86_64.whl; pipdeptree-4.2.0-cp315-cp315t-musllinux_1_2_aarch64.whl; pipdeptree-4.2.0-cp315-cp315t-musllinux_1_2_x86_64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “python dependency tree visualization”
- pipdeptreepipdeptree displays installed Python packages as a hierarchical…
- seedirGenerates ASCII tree diagrams of folder structures with customizable…
- bigtreeBigtree provides tree, binary tree, and directed acyclic graph (DAG)…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also pip-autoremove · pydeps · importlab · johnnydep · py-import-cycles · cyclic · bigtree · dependency-groups · poetry-plugin-export · pipreqs-fivetran