pdm

pdm command [options] [args...]

pdm is a Python package manager following PEP standards. It manages dependencies, virtual environments, and builds using pyproject.toml.pdm init creates a new project with pyproject.toml. It detects or creates a Python interpreter and optionally initializes a virtual environment.Dependencies are declared in pyproject.toml and locked in pdm.lock. add modifies both; install reads the lock file. Dependency groups separate dev, test, and optional dependencies.PDM historically supported PEP 582 (_pypackages) as an alternative to virtual environments, but PEP 582 was rejected in 2023; modern PDM defaults to virtualenvs. Local-package mode can still be enabled with **pdm config python.usevenv false** for users who prefer it.pdm run executes commands with the project environment active. Scripts defined in pyproject.toml under [tool.pdm.scripts] provide shortcuts.Build and publish follow PEP 517/518. pdm build creates wheels and sdists; pdm publish uploads to PyPI.

-d, --dev

Development dependency.

Dependency group.

Custom lock file path.

Don't sync after adding.

Skip lock file update.

Exclude dev dependencies.

Project directory.

Increase verbosity.

Suppress output.

init

Create new project with pyproject.toml.

Add dependencies.

Remove dependencies.

Install dependencies from lock file.

Update dependencies.

Generate or update lock file.

Sync packages with lock file.

Run command in project environment.

List installed packages.

Build distribution packages.

Publish to PyPI.

Switch the project's Python interpreter.

Manage virtual environments for the project.

Show project, environment, and Python interpreter information.

Inspect or clear the package cache.

Get or set a PDM configuration option.

PEP 582 support varies by Python version and tools. Some older packages may not work with new standards. Lock file format is PDM-specific. Requires Python 3.8+.

PDM was created by Frost Ming and first released in 2019. It pioneered PEP 582 support and modern Python packaging standards. The project emphasizes standards compliance (PEP 517, 518, 621) over custom formats. PDM gained popularity as an alternative to pip, Poetry, and pipenv with its focus on PEP standards and performance.

pip(1), poetry(1), pipenv(1), uv(1)