pypiserver

What it is and what it does

pypiserver is a lightweight PyPI-compatible package index that runs on your own infrastructure, allowing pip, setuptools, and twine to upload and download packages as if connecting to the official PyPI. It serves packages from regular filesystem directories and implements the same interfaces as PyPI, so standard Python packaging tools work without modification.

The server is built on bottle and supports uploading wheels, source distributions, eggs, and PGP signatures via pip, setuptools, twine, or direct file copy. It's designed for teams and organizations that need a private package repository without the complexity of the official Warehouse software, and it can be deployed standalone, behind a reverse proxy, or as a systemd service.

Use it for:

• Host proprietary or internal packages for a team without uploading to public PyPI
• Create an offline package cache to speed up deployments in air-gapped environments
• Set up a staging index for testing package uploads before releasing to public PyPI
• Serve pre-built wheels for legacy or specialized dependencies in a corporate environment
• Mirror a subset of PyPI packages for faster local access during development

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Runs a minimal PyPI-compatible package server that pip and setuptools can install from, serving wheels, source distributions, and eggs from local directories.

Yes. pypiserver is production-stable, actively maintained, has no known vulnerabilities, and solves a real problem with minimal dependencies and low installation friction. Install it if you need a private or local package index; it's the standard lightweight choice for this use case.

Install

pypiserver on PyPI

pip install pypiserver

uv add pypiserver

poetry add pypiserver

Installing pypiserver

Before you install

Low friction installation with a pure-Python wheel and only four runtime dependencies. Actively maintained with recent commits and a stable release cadence; last release 185 days ago with active repository.

License in practice

Dual-licensed under zlib/libpng and MIT (both permissive); you can use and modify freely in commercial and private contexts with minimal restrictions.

Quickstart

pip install pypiserver
pypiserver run ~/packages

Requires Python 3.10 or later; PyPy3 is supported.

Verify before relying

• Whether the server handles authentication and authorization for multi-user deployments
• Performance characteristics when serving thousands of packages
• Whether HTTPS/TLS is supported natively or requires a reverse proxy

Package facts

Evidence: pypiserver-2.4.1-py2.py3-none-any.whl

Tags

More Build Tools packages