# python-poetry/poetry

Python packaging and dependency management made easy

Repository: https://github.com/python-poetry/poetry
Canonical: https://ross.abutalabs.com/products/poetry
Homepage: https://python-poetry.org
Language: Python
License: MIT
License Family: permissive
Topics: python, dependency-manager, package-manager, packaging, poetry
Last push: 2026-08-24T21:33:54+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 83, longevity 100
- inputs: {"age_days": 3108, "days_push": 9, "days_rel": 116, "gap_med": 29, "n_releases_24m": 18}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 34293, forks 2478 (observed 2026-08-28T04:12:00.497215+00:00)

## What it is
Poetry is a CLI tool for Python dependency management and packaging that uses a pyproject.toml-based project format with a lockfile for deterministic, repeatable installs. It handles dependency resolution, virtual environment management, building sdists/wheels, and publishing to PyPI or private repositories.

## Use cases
- manage python project dependencies
- create a lockfile for reproducible installs
- build and publish a package to pypi
- replace setup.py and requirements.txt with pyproject.toml
- manage virtual environments for python projects
- organize dev and test dependency groups
- install packages from private pypi repositories

## When to choose
- you want deterministic builds with a lockfile for a Python application
- you want one tool for dependency management, packaging, and publishing
- you want automatic virtual environment isolation per project
- you need dependency groups for dev, test, or docs dependencies

## When to avoid
- your team is standardized on pip + pip-tools or uv workflows
- you only need to install packages without project dependency management
- you need to support Python versions older than 3.9

## Facets
- artifact type: cli-tool
- maturity: stable
- function: package-manager, build-tool, cli, developer-tools
- domain: developer-tools, programming-languages
- platform: python, windows, cli, cross-platform
- tags: python-packaging, dependency-management, pyproject-toml, lockfile, virtualenv, pypi-publishing, dependency-resolution, command-line, automation, linux, macos

## Member repositories
- python-poetry/poetry (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:12:00.497215+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:27:36.061928+00:00, confidence not recorded.
  - readme: https://github.com/python-poetry/poetry (fetched 2026-08-28T04:12:00.497215+00:00, sha 1847b439456e)
  - homepage: https://python-poetry.org (fetched 2026-08-29T07:48:33.029107+00:00, sha 80d06da25d30)
  - site_page: https://python-poetry.org/docs (fetched 2026-08-29T07:48:33.039588+00:00, sha 67256fb895d9)
  - site_page: https://python-poetry.org/docs/basic-usage (fetched 2026-08-29T07:48:33.042825+00:00, sha e3a2dcdeaec3)
  - site_page: https://python-poetry.org/docs/managing-dependencies (fetched 2026-08-29T07:48:33.045317+00:00, sha 13c1da8ae5b6)
  - site_page: https://python-poetry.org/docs/libraries (fetched 2026-08-29T07:48:33.047588+00:00, sha 136b570d5ffc)
  - site_page: https://python-poetry.org/docs/cli (fetched 2026-08-29T07:48:33.049821+00:00, sha cdc26ed5f2a8)
  - site_page: https://python-poetry.org/docs/configuration (fetched 2026-08-29T07:48:33.053116+00:00, sha b92972787567)
  - site_page: https://python-poetry.org/docs/repositories (fetched 2026-08-29T07:48:33.056156+00:00, sha 9a4f7a03377b)
  - site_page: https://python-poetry.org/docs/managing-environments (fetched 2026-08-29T07:48:33.059052+00:00, sha 3cd6e1c08106)
- Data as of 2026-08-30T08:39:29.467469+00:00.