poetry-core
Poetry PEP 517 Build Backend
Decision gist · record as of 2026-08-14
Yes. poetry-core is essential infrastructure for the Poetry ecosystem and widely used as a transitive dependency. It has zero runtime dependencies, active maintenance, no known vulnerabilities, and a permissive MIT license. Install it when you use Poetry for project management or when build tools need to construct Poetry-managed packages.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later; intended for use as a build backend in pyproject.toml, not as a direct library import.
- Low friction: zero runtime dependencies and a pure-Python wheel distribution.
- Actively maintained with recent commits and high visibility in the ecosystem.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary contexts with minimal restrictions.
last release 2026-05-23 (83 days) · last repo commit 2026-08-10 · 34,290 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 173,313,489 downloads/mo, #245 on PyPI
Alternatives
Verify before relying
# Add to pyproject.toml:
[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"
# Then build with pip:
pip install .
pip wheel .- Whether poetry-core handles all Poetry-specific pyproject.toml extensions or only a subset of Poetry's full feature set.
- Performance characteristics compared to other PEP 517 backends for complex dependency graphs.
What it is and what it does
poetry-core is a lightweight, self-contained PEP 517 build backend extracted from Poetry to solve a specific efficiency problem. Before version 1.1.0, Poetry bundled its entire dependency tree into every build operation, making builds unnecessarily slow when tools like pip or tox needed to construct distributions. poetry-core separates the minimal build logic needed to generate wheels and source distributions from Poetry's project management features, allowing build frontends to work with Poetry-managed projects without installing Poetry itself.
In practice, you declare poetry-core as your build backend in pyproject.toml, and then any PEP 517-compatible tool can read your Poetry configuration and produce distributions. The package handles pyproject.toml parsing and wheel/sdist generation. Most users never interact with it directly; it runs transparently when build tools operate on Poetry projects.
Use it for
- Enable CI/CD pipelines to build Poetry projects without installing the full Poetry tool and its dependencies.
- Allow build frontends to install Poetry-managed packages from source in isolated environments without Poetry overhead.
- Support isolated test environments that need to build Poetry projects without pulling in Poetry's dependency tree.
- Reduce build times in containerized deployments by using a minimal build backend instead of full Poetry.
- Enable third-party build frontends to work with Poetry-managed projects via the standard PEP 517 interface.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
poetry-core is essential infrastructure for the Poetry ecosystem and widely used as a transitive dependency. It has zero runtime dependencies, active maintenance, no known vulnerabilities, and a permissive MIT license. Install it when you use Poetry for project management or when build tools need to construct Poetry-managed packages.
Install
poetry-core on PyPI
Before you install
Low friction: zero runtime dependencies and a pure-Python wheel distribution. Actively maintained with recent commits and high visibility in the ecosystem.
Requires Python 3.10 or later; intended for use as a build backend in pyproject.toml, not as a direct library import.
License in practice
MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary contexts with minimal restrictions.
Quickstart
# Add to pyproject.toml:
[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"
# Then build with pip:
pip install .
pip wheel .Verify before relying
- Whether poetry-core handles all Poetry-specific pyproject.toml extensions or only a subset of Poetry's full feature set.
- Performance characteristics compared to other PEP 517 backends for complex dependency graphs.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <4.0,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 83 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 173,313,489 / month, #245 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Software Development :: Build ToolsTopic :: Software Development :: Libraries :: Python Modules |
Evidence: poetry_core-2.4.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “poetry build system”
- poetry-corepoetry-core is a PEP 517 build backend that enables build frontends…
- poetry-dynamic-versioningA Poetry plugin that automatically derives and injects version…
- poetryPoetry is a dependency management and packaging tool that replaces…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also poetry · poetry-multiproject-plugin · poetry-plugin-shell · pep517 · poetry-dynamic-versioning · flit-core · nox-poetry · pdm-backend · cmeel · PyQt-builder