---
id: pypiserver
version: "2.4.1"
license: unclear
license_treatment: permissive
maintenance: active
---

# pypiserver — A minimal PyPI server for use with pip/easy_install.

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

## 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 above — 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

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

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 898.2K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

private pypi server, local package index, pip package repository, self-hosted pypi, package server for pip, internal package distribution, offline package repository, package-distribution, self-hosted

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