Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A web-based file manager for people with lots of files

Project Description

Heaper is a file organizer for people with large file collections, deployed as a local web server. It allows clients of the network to manage files via their meta-data, in order to make finding specific files easier in a large quantity of them.

This software is in pre-alpha. Most things don’t work and, even if they do, the software might crash and burn anyway. Use at your own risks.

How it works

Heaper runs on a Python-enabled web server. Using the web UI, monitored locations can be added, either folders or network mounts and “collections” of different types using files from these different locations can be created. Each collection can then have meta-data for each item, either supplied by the user or scraped from an online service.


Heaper relies on Python 3 and a few extra libraries to work. These currently are:

  • Flask 0.11.1
  • SQLAlchemy 1.0.13
  • WTForms 2.1

A requirements.txt file is included, which will pull everything needed to develop Heaper using pip install -r requirements.txt. It is recommended to install the libraries and run Heaper in a virtual environment.

Contribution guidelines

This project tries to respect PEP 8 and PEP 257 as much as possible. We are aware that it is not always possible to respect them perfectly, but please use PyLint or similar code checkers to ensure that your code is somewhat conform prior to having your pull request merged.

You can find ideas of things to work on in the Issues tab.


This project uses AdminLTE by Abdullah Almsaeed for the template of the user interface.

Release History

This version
History Node


Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting