pdm

Installation and Setup

Install it from PyPI:

• Windows
• Linux + macOS

(venv) PS> py -m pip install pdm

(venv) $ python -m pip install pdm

Initialize a project and create pyproject.toml:

$ pdm init

Key Features

• Centralizes project metadata and dependency declarations in pyproject.toml.
• Locks resolved versions in pdm.lock to support reproducible installs across machines and CI systems.
• Manages isolated project environments and supports PEP 582 (__pypackages__) as an alternative workflow.
• Organizes dependencies into groups like dev and exports pinned requirements when you need a requirements.txt file.
• Runs tools inside the project environment via pdm run and supports declarative scripts in [tool.pdm.scripts].
• Builds wheels and source distributions through a PEP 517–based build workflow with pdm build.

Usage

Create an environment and select a Python interpreter for the project:

$ pdm venv create -n py314

Add and remove dependencies:

$ pdm add "httpx>=0.25"
$ pdm remove httpx

Work with groups:

$ pdm add -G dev pytest

Lock the project:

$ pdm lock
$ pdm install # Sync env to the lockfile
$ pdm update  # Refresh locked versions

Define a scripts inside the environment:

[tool.pdm.scripts]
tests = "pytest -q"

Run the script:

$ pdm run tests

Export pinned requirements:

$ pdm export -o requirements.txt

Build distributable artifacts:

$ pdm build