Skip to main content

A command line utility to check for unused, missing and transitive dependencies in a Python project.

Project description

deptry logo

Release Build status Supported Python versions codecov PyPI - Downloads License

deptry is a command line tool to check for issues with dependencies in a Python project, such as unused or missing dependencies. It supports the following types of projects:

  • Projects that use Poetry and a corresponding pyproject.toml file
  • Projects that use PDM and a corresponding pyproject.toml file
  • Projects that use any package manager that strictly follows PEP 621 dependency specification
  • Projects that use a requirements.txt file according to the pip standards

Dependency issues are detected by scanning for imported modules within all Python files in a directory and its subdirectories, and comparing those to the dependencies listed in the project's requirements.

Documentation - Contributing



To add deptry to your project, run one of the following commands:

# Install with poetry
poetry add --group dev deptry

# Install with pip
pip install deptry

Warning: When using pip to install deptry, make sure you install it within the virtual environment of your project. Installing deptry globally will not work, since it needs to have access to the metadata of the packages in the virtual environment.


deptry should be run within the root directory of the project to be scanned, and the project should be running in its own dedicated virtual environment.


To scan your project for dependency issues, run:

deptry .

Example output could look as follows:

Scanning 2 files...

foo/ DEP004 'numpy' imported but declared as a dev dependency
foo/ DEP001 'matplotlib' imported but missing from the dependency definitions
pyproject.toml: DEP002 'pandas' defined as a dependency but not used in the codebase
Found 3 dependency issues.


deptry can be configured by using additional command line arguments, or by adding a [tool.deptry] section in pyproject.toml. For more information, see the Usage and Configuration section of the documentation..

Repository initiated with fpgmaas/cookiecutter-poetry.

Project details

Release history Release notifications | RSS feed

Download files

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

Source Distribution

deptry-0.16.1.tar.gz (123.4 kB view hashes)

Uploaded Source

Built Distributions

deptry-0.16.1-pp310-pypy310_pp73-win_amd64.whl (1.6 MB view hashes)

Uploaded PyPy Windows x86-64

deptry-0.16.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.3 MB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ x86-64

deptry-0.16.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.3 MB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ARM64

deptry-0.16.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl (1.8 MB view hashes)

Uploaded PyPy macOS 10.12+ x86-64

deptry-0.16.1-cp38-abi3-win_amd64.whl (1.6 MB view hashes)

Uploaded CPython 3.8+ Windows x86-64

deptry-0.16.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.3 MB view hashes)

Uploaded CPython 3.8+ manylinux: glibc 2.17+ x86-64

deptry-0.16.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.3 MB view hashes)

Uploaded CPython 3.8+ manylinux: glibc 2.17+ ARM64

deptry-0.16.1-cp38-abi3-macosx_11_0_arm64.whl (1.7 MB view hashes)

Uploaded CPython 3.8+ macOS 11.0+ ARM64

deptry-0.16.1-cp38-abi3-macosx_10_12_x86_64.whl (1.8 MB view hashes)

Uploaded CPython 3.8+ macOS 10.12+ x86-64

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