---
id: pypi-simple
version: "1.8.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# pypi-simple — PyPI Simple Repository API client library

License: permissive · Maintenance: active · Downloads: 375.7K/mo

## What it is and what it does

pypi-simple is a client library that implements the Python Simple Repository API as defined in PEP 503 and updated by several follow-up PEPs (592, 629, 658, 691, 700, 708, 714, 740, 792). It provides a programmatic interface to query PyPI and other pip-compatible package repositories, retrieve lists of available projects and their package files, and extract metadata like version, package type, file digests, requires_python constraints, PGP signatures, and metadata URLs.

The library wraps HTTP requests to repository endpoints and parses HTML responses using beautifulsoup4, with validation via pydantic. It's designed for developers who need to automate package discovery, download, or inspection workflows without invoking pip directly. The API is straightforward: instantiate a PyPISimple client, call get_project_page() to fetch a project's available packages, and access properties like filename, url, version, digests, and package_type on each result.

Use it for:

- Automate discovery and download of specific package versions from PyPI for offline distribution or mirroring.
- Query package metadata (version, digests, requires_python) to validate compatibility before installation.
- Build custom package management or dependency resolution tools that need direct access to repository metadata.
- Implement package auditing or compliance workflows that inspect available versions and their properties.
- Create alternative package installers or build systems that interact with pip-compatible repositories.

## Worth the install?

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

A client library for querying PyPI and pip-compatible repositories via the Simple Repository API (PEP 503 and related standards), retrieving project metadata, package files, and digests.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive MIT license. It fills a specific need for programmatic access to PyPI and compatible repositories via a well-specified standard. Install it if you need to query or download packages programmatically outside of pip's normal workflow.

## Install

pip install pypi-simple
uv add pypi-simple
poetry add pypi-simple

## Installing pypi-simple

Before you install: Low friction installation with only five runtime dependencies (beautifulsoup4, mailbits, packaging, pydantic, requests). Active maintenance with last commit on 2026-07-20 and a release on 2025-09-03. Supports Python 3.8 through 3.13 and PyPy.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

from pypi_simple import PyPISimple

with PyPISimple() as client:
    page = client.get_project_page('requests')
    pkg = page.packages[0]
    print(pkg.filename, pkg.version, pkg.digests)

Requires Python 3.8 or higher.

Verify before relying:

- Whether the optional tqdm integration (mentioned in docs) is available as a declared extra dependency in the package metadata.

## Package facts

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

## Tags

pypi simple repository api client, query pypi package metadata, download packages from pypi, pip repository api, package index client library, pep 503 implementation, package-management, pypi-client, repository-api

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