pypa

warehouse: Power the Python Package Index

Warehouse is the software behind PyPI, the Python Package Index and a registry for Python packages. It is for teams building or contributing to the package index, with Docker-based local development and a Python and Node.js toolchain.

ActivePythonApache-2.0Developer ToolsWeb AppDocker
Stars
4.2k
Forks
1.3k
Stars, last 30 days
+25
Last commit
today
Contributors
100+

Our take

Activeregular commits

Health score

69/100

How it is scored
Activity
52
Community
91
Issues
74
Pull requests
60

+25 stars in the last 30 days

  • Merges more pull requests than 87% of the projects we track
  • Closes issues faster than 81% of the projects we track
  • More contributors than 78% of the projects we track

Warehouse is an actively maintained, Apache-2.0-licensed foundation for PyPI, though its lack of a recent release makes release cadence worth checking before adoption.

Good fit if

  • You are developing or maintaining PyPI or Python package-registry infrastructure.
  • You can work with a Python and Node.js toolchain and Docker-based development setup.
  • You value an active project with regular commits, merged pull requests, and a broad contributor base.

Look elsewhere if

  • You need a recent published release as a prerequisite, since the health data reports no release in the past year.
  • You want a ready-to-run package registry without taking on the project's development environment and operational requirements.
All health signals
Last commit2026-11-10 (today)
Commits, last 90 days100+
Releases, last 12 months0
Contributors100+ (top contributor: 22% of commits)
Issues closed, last 90 days3+ (typically closed in 0 days)
Pull requests merged, last 90 days80 (typically merged in 1 day)
Project age13 years

Checked on 2026-11-11 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

4,195

Forks

1,283

Change since Nov 17, 2026: 0 stars·+1 forks

Overview

Warehouse is the software behind PyPI, the Python Package Index. It provides the package registry and repository service at pypi.org, where Python packages are published and distributed.

The project is intended for people maintaining or contributing to PyPI and for teams that need to understand or work on its implementation. Its documentation includes an architectural overview and instructions for running a local development environment with Docker.

Key Features

  • Powers the canonical PyPI service at pypi.org.
  • Provides the software for a Python package registry and repository.
  • Documents the application's architecture.
  • Supports local development using Docker and Docker Compose.
  • Includes tests and linters, with setup guidance in the documentation.
  • Offers issue tracking and community discussion channels for contributors.

Use Cases

  • PyPI contributors can run Warehouse locally to develop and test changes.
  • Teams maintaining Python package infrastructure can study the implementation and architectural overview.
  • Developers can report defects or propose changes through the GitHub issue tracker.
  • Packaging community members can discuss development and initiatives through the linked community channels.

What you need

Detected in the repository

  • Node.js (from package.json)
  • Python (from pyproject.toml)
  • A Dockerfile, so it can run in a container; a Compose file sets up the related services
  • A test suite and automated checks on GitHub Actions

License in plain words

Apache-2.0permissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license, the NOTICE file and a note of your changes
  • Share your changes: no
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

See the getting started documentation for local setup instructions, and the README for project links and contribution guidance.

Considerations

The project is active, with regular commits and merged pull requests, but the measured issue-closure count is low; teams should assess their own support needs rather than assume issues will be resolved quickly. The repository reports no release in the past year, so confirm the release and deployment process that suits your use. Local development requires Docker and involves both Python and Node.js. The project is licensed under Apache-2.0.

Found this useful?

Share it with someone who would like warehouse.