# poetry > Python dependency management and packaging made easy. - **URL**: https://www.freshcrate.ai/projects/poetry - **Author**: Sébastien Eustace - **Category**: Developer Tools - **Latest version**: `2.4.1` (2026-05-09) - **License**: Unknown - **Source**: https://github.com/python-poetry/poetry - **Homepage**: https://pypi.org/project/poetry/ - **Language**: Python - **GitHub**: 34,271 stars, 2,430 forks - **Registry**: pypi (`poetry`) - **Tags**: `dependency`, `packaging`, `poetry`, `pypi` ## Description # Poetry: Python packaging and dependency management made easy [![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/) [![Stable Version](https://img.shields.io/pypi/v/poetry?label=stable)][PyPI Releases] [![Pre-release Version](https://img.shields.io/github/v/release/python-poetry/poetry?label=pre-release&include_prereleases&sort=semver)][PyPI Releases] [![Python Versions](https://img.shields.io/pypi/pyversions/poetry)][PyPI] [![Download Stats](https://img.shields.io/pypi/dm/poetry)](https://pypistats.org/packages/poetry) [![Discord](https://img.shields.io/discord/487711540787675139?logo=discord)][Discord] Poetry helps you declare, manage and install dependencies of Python projects, ensuring you have the right stack everywhere. ![Poetry Install](https://raw.githubusercontent.com/python-poetry/poetry/main/assets/install.gif) Poetry replaces `setup.py`, `requirements.txt`, `setup.cfg`, `MANIFEST.in` and `Pipfile` with a simple `pyproject.toml` based project format. ```toml [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 * [Releases][PyPI Releases] * [Official Website] * [Documentation] * [Issue Tracker] * [Discord] [PyPI]: https://pypi.org/project/poetry/ [PyPI Releases]: https://pypi.org/project/poetry/#history [Official Website]: https://python-poetry.org [Documentation]: https://python-poetry.org/docs/ [Issue Tracker]: https://github.com/python-poetry/poetry/issues [Suggested Issues]: https://github.com/python-poetry/poetry/contribute [Contributing Documentation]: https://python-poetry.org/docs/contributing [Discord]: https://discord.com/invite/awxPgve [install.python-poetry.org]: https://install.python-poetry.org [Installation Documentation]: https://python-poetry.org/docs/#installation ## Related Projects * [poetry-core](https://github.com/python-poetry/poetry-core): PEP 517 build-system for Poetry projects, and dependency-free core functionality of the Poetry frontend * [poetry-plugin-export](https://github.com/python-poetry/poetry-plugin-export): Export Poetry projects/lock files to foreign formats like requirements.txt * [poetry-plugin-bundle](https://github.com/python-poetry/poetry-plugin-bundle): Install Poetry projects/lock files to external formats like virtual environments * [install.python-poetry.org](https://github.com/python-poetry/install.python-poetry.org): The official Poetry installation script * [website](https://github.com/python-poetry/website): The official Poetry website and blog ## Supporters Thanks to [JetBrains](https://www.jetbrains.com) for supporting us with license ## Recent releases | Version | Date | Urgency | Changes | | --- | --- | --- | --- | | `2.4.1` | 2026-05-09 | High | ### Changed - Re-allow `installer==0.7.0` ([#10887](https://github.com/python-poetry/poetry/pull/10887)). ### Fixed - Fix an issue where `poetry update ` failed when `` was a transitive dependency ([#10885](https://github.com/python-poetry/poetry/pull/10885)). | | `2.4.0` | 2026-05-03 | High | ### Added - Add `solver.min-release-age` setting to require package releases to be a certain number of days old before they are considered during dependency resolution ([#10824](https://github.com/python-poetry/poetry/pull/10824)). - Add `solver.min-release-age-exclude` to exclude selected packages from age filtering ([#10824](https://github.com/python-poetry/poetry/pull/10824)). - Add `solver.min-release-age-exclude-source` to exclude all packages from selected package indexes from age fil | | `2.3.4` | 2026-04-21 | Low | Imported from PyPI (2.3.4) | | `2.3.3` | 2026-03-29 | Medium | ### Fixed - **Fix a path traversal vulnerability in the wheel installer that could allow malicious wheel files to write files outside the intended installation directory** ([#10792](https://github.com/python-poetry/poetry/pull/10792)). - Fix an issue where `git` dependencies from annotated tags could not be updated ([#10719](https://github.com/python-poetry/poetry/pull/10719)). - Fix an issue where empty `VIRTUAL_ENV` or `CONDA_PREFIX` environment variables (e.g., after `conda deactivate`) | | `2.3.2` | 2026-02-01 | Low | ### Changed - Allow `dulwich>=1.0` ([#10701](https://github.com/python-poetry/poetry/pull/10701)). ### poetry-core ([`2.3.1`](https://github.com/python-poetry/poetry-core/releases/tag/2.3.1)) - Fix an issue where `platform_release` could not be parsed on Windows Server ([#911](https://github.com/python-poetry/poetry-core/pull/911)). | | `2.3.1` | 2026-01-20 | Low | ### Fixed - Fix an issue where cached information about each package was always considered outdated ([#10699](https://github.com/python-poetry/poetry/pull/10699)). ### Docs - Document SHELL_VERBOSITY environment variable ([#10678](https://github.com/python-poetry/poetry/pull/10678)). | | `2.3.0` | 2026-01-18 | Low | ### Added - **Add support for exporting `pylock.toml` files with `poetry-plugin-export`** ([#10677](https://github.com/python-poetry/poetry/pull/10677)). - Add support for specifying build constraints for dependencies ([#10388](https://github.com/python-poetry/poetry/pull/10388)). - Add support for publishing artifacts whose version is determined dynamically by the build-backend ([#10644](https://github.com/python-poetry/poetry/pull/10644)). - Add support for editable project plugins ([#10 | | `2.2.1` | 2025-09-21 | Low | ### Fixed - Fix an issue where `poetry self show` failed with a message about an invalid output format ([#10560](https://github.com/python-poetry/poetry/pull/10560)). ### Docs - Remove outdated statements about dependency groups ([#10561](https://github.com/python-poetry/poetry/pull/10561)). ### poetry-core ([`2.2.1`](https://github.com/python-poetry/poetry-core/releases/tag/2.2.1)) - Fix an issue where it was not possible to declare a PEP 735 dependency group as optional ([#888]( | | `2.2.0` | 2025-09-14 | Low | ### Added - **Add support for nesting dependency groups** ([#10166](https://github.com/python-poetry/poetry/pull/10166)). - **Add support for PEP 735 dependency groups** ([#10130](https://github.com/python-poetry/poetry/pull/10130)). - **Add support for PEP 639 license clarity** ([#10413](https://github.com/python-poetry/poetry/pull/10413)). - Add a `--format` option to `poetry show` to alternatively output json format ([#10487](https://github.com/python-poetry/poetry/pull/10487)). - Add | | `2.1.4` | 2025-08-05 | Low | ### Changed - Require `virtualenv<20.33` to work around an issue where Poetry uses the wrong Python version ([#10491](https://github.com/python-poetry/poetry/pull/10491)). - Improve the error messages for the validation of the `pyproject.toml` file ([#10471](https://github.com/python-poetry/poetry/pull/10471)). ### Fixed - Fix an issue where project plugins were installed even though `poetry install` was called with `--no-plugins` ([#10405](https://github.com/python-poetry/poetry/pull/ | ## Citation - HTML: https://www.freshcrate.ai/projects/poetry - Markdown: https://www.freshcrate.ai/projects/poetry.md - Dependencies JSON: https://www.freshcrate.ai/api/projects/poetry/deps _Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._