---
id: pyproject-api
version: "1.11.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# pyproject-api — API to interact with the python pyproject.toml based projects

License: permissive · Maintenance: active · Downloads: 18.5M/mo

## What it is and what it does

pyproject-api is a library that provides programmatic access to Python project configuration stored in pyproject.toml files. It abstracts away the details of parsing and validating project metadata, allowing tools and scripts to reliably read project information without manually handling TOML parsing or schema validation.

The package is designed for developers building tools that need to inspect or interact with Python projects—build systems, testing frameworks, dependency managers, and IDE integrations. It depends on packaging and tomli to handle the underlying parsing and version specification logic, and supports Python 3.10 and later.

Use it for:

- Build tools that need to read project metadata and dependencies from pyproject.toml without reimplementing parsing logic
- Testing frameworks that require introspection of project configuration and isolated environment setup
- Package managers or dependency resolvers that must inspect project metadata programmatically
- IDE plugins or editor extensions that display project information or validate configuration
- CI/CD pipelines that need to extract build requirements or project metadata at runtime

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a programmatic API to read and interact with Python projects defined by pyproject.toml files, handling project metadata and configuration parsing.

Yes. Active maintenance, zero known vulnerabilities, low install friction, and permissive MIT licensing make this a safe choice. The package is in production-stable status and widely used, making it a reliable foundation for tools that need to read pyproject.toml files.

## Install

pip install pyproject-api
uv add pyproject-api
poetry add pyproject-api

## Installing pyproject-api

Before you install: Low friction installation with only two lightweight runtime dependencies (packaging and tomli). Active maintenance with a release within the last month and no known vulnerabilities.

License in practice: MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects with minimal restrictions.

Quickstart:

pip install pyproject-api

from pyproject_api import Project

project = Project('.')
metadata = project.metadata

Requires Python 3.10 or later

Verify before relying:

- Whether the API supports dynamic project discovery or only static pyproject.toml parsing
- What specific pyproject.toml schema versions or PEP standards are supported

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 18.5M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pyproject.toml parsing, python project metadata api, read pyproject configuration, project metadata extraction, pyproject introspection, python project configuration, build-tools, project-metadata

[View on SkillFed](https://skillfed.io/packages/pyproject-api) · [View on PyPI](https://pypi.org/project/pyproject-api/)