NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #3550 most downloaded on PyPI
A modern Python package and dependency manager supporting the latest PEP standards
Latest stable
2.29.7
Last release 16 days ago
06 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
9 versions withdrawn
withdrawn after publishing
7 years old
259 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Upgrade hishel to support version 2 or greater.
Fix the uv mode failing when pyproject.toml or uv.lock cannot be renamed, as happens when they are bind mounts in a container, by falling back to rest
pyproject.toml or uv.lock cannot be renamed, as happens when they are bind mounts in a container, by falling back to restoring their content in place. (#3292)use_uv works with credentials that contain characters like #, / or %. (#3974)python_version marker that compares against a three-part version, such as python_version >= "3.8.1". (#3978)pyproject.toml or setup.cfg when a later setup.cfg or setup.py sets none, instead of resetting it to 0.0.0 while parsing project files. (#3983)pdm config to set an explicitly provided empty string value instead of treating it as a read operation. (#3984)pdm python install installs an interpreter, instead of leaving it in the temporary directory. (#3988)repr() when converting them to environment markers, so they stay valid under stricter marker string parsing. (#3993)pypa/gh-action-pypi-publish to attach PEP 740 provenance attestations on PyPI. (#3979)Your coding agent can read these notes before it upgrades. Set up the MCP server →
Preserve archive subdirectories when writing or exporting pylock.toml.
pdm show from the Homepage Project-URL, and stop pdm show failing on a Project-URL that contains a comma. (#3968)pdm venv activate prints for PowerShell, so Invoke-Expression (pdm venv activate) works when the path contains spaces or apostrophes. (#3970)shell script, and the {args} placeholder in it, for cmd.exe instead of with POSIX single quotes. (#3971)pylock.toml. (#3972)pdm list from the Homepage Project-URL when Home-page is missing or unknown. (#3973)Allow specifying lock.format in pyproject.toml via the [tool.pdm.lock] table.
lock.format in pyproject.toml via the [tool.pdm.lock] table. (#3958)RequirementError. (#3937)Pipfile version without an operator, such as requests = "2.31.0", as an exact == pin when importing, like pipenv does, instead of failing with an invalid specifier error. (#3939)src/ layout or an annotated __version__. (#3942)certifi>=2026.10.19, which removes the emSign ECC Root CA - G3 root whose eMudhra intermediates had their private keys compromised. (#3944)pdm outdated no longer lists a package whose installed version is newer than the latest one found on the index, such as an installed pre-release or local build. (#3945)pdm lock --check reporting an outdated lockfile when a group is declared in both [dependency-groups] and [tool.pdm.dev-dependencies]. (#3947)License-Expression (PEP 639) in pdm show and pdm list --fields licenses. (#3948)pdm lock from excluding packages from a lock target when another target shares its OS and architecture, e.g. manylinux and musllinux. (#3950)python_version marker compares against a wildcard version such as python_version == "3.*". (#3951)License-Expression and License-File with the upload in pdm publish, so PyPI shows the license of PEP 639 packages. (#3952)unearth to >=0.19 and migrate the HTTP client from httpx to httpx2. pdm.models.session.PDMPyPIClient and the transports in pdm.pytest are now built on httpx2, so plugins interacting with them should import httpx2 instead of httpx. (#3962)Add the --venv option to pdm outdated , like the other commands that read the installed packages.
--venv option to pdm outdated, like the other commands that read the installed packages. (#3904)--system-site-packages. (#3895)pdm import of Poetry projects dropping optional dependencies whose extras entry is spelled differently, and importing optional dependencies with multiple constraints as required ones. (#3899)pdm export when the same package is also locked with extras under a narrower marker, so it is no longer missing from requirements.txt on the other platforms. (#3900)python_version <= "X.Y" markers excluding the patch releases of X.Y, so pdm install skipped such dependencies. (#3902)env or env_file, leaking into the tasks that run after it. (#3903)keywords and obsolete dev-requires into valid PEP 621 fields when importing a flit project. (#3907)[docs], as dependency groups instead of dropping them. (#3909)[tool.pdm.dev-dependencies] on pdm import, so the written [dependency-groups] table stays valid per PEP 735. (#3910)develop = true as an editable requirement when importing dependency groups. (#3913)pdm import of the project's own Poetry pyproject.toml writing each dependency group to both [tool.pdm.dev-dependencies] and [dependency-groups]. (#3915)file URL, such as {file = "https://..."}, as URL requirements instead of dropping the URL. (#3918)exclude-newer timestamp without a UTC offset as UTC, so pdm lock no longer fails with a TypeError comparing naive and aware datetimes. (#3922)dev = [] from an empty [dev-packages] table, when importing from another format. (#3925)., _ and - when pdm init derives the project name from the directory, so a folder like __demo__ no longer produces the invalid name _demo_. (#3927)pdm init now writes project.license as a license expression string instead of a {text = ...} table, and no longer rewrites an existing {file = ...} table or license expression into a value the build backend rejects. (#3929)pdm run ignored. (#3931)>=1.0 <2.0 like the comma-separated form instead of aborting the import. (#3934)path entries in a Pipfile against the directory of the Pipfile when importing, instead of the current working directory. (#3935)Fix writing lock files specified as bare relative filenames with pdm lock --lockfile .
pdm lock --lockfile. (#3891)Explain missing lockfile groups and provide group-selection recovery guidance when installing, syncing, or updating groups.
exclude-newer resolution limits. (#3809)v prefix when converting Poetry version constraints. (#3860)[ or ] can find its own virtualenv. (#3869)pyproject.toml and lockfiles atomically to prevent interrupted writes from truncating them. (#3870)ValueError. (#3874)pyproject.toml or the lockfile. (#3878)- when parsing requirements files. (#3885)Export editable local dependencies with relative paths in requirements files.
pdm run with --env, --env-file and --working-dir options to set or override the corresponding script options dynamically. (#3829)pdm lock --platform ... --append no longer adds entries that get installed on the other targets. (#3261)include entries restricted to the sdist format when importing, writing them to tool.pdm.build.source-includes instead of dropping them. (#3854)--no-verify-ssl on pdm publish, which was misspelled as --no-very-ssl. The old spelling keeps working as an alias. (#3857)~1.2 becomes <1.3 rather than <2.0, and ~1 no longer produces an invalid ~=1 specifier that aborts the import. (#3858)v prefix when converting Poetry version constraints. (#3860)Name <email> pattern. (#3861)requires-python when a Pipfile [requires] table has no python version, instead of writing >=None. (#3862)pylock.toml, producing a single-use lock file that contains only the selected packages. (#3866)Keep environment inspection working for Python 3.9 targets when PDM uses dep-logic 0.7 or newer.
IndexError when listing scripts and one of them is blank. A blank script is now listed as <BLANK_SCRIPT>. (#3842)pdm new is given an ssh:// or credentialed Git URL, instead of truncating it at the userinfo @. (#3843)requirements.txt file. (#3844)--trusted-host on host and port when importing a requirements.txt file, and keep the port when exporting one. (#3845)~ prefix in the venv.location config so pdm venv list/remove/activate/purge find virtualenvs created under it. (#3847)0.x version to the upper bound Poetry documents, so ^0.2.3 becomes <0.3.0 and ^0.0.3 becomes <0.0.4 instead of <1.0.0. (#3848)project.name and project.version for the pyproject.toml generated for uv, so pdm lock/pdm install work with use_uv on a project that declares neither. (#3849)Defer command action and Python installer imports until their corresponding runtime paths execute.
{run_cwd} placeholder for scripts to reference the original working directory. (#3734)tool.pdm.resolution.lock_inputs while retaining sticky lockfile behavior and legacy hash fallback for existing lock files. (#3821)argcomplete for simplified command-line completion scripts. (#3823)default in the lockfile. (#3816)comparable_version(). (#3817)use_uv support adding local files. (#3822)pyproject.toml when importing a flit project that omits author-email/maintainer-email or sets only one of include and exclude in [tool.flit.sdist]. (#3832)Add experimental workspace support for managing local member projects in a shared root lock file.
pdm completion bash printing __ltrim_colon_completions: command not found (and a similar error for _get_comp_words_by_ref) when the generated script is sourced in a bash without the bash-completion package loaded, such as Git Bash on Windows or minimal Linux containers. The script now defines small fallbacks for both helpers when they are not already available. (#3793)Invoke-Expression (iex) does not accept an -Args parameter and cannot forward arguments to a piped script, so the documented command failed. Use the $env:PDM_VERSION environment variable, which the install script reads, instead. (#3792)Update the minimum required Python version to 3.10.
pyproject.toml when running pdm init or pdm new. (#3786).pdm-plugins under the project root to an isolated cache directory, and add a fixer to migrate existing plugin directories. (#3790)importlib.metadata and importlib.resources APIs directly. (#3796)pdm.toml, .pdm-python, .python-version) when the destination is a symlink, preventing an untrusted repository from clobbering files outside the project root. (#3788)PDM_LOCKFILE env var is not respected. (#3794)--exclude-newer value with strategy.exclude-newer. (#3795)Support exclude-newer in pyproject.toml in the [tool.pdm.resolution] table
exclude-newer in pyproject.toml in the [tool.pdm.resolution] table (#3776)exclude-newer to be defined in pyproject.toml by @sneakers-the-rat in https://github.com/pdm-project/pdm/pull/3782Full Changelog: https://github.com/pdm-project/pdm/compare/2.26.8...2.26.9
pdm lock --exclude-newer now accepts relative durations in the format N{d|h|w} , such as 7d , 12h , and 3w , in addition to absolute UTC dates and tim
pdm lock --exclude-newer now accepts relative durations in the format N{d|h|w}, such as 7d, 12h, and 3w, in addition to absolute UTC dates and timestamps. (#3760)pdm add --frozen-lockfile --no-sync to skip dependency resolution and update only pyproject.toml without attempting to write the lockfile. (#3755)[tool.pdm.options] being loaded from the current working directory instead of the target project when -p/--project is used. (#3756)make_file_executable into pdm.utils to replace the method of the same name in installer. To fix a breakage introduced by installer v1. (#3764)pdm init <template> overwriting the template's additions to build-system.requires when build-system.build-backend matches the user's selection. (#3766)PySpecSet merging to handle impossible Python version ranges like >=3.6,<3.4 without crashing on empty or inverted gaps. (#3767)Speed up dependency resolution when there are complex conflicts.
Support packaging==26.0 changes for version comparison
packaging==26.0 changes for version comparison (#3729)Respect the project path when using cookiecutter template in pdm init command.
Make sure cursor closing for fixing PyPy different gc mode also add PyPy in CI.
Update .gitignore file in the default template.
hishel 1.0.0. (#3700).gitignore file in the default template. (#3686)packages.vcs.requested-revision if it's None when formatting pylock.toml. (#3694)Add deprecation warning for pdm search command as PyPI no longer supports search API.
tomlkit when writing is required. (#3672)UV_PROJECT_ENVIRONMENT env var when using uv mode. (#3675)implementation.gil_disabled is a boolean in get_current_env_spec. This fix an issue that free-threaded wheels get rejected incorrectly. (#3677)PdmBasicAuth a cached_property to accelerate execution. (#3684)pdm search command as PyPI no longer supports search API. (#3674)Substitute missing env vars with empty string in expand_env_vars.
Limit the log file size to 100MB and truncate the log output if exceeded.
publish --skip-existing for Nexus Repository OSS >= 3.70 (#3617)python requirement during locking. (#3635)use_uv=true. (#3640)No significant changes.
No significant changes.
Fix a careless error by fast apply in AI coding.
Show the path to site-packages in the output of pdm info.
pdm info. (#3600)uv python dir path resolution on Windows (#3603)The pdm python install -v command now shows the download URL for the Python interpreter.
pdm python install -v command now shows the download URL for the Python interpreter. (#3552)make_array always returns a tomlkit array type. (#3586)Tell the difference between free-threaded Python and normal ones. Users need to request for free-threaded versions explicitly by adding t to the versi
t to the version string, otherwise the normal build will be preferred. (#3562)pylock.toml. (#3565)pdm export with --lockfile pylock.toml produced empty requirements.txt files due to missing group information extraction from pylock format markers. (#3573)Add credentials when passing source urls to uv resolver.
resolvelib to 1.2.0. (#3557)Fix a bug that local file package metadata was missing when reading the lockfile.
Fix a bug that local file package metadata was missing when reading the lockfile.
Fix duplicated dependencies added to the lock file when the same dependency with extras is requested.
Support pylock as alternative lock format and make it opt-in by config.
array_of_inline_tables to list[dict] from list[str] (#3523)Reinstalling local wheel if its checksum changes.
static_urls is not enabled when running pdm export -f pylock. (#3517)--self or --editable-self is passed to pdm export -f pylock. (#3518)Install the project when using the BaseSynchronizer with install_self set to True. This fixes the bug that when calling pdm sync --quiet, it skips ins
New command pdm new that behaves like pdm init but creates a new project.
pdm new that behaves like pdm init but creates a new project. (#3462)--name as project name for command pdm new e.g. pdm new hello --name world (#3476)--quiet option to pdm sync command. (#3401).python-version file is found and it contains multiple lines, the file will be ignored. The usage of the .python-version file can be disabled, if configuration value python.use_python_version (or environment variable PDM_USE_PYTHON_VERSION) is False. (#3417)pdm config -e command to open read-only file under linux (#3423)README.md and pyproject.toml when running pdm init <template>. (#3460)pdm lock --update-reuse. (#3461)Use pyapp to wrap pdm as a Python application that bootstrap itself at runtime.
pyapp to wrap pdm as a Python application that bootstrap itself at runtime. (#3429)id is supporting currently for OIDC trusted publishing (#3441)pdm remove doesn't handle dependency groups include correctly. (#3452)unearth to address an issue downloading git repos with short commit hash. (#3455)Add pdm python find command to search for a python interpreter.
Ensure dev-dependencies are added to the correct group when the tool.pdm.dev-dependencies table has groups.
tool.pdm.dev-dependencies table has groups. (#3392)Don't validate local file requirements that are not used.
Write installer metadata like INSTALLER and REQUESTED to dist-info directory when installing packages.
INSTALLER and REQUESTED to dist-info directory when installing packages. (#3359).python-version file in the project root directory when selecting the Python interpreter. By default, it will be written when running pdm use command. (#3367)shellingham.detect_shell() returns ('tcsh', '/bin/tcsh') for tcsh on FreeBSD, so the current code tries to use the Bash venv activation script and fails due to syntax error. This change fixes the issue. (#3366)Fix zsh hanging issue by removing PyPI package completion.
Use minimal template if the project is an application.
safe_compatible version specifiers saving strategy. (#3301)scripts.show_header settings. (#3313)overrides settings under [tool.pdm.resolution] with use_uv (#3330)wheel to build a setuptools-backed package. (#3320)pdm remove <package> with uv enabled. (#3323)include-group items. (#3333)Pass original working directory as env variable to pdm scripts
pdm run (#3277)OrderedSet.__contains__ run in O(1) (#3280)post_lock after writing pyproject.toml and pdm.lock in add/update (#3285)Add a fixer to remove the deprecated cross_platform strategy from lock file.
cross_platform strategy from lock file. (#3259)pdm build would fail when use_uv is true. (#3231)pdm run. (#3252)no_proxy when all_proxy is set. (#3254)ErrorArgumentParser for Python 3.12 and above. (#3264)Support dependency groups as standardized by PEP 735. By default, dev dependencies will be written to [dependency-groups] table.
[dependency-groups] table. (#3230)strategy.inherit_metadata config is not honored when using --lockfile option. (#3232)use_uv is on. (#3233)resolvelib to 1.1.0. (#3235)Support dependency groups as standardized by PEP 735. By default, dev dependencies will be written to [dependency-groups] table.
[dependency-groups] table. (#3230)strategy.inherit_metadata config is not honored when using --lockfile option. (#3232)use_uv is on. (#3233)resolvelib to 1.1.0. (#3235)Allow linking existing Python interpreters to PDM's managed location.
--no-frozen-deps option to install-pdm.py script to allow installing newer versions of dependencies. (#3213)pdm self update now prefers the locked dependencies unless --no-frozen-deps is specified. (#3216)pdm outdated will only list direct dependencies. This can be changed by adding the --include-sub option. (#3218)Support installing free-threaded Python interpreters with the t suffix.
t suffix. (#3201)use_uv fails to lock when there are non-ascii characters in pyproject.toml on Windows. (#3181)pre_install and post_install signals receiving an exhausted generator, instead of a list of packages. (#3190)uv format marker matching. (#3197)pdm lock --check on a lockfile generated with older PDM version has a 0 exit code when there's a change in pyproject.toml. (#3199)PDM libraries are not loaded correctly for in-process scripts when installed in the user site.
Fallback version to 0.0.0 when the version is not specified or empty. This can avoid crash when building such project.
/ is URL encoded in sources URL environment variables. (#3169)env_spec.py script. (#3176)setuptools-pep660 when the build backend doesn't support PEP 660. (#3159)Fallback version to 0.0.0 when the version is not specified or empty. This can avoid crash when building such project. ( #3163 )
Ensures that / is URL encoded in sources URL environment variables. ( #3169 )
Call functions from shared library in the in-process env_spec.py script. ( #3176 )
Deprecate Core.synchronizer_class attribute. To get the synchronizer class, use Project.get_synchronizer method instead. Deprecate Core.resolver_class…
pre_install and post_install signals now receive the list of packages to be installed, instead of a candidate mapping. (#3144)Core.synchronizer_class attribute. To get the synchronizer class, use Project.get_synchronizer method instead.
Deprecate Core.resolver_class attribute. To get the resolver class, use Project.get_resolver method instead. (#3144)uv as the resolver and installer. One can opt in by setting use_uv to true using pdm config command. (#3144)excludes and overrides settings when installing packages. (#3113)pdm remove. (#3133)pdm venv purge, if the current project's python version had been referencing the removed venv then clear it out. (#3137)Respect the excludes and overrides settings when installing packages.
excludes and overrides settings when installing packages. (#3113)pdm remove. (#3133)pdm venv purge, if the current project's python version had been referencing the removed venv then clear it out. (#3137)pdm config to not show site configuration file path if it doesn't exist. (#3149)--no-markers is used, the exported requirements can only work on the current platform. (#3152)Skip checking project.name if it is absent when running pdm outdated.
project.name if it is absent when running pdm outdated. (#3095)cross_platform strategy from old lock files. (#3105)Respect certificates in env vars REQUESTS_CA_BUNDLE and CURL_CA_BUNDLE when verifying SSL certificates.
REQUESTS_CA_BUNDLE and CURL_CA_BUNDLE when verifying SSL certificates. (#3076)pdm venv activate to remove quotes such that iex (pdm venv activate) works correctly (#2895)install-pdm.py if there is an invalid pyproject.toml file under the current directory. (#3085)PDM_PROJECT_ROOT to the dotenv file for expansion. (#3087)--append option. (#3089)Fix a crash issue when requires-python is absent in the project metadata.
Improve the installation progress output to show the time elapsed.
Raise dep-logic lower bound to 0.4.2 to fix issues with pdm lock after upgrading from older pdm versions
Remove the deprecation warning of BaseCommand.__init__() method. Now it doesn't take any arguments.
LockedRepository.all_candidates now returns a dict[str, list[Candidate]] instead of dict[str, Candidate]. (#2995)post_lock hook now receives a resolution result of type dict[str, list[Candidate]], instead of dict[str, Candidate]. (#2995)Support reading requirement constraints from pip-style requirement files for "overriding" via --override option. (#2896)
Add a --non-interactive option for automation scenarios, also interactive prompts will not show up when not running in an interactive terminal. (#2934)
Add --license and --project-version as CLI options to control and streamline them during pdm init - especially in automated scenarios with --non-interactive (#2978)
Run pdm sync in "post-rewrite" stage of pre-commit (#2994)
Project.get_dependencies() now returns a list of Requirement instead of a mapping.
The first argument of Project.add_dependencies() now accepts a list of Requirement instead of a mapping.
The old usage will be kept working for a short period of time and will be removed in the future. (#2995)
Support locking for specific target, which is a combination of (python, platform, implementation) triple. Bump lock file version to 4.5.0.
Example usage: pdm lock --platform=linux --python="==3.8.*" --implementation=cpython. See the docs for more details. (#2995)
Rename --reuse-env to --recreate for run command, and reverse the behavior. (#2999)
PDM is now published with optional pinned dependencies using the pdm plugin pdm-build-locked.
To install pdm with its dependencies pinned to the versions it was tested with, run:
pipx install pdm[locked]
To install optional dependency group copier:
pipx install pdm[locked,copier-locked]
This feature is entirely optional. Installing pdm without the extra will work the same way as before this change. (#3001)
Added --clean-unselected alias for --only-keep (#3007)
Group options for update strategy and save strategy. (#3016)
-p is passed to change the project root. (#3009)PATH env var length to grow. (#3022)BaseCommand.__init__() method. Now it doesn't take any arguments. (#2995)Provider.get_reuse_candidate() method is deprecated in favor of Provider.iter_reuse_candidates(), to return an iterable of reuse candidates. (#2995)--no-markers option in pdm export command becomes a no-op and is marked as deprecated, because it doesn't make sense anymore. (#2995)ignore_compatibility parameter of Project.get_provider()/Project.get_repository()/Environment.get_finder() is deprecated. Pass in a EnvSpec via env_spec parameter instead.
requires_python parameter of pdm.resolver.core.resolve() function is deprecated and has no effect.
cross_platform parameter of pdm.cli.actions.resolve_candidates_from_lockfile() function is deprecated and has no effect. (#2995)Fix new interface from pbs_installer regarding build_dir and best match auto-install strategy for pdm use (same as for pdm python install --list)
Add --no-extras to pdm export to strip extras from the requirements. Now the default behavior is to keep extras.
--no-extras to pdm export to strip extras from the requirements. Now the default behavior is to keep extras. (#2519)pdm use and pdm python install now take requires-python into account (incl. from pyproject.toml) if python version
not specified and pdm use provides auto installation by that. (#2943)--no-isolation no longer installs build-requires nor dynamic build dependencies, to be consistent with pip. (#2944)tool.pdm.resolution table when calculating the content hash of project file, previously only overrides table was used.
This will change the hash already stored in the lockfile, so bump the lockfile version to 4.4.2. (#2956)One column per quarter.