Skip to main content

PyPI clone with Flask and Redis

Project description

PyPI clone with Flask and Redis. It’s the single most popular cheese in the world!


Cheddar aims to simplify Python development within organizations that simultaneously work with public and private Python distributions.

Cheddar includes:

  • A local package index for internal development, supporting setuptools register and upload commands.

  • A remote package index that proxies to a public repository (such as and caches packages and package version listings to reduce latency and minimize the effect of downtime by the public repository.

  • A combined package index that unifies the best of the local and remote implementations.

In addition, Cheddar supports a few features that simplify management within an organization:

  • Packages are stored locally in separate directories for pre-releases and releases, simplifying backup strategies that wish to ignore transitive development builds.

  • Duplicate package uploads return a predictable HTTP 409 Conflict error.

  • Mistakenly uploaded packages may be deleted using a simple, RESTful API.


Cheddar can run in any WSGI container or through Flask’s built-in development server (which is single-threaded and only recommended for development).

Configuation is loaded from the module along with the contents of the file pointed to by the CHEDDAR_SETTINGS environment variable, if any.

You may wish to modify several of the configuration parameters from their default values, including:

  • INDEX_URL which specifies the URL of the remote package index

  • REDIS_HOSTNAME which control the location of the Redis server

  • LOCAL_CACHE_DIR which controls the storage location of locally uploaded files

  • REMOTE_CACHE_DIR which controls the storage location of cached remote files

The Local Index

To use the local index:

  1. Edit your ~/.pypirc to contain an entry for Cheddar. It should look _something_ like:

    index-servers =

    Note that the URL here assumes you are running the “development” server.

  2. Add credentials to Redis:

    redis-cli set cheddar.user.myusername mypassword
  3. Upload your distribution:

    cd /path/to/directory/containing/
    python sdist upload -r cheddar

    You may also use the register -r cheddar to validate your without uploading the source distribution.

The Remote Index

Run pip using a custom index url:

pip install --index-url http://localhost:5000/simple

Note that the URL here assumes you are running the “development” server.

You can also edit your ~/.pip/pip.conf to contain the index url automatically:

index-url = http://localhost:5000/simple


Cheddar saves data in several places:

  • Local packages are stored in the LOCAL_CACHE_DIR

  • Remote packages may be cached in the REMOTE_CACHE_DIR

  • Remote version listings may be cached in Redis.

  • User data (for upload authentication) is stored in Redis.

  • Local package version listings are stored Redis.


1.2 (2014-02-21)

  • Allow remote index to work offline if cached.

1.1 (2013-11-22)

  • Add history of uploads.

  • Track uploaded timestamp.

  • Support spidering pypi links to other sites.

  • Improve sort order in UI.

1.0 (2013-11-19)

  • Initial version.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cheddar-1.4.tar.gz (27.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page