# pdm > A modern Python package and dependency manager supporting the latest PEP standards - **URL**: https://www.freshcrate.ai/projects/pdm - **Author**: pypi - **Category**: Frameworks - **Latest version**: `2.27.0` (2026-05-21) - **License**: Unknown - **Source**: https://github.com/pdm-project/pdm - **Homepage**: https://pypi.org/project/pdm/ - **Language**: Python - **GitHub**: 8,556 stars, 470 forks - **Registry**: pypi (`pdm`) - **Tags**: `dependency`, `packaging`, `pypi`, `workflow` ## Description
# PDM A modern Python package and dependency manager supporting the latest PEP standards. [中文版本说明](README_zh.md) ![PDM logo](https://raw.githubusercontent.com/pdm-project/pdm/main/docs/assets/logo_big.png) [![Docs](https://img.shields.io/badge/Docs-zensical-blue?style=for-the-badge)](https://pdm-project.org) [![Twitter Follow](https://img.shields.io/twitter/follow/pdm_project?label=get%20updates&logo=twitter&style=for-the-badge)](https://twitter.com/pdm_project) [![Discord](https://img.shields.io/discord/824472774965329931?label=discord&logo=discord&style=for-the-badge)](https://discord.gg/Phn8smztpv) ![Github Actions](https://github.com/pdm-project/pdm/workflows/Tests/badge.svg) [![PyPI](https://img.shields.io/pypi/v/pdm?logo=python&logoColor=%23cccccc)](https://pypi.org/project/pdm) [![codecov](https://codecov.io/gh/pdm-project/pdm/branch/main/graph/badge.svg?token=erZTquL5n0)](https://codecov.io/gh/pdm-project/pdm) [![Packaging status](https://repology.org/badge/tiny-repos/pdm.svg)](https://repology.org/project/pdm/versions) [![Downloads](https://pepy.tech/badge/pdm/week)](https://pepy.tech/project/pdm) [![pdm-managed](https://img.shields.io/endpoint?url=https%3A%2F%2Fcdn.jsdelivr.net%2Fgh%2Fpdm-project%2F.github%2Fbadge.json)](https://pdm-project.org) trackgit-views [![asciicast](https://asciinema.org/a/jnifN30pjfXbO9We2KqOdXEhB.svg)](https://asciinema.org/a/jnifN30pjfXbO9We2KqOdXEhB)
## What is PDM? PDM is meant to be a next generation Python package management tool. It was originally built for personal use. If you feel you are going well with `Pipenv` or `Poetry` and don't want to introduce another package manager, just stick to it. But if you are missing something that is not present in those tools, you can probably find some goodness in `pdm`. ## Highlights of features - Simple and fast dependency resolver, mainly for large binary distributions. - A [PEP 517] build backend. - [PEP 621] project metadata. - Flexible and powerful plug-in system. - Versatile user scripts. - Install Pythons using [astral-sh's python-build-standalone](https://github.com/astral-sh/python-build-standalone). - Opt-in centralized installation cache like [pnpm](https://pnpm.io/motivation#saving-disk-space-and-boosting-installation-speed). [pep 517]: https://www.python.org/dev/peps/pep-0517 [pep 621]: https://www.python.org/dev/peps/pep-0621 [pnpm]: https://pnpm.io/motivation#saving-disk-space-and-boosting-installation-speed ## Comparisons to other alternatives ### [Pipenv](https://pipenv.pypa.io) Pipenv is a dependency manager that combines `pip` and `venv`, as the name implies. It can install packages from a non-standard `Pipfile.lock` or `Pipfile`. However, Pipenv does not handle any packages related to packaging your code, so it’s useful only for developing non-installable applications (Django sites, for example). If you’re a library developer, you need `setuptools` anyway. ### [Poetry](https://python-poetry.org) Poetry manages environments and dependencies in a similar way to Pipenv, but it can also build .whl files with your code, and it can upload wheels and source distributions to PyPI. It has a pretty user interface and users can customize it via a plugin. Poetry uses the `pyproject.toml` standard. ### [Hatch](https://hatch.pypa.io) Hatch can also manage environments, allowing multiple environments per project. By default it has a central location for all environments but it can be configured to put a project's environment(s) in the project root directory. It can manage packages but without lockfile support. It can also be used to package a project (with PEP 621 compliant pyproject.toml files) and upload it to PyPI. ### This project PDM can manage virtual environments (venvs) in both project and centralized locations, similar to Pipenv. It reads project metadata from a standardized `pyproject.toml` file and supports lockfiles. Users can add additional functionality through plugins, which can be shared by uploading them as distributions. Unlike Poetry and Hatch, PDM is not limited to a specific build backend; users have the freedom to choose any build backend they prefer. ## Installation Packaging status PDM requires python version 3.9 or higher. Alternatively, you can download the standalone binary file from the [release assets](https://github.com/pdm-project/pdm/releases). ### Install Binary via Script (recommended) Install the standalone binary directly with the installer scripts: **For Linux/Mac** ```bash curl -sSL https://pdm-project.org/install.sh | bash ``` **For Windows** ```powershell powershell -ExecutionPolicy ByPass -c "irm https://pdm-project.org/install.ps1 | ## Recent releases | Version | Date | Urgency | Changes | | --- | --- | --- | --- | | `2.27.0` | 2026-05-21 | High | ### Breaking Changes - Update the minimum required Python version to 3.10. ([#3787](https://github.com/pdm-project/pdm/issues/3787)) ### Features & Improvements - Respect existing values of `pyproject.toml` when running `pdm init` or `pdm new`. ([#3786](https://github.com/pdm-project/pdm/issues/3786)) - Move project plugin installations from `.pdm-plugins` under the project root to an isolated cache directory, and add a fixer to migrate existing plugin directories. ([#3790](https://github.co | | `2.26.9` | 2026-05-10 | High | ### Features & Improvements - Support `exclude-newer` in `pyproject.toml` in the `[tool.pdm.resolution]` table ([#3776](https://github.com/pdm-project/pdm/issues/3776)) ### Bug Fixes - Preserve pylock package markers when refreshing lockfile hashes. ([#3773](https://github.com/pdm-project/pdm/issues/3773)) ## What's Changed * Remove dead code by @duriantaco in https://github.com/pdm-project/pdm/pull/3774 * [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci[bot] in https://gith | | `2.26.8` | 2026-04-21 | Low | Imported from PyPI (2.26.8) | | `2.26.7` | 2026-03-24 | Medium | ### Features & Improvements - Speed up dependency resolution when there are complex conflicts. ([#3751](https://github.com/pdm-project/pdm/issues/3751)) ### Documentation - Switch to Zensical as docs generator. ([#3752](https://github.com/pdm-project/pdm/issues/3752)) ### Miscellany - Add comprehensive tests for completion, show, search, and info commands to improve test coverage ([#3541](https://github.com/pdm-project/pdm/issues/3541)) | | `2.26.6` | 2026-01-22 | Low | ### Bug Fixes - Support `packaging==26.0` changes for version comparison ([#3729](https://github.com/pdm-project/pdm/issues/3729)) | | `2.26.5` | 2026-01-21 | Low | ### Bug Fixes - Respect the project path when using cookiecutter template in `pdm init` command. ([#3721](https://github.com/pdm-project/pdm/issues/3721)) - Fix a bug that `resolution.excludes` is not applied when evaluating candidates from the lock file. ([#3726](https://github.com/pdm-project/pdm/issues/3726)) ### Documentation - Remove chatbot from the docs page footer. ([#3722](https://github.com/pdm-project/pdm/issues/3722)) - Generate llms.txt for docs powered by `mkdocs-llmstxt`. ([#3 | | `2.26.4` | 2026-01-09 | Low | ### Bug Fixes - Make sure cursor closing for fixing PyPy different gc mode also add PyPy in CI. ([#3708](https://github.com/pdm-project/pdm/issues/3708)) - Fix a bug that old HTTP cache directories cause PDM to crash when trying to clear them. ([#3715](https://github.com/pdm-project/pdm/issues/3715)) | | `2.26.3` | 2025-12-24 | Low | ### Features & Improvements - Port to `hishel` 1.0.0. ([#3700](https://github.com/pdm-project/pdm/issues/3700)) ### Bug Fixes - Update `.gitignore` file in the default template. ([#3686](https://github.com/pdm-project/pdm/issues/3686)) - Correct the sysconfig variables for Python standalone build installations. ([#3693](https://github.com/pdm-project/pdm/issues/3693)) - Ignore `packages.vcs.requested-revision` if it's None when formatting pylock.toml. ([#3694](https://github.com/pdm-project/ | | `2.26.2` | 2025-11-24 | Low | ### Features & Improvements - Only parse TOML document with `tomlkit` when writing is required. ([#3672](https://github.com/pdm-project/pdm/issues/3672)) - Add SHA256 checksums for binary releases during the release workflow and create an installer script that downloads binaries from GitHub releases with automatic platform detection and checksum verification. ([#3679](https://github.com/pdm-project/pdm/issues/3679)) ### Bug Fixes - Fix test_use_python_write_file_multiple_versions to match PD | | `2.26.1` | 2025-10-29 | Low | ### Bug Fixes - Substitute missing env vars with empty string in `expand_env_vars`. ([#3653](https://github.com/pdm-project/pdm/issues/3653)) - Constrained hishel to be less than 1.0.0 due to its refactor ([#3657](https://github.com/pdm-project/pdm/issues/3657)) | ## Citation - HTML: https://www.freshcrate.ai/projects/pdm - Markdown: https://www.freshcrate.ai/projects/pdm.md - Dependencies JSON: https://www.freshcrate.ai/api/projects/pdm/deps _Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._