Python dependency management and packaging made easy.
Project Links
Meta
Author: Sébastien Eustace
Maintainer: Arun Babu Neelicattu
Requires Python: >=3.10,<4.0
Classifiers
Programming Language
- Python :: 3
- Python :: 3.10
- Python :: 3.11
- Python :: 3.12
- Python :: 3.13
- Python :: 3.14
Topic
- Software Development :: Build Tools
- Software Development :: Libraries :: Python Modules
Poetry: Python packaging and dependency management made easy
Poetry helps you declare, manage and install dependencies of Python projects, ensuring you have the right stack everywhere.
Poetry replaces setup.py, requirements.txt, setup.cfg, MANIFEST.in and Pipfile with a simple pyproject.toml
based project format.
[project]
name = "my-package"
version = "0.1.0"
description = "The description of the package"
license = { text = "MIT" }
readme = "README.md"
# No python upper bound for package metadata
requires-python = ">=3.9"
authors = [
{ name = "Sébastien Eustace", email = "sebastien@eustace.io" },
]
# Keywords (translated to tags on the package index)
keywords = ["packaging", "poetry"]
dependencies = [
# equivalent to ^3.8.1 with semver constraints
"aiohttp (>=3.8.1,<4.0.0)",
# dependency with extras
"requests[security] (>=2.28,<3.0)",
# version-specific dependency with prereleases allowed (see below)
"tomli (>=2.0.1,<3.0.0) ; python_version < '3.11'",
# git dependency with branch specified
"cleo @ git+https://github.com/python-poetry/cleo.git@main",
]
[project.urls]
repository = "https://github.com/python-poetry/poetry"
homepage = "https://python-poetry.org"
# Scripts are easily expressed
[project.scripts]
my_package_cli = 'my_package.console:run'
[project.optional-dependencies]
# optional dependency to be installed via 'poetry install -E my-extra'
my-extra = ["pendulum (>=3.1.0,<4.0.0)"]
[tool.poetry.dependencies]
# Python upper bound for locking
python = ">=3.9,<4.0"
# Version-specific dependencies with prereleases allowed
tomli = { allow-prereleases = true }
# Dependency groups are supported for organizing your dependencies
[tool.poetry.group.dev.dependencies]
pytest = "^7.1.2"
pytest-cov = "^3.0"
# ...and can be installed only when explicitly requested
# via 'poetry install --with docs'
[tool.poetry.group.docs]
optional = true
[tool.poetry.group.docs.dependencies]
Sphinx = "^5.1.1"
Installation
Poetry supports multiple installation methods, including a simple script found at install.python-poetry.org. For full installation instructions, including advanced usage of the script, alternate install methods, and CI best practices, see the full installation documentation.
Documentation
Documentation for the current version of Poetry (as well as the development branch and recently out of support versions) is available from the official website.
Contribute
Poetry is a large, complex project always in need of contributors. For those new to the project, a list of suggested issues to work on in Poetry and poetry-core is available. The full contributing documentation also provides helpful guidance.
Resources
Related Projects
- poetry-core: PEP 517 build-system for Poetry projects, and dependency-free core functionality of the Poetry frontend
- poetry-plugin-export: Export Poetry projects/lock files to foreign formats like requirements.txt
- poetry-plugin-bundle: Install Poetry projects/lock files to external formats like virtual environments
- install.python-poetry.org: The official Poetry installation script
- website: The official Poetry website and blog
Supporters
Thanks to JetBrains for supporting us with licenses for their tools.
2.3.3
Mar 29, 2026
2.3.2
Feb 01, 2026
2.3.1
Jan 20, 2026
2.3.0
Jan 18, 2026
2.2.1
Sep 21, 2025
2.2.0
Sep 14, 2025
2.1.4
Aug 05, 2025
2.1.3
May 04, 2025
2.1.2
Mar 29, 2025
2.1.1
Feb 16, 2025
2.1.0
Feb 15, 2025
2.0.1
Jan 12, 2025
2.0.0
Jan 05, 2025
1.8.5
Dec 06, 2024
1.8.4
Oct 14, 2024
1.8.3
May 08, 2024
1.8.2
Mar 02, 2024
1.8.1
Feb 26, 2024
1.8.0
Feb 25, 2024
1.7.1
Nov 16, 2023
1.7.0
Nov 03, 2023
1.6.1
Aug 21, 2023
1.6.0
Aug 20, 2023
1.5.1
May 29, 2023
1.5.0
May 19, 2023
1.4.2
Apr 02, 2023
1.4.1
Mar 19, 2023
1.4.0
Feb 27, 2023
1.3.2
Jan 10, 2023
1.3.1
Dec 12, 2022
1.3.0
Dec 09, 2022
1.2.2
Oct 10, 2022
1.2.1
Sep 16, 2022
1.2.0
Aug 31, 2022
1.2.0rc2
Aug 26, 2022
1.2.0rc1
Aug 23, 2022
1.2.0b3
Jul 13, 2022
1.2.0b2
Jun 06, 2022
1.2.0b1
Mar 17, 2022
1.2.0a2
Aug 01, 2021
1.2.0a1
May 21, 2021
1.1.15
Aug 22, 2022
1.1.14
Jul 08, 2022
1.1.13
Feb 10, 2022
1.1.12
Nov 28, 2021
1.1.11
Oct 04, 2021
1.1.10
Sep 21, 2021
1.1.9
Sep 18, 2021
1.1.8
Aug 19, 2021
1.1.7
Jun 25, 2021
1.1.6
Apr 14, 2021
1.1.5
Mar 04, 2021
1.1.4
Oct 23, 2020
1.1.3
Oct 14, 2020
1.1.2
Oct 06, 2020
1.1.1
Oct 05, 2020
1.1.0
Oct 01, 2020
1.1.0rc1
Sep 25, 2020
1.1.0b4
Sep 22, 2020
1.1.0b3
Sep 18, 2020
1.1.0b2
Jul 24, 2020
1.1.0b1
Jul 24, 2020
1.1.0a3
Jul 10, 2020
1.1.0a2
Jun 26, 2020
1.1.0a1
Mar 27, 2020
1.0.10
Jul 21, 2020
1.0.9
Jun 09, 2020
1.0.8
Jun 05, 2020
1.0.7
Jun 05, 2020
1.0.6
Jun 05, 2020
1.0.5
Feb 29, 2020
1.0.4
Feb 28, 2020
1.0.3
Jan 31, 2020
1.0.2
Jan 10, 2020
1.0.1
Jan 10, 2020
1.0.0
Dec 12, 2019
1.0.0b9
Dec 07, 2019
1.0.0b8
Nov 26, 2019
1.0.0b7
Nov 22, 2019
1.0.0b6
Nov 20, 2019
1.0.0b5
Nov 15, 2019
1.0.0b4
Nov 08, 2019
1.0.0b3
Oct 25, 2019
1.0.0b2
Oct 11, 2019
1.0.0b1
Aug 09, 2019
1.0.0a5
Jul 15, 2019
1.0.0a4
Jun 11, 2019
1.0.0a3
May 26, 2019
1.0.0a2
Jan 14, 2019
1.0.0a1
Dec 08, 2018
1.0.0a0
Dec 08, 2018
0.12.17
Jul 03, 2019
0.12.16
May 17, 2019
0.12.15
May 03, 2019
0.12.14
Apr 26, 2019
0.12.13
Apr 26, 2019
0.12.12
Apr 11, 2019
0.12.11
Jan 13, 2019
0.12.10
Nov 22, 2018
0.12.9
Nov 19, 2018
0.12.8
Nov 13, 2018
0.12.7
Nov 08, 2018
0.12.6
Nov 05, 2018
0.12.5
Oct 26, 2018
0.12.4
Oct 21, 2018
0.12.3
Oct 18, 2018
0.12.2
Oct 17, 2018
0.12.1
Oct 17, 2018
0.12.0
Oct 17, 2018
0.12.0a5
Oct 16, 2018
0.12.0a4
Oct 16, 2018
0.12.0a3
Oct 08, 2018
0.12.0a2
Sep 18, 2018
0.12.0a1
Sep 13, 2018
0.12.0a0
Sep 13, 2018
0.11.5
Sep 04, 2018
0.11.4
Jul 30, 2018
0.11.3
Jul 26, 2018
0.11.2
Jul 03, 2018
0.11.1
Jun 29, 2018
0.11.0
Jun 28, 2018
0.11.0a4
Jun 19, 2018
0.11.0a3
Jun 14, 2018
0.11.0a2
Jun 14, 2018
0.11.0a1
Jun 08, 2018
0.11.0a0
Jun 08, 2018
0.10.3
Jun 04, 2018
0.10.2
May 31, 2018
0.10.1
May 29, 2018
0.10.0
May 28, 2018
0.10.0a3
May 27, 2018
0.10.0a2
May 22, 2018
0.10.0a1
May 20, 2018
0.10.0a0
May 17, 2018
0.9.1
May 18, 2018
0.9.0
May 07, 2018
0.9.0a3
May 04, 2018
0.9.0a2
May 02, 2018
0.9.0a1
May 01, 2018
0.9.0a0
Apr 30, 2018
0.8.6
Apr 30, 2018
0.8.5
Apr 19, 2018
0.8.5a0
Apr 19, 2018
0.8.4
Apr 18, 2018
0.8.3
Apr 16, 2018
0.8.2
Apr 14, 2018
0.8.1
Apr 13, 2018
0.8.1a0
Apr 13, 2018
0.8.0
Apr 13, 2018
0.8.0a4
Apr 11, 2018
0.8.0a3
Apr 10, 2018
0.8.0a2
Apr 09, 2018
0.8.0a1
Apr 09, 2018
0.8.0a0
Apr 09, 2018
0.7.1
Apr 05, 2018
0.7.0
Apr 04, 2018
0.7.0b4
Apr 03, 2018
0.7.0b3
Apr 02, 2018
0.7.0b2
Apr 02, 2018
0.7.0b1
Mar 29, 2018
0.6.5
Mar 22, 2018
0.6.4
Mar 21, 2018
0.6.4b1
Mar 21, 2018
0.6.3
Mar 20, 2018
0.6.3b7
Mar 20, 2018
0.6.3b6
Mar 20, 2018
0.6.3b5
Mar 20, 2018
0.6.3b4
Mar 20, 2018
0.6.3b3
Mar 20, 2018
0.6.3b2
Mar 19, 2018
0.6.3b1
Mar 19, 2018
0.6.2
Mar 19, 2018
0.6.1
Mar 18, 2018
0.6.0
Mar 16, 2018
0.5.0
Mar 14, 2018
0.5.0b2
Mar 14, 2018
0.5.0b1
Mar 14, 2018
0.4.2
Mar 10, 2018
0.4.1
Mar 08, 2018
0.4.0.post1
Mar 08, 2018
0.4.0
Mar 08, 2018
0.3.0
Mar 05, 2018
0.2.0
Mar 01, 2018
0.1.0
Feb 28, 2018
Wheel compatibility matrix
Files in release
Extras:
None
Dependencies:
build
(<2.0.0,>=1.2.1)
cachecontrol[filecache]
(<0.15.0,>=0.14.0)
cleo
(<3.0.0,>=2.1.0)
dulwich
(<2,>=0.25.0)
fastjsonschema
(<3.0.0,>=2.18.0)
findpython
(<0.8.0,>=0.6.2)
installer
(<0.8.0,>=0.7.0)
keyring
(<26.0.0,>=25.1.0)
packaging
(>=24.2)
pbs-installer[download,install]
(>=2025.6.10)
pkginfo
(<2.0,>=1.12)
platformdirs
(<5,>=3.0.0)
poetry-core
(==2.3.2)
pyproject-hooks
(<2.0.0,>=1.0.0)
requests
(<3.0,>=2.26)
requests-toolbelt
(<2.0.0,>=1.0.0)
shellingham
(<2.0,>=1.5)
tomli
(<3.0.0,>=2.0.1)
tomlkit
(<1.0.0,>=0.11.4)
trove-classifiers
(>=2022.5.19)
virtualenv
(>=20.26.6)
xattr
(<2.0.0,>=1.0.0)