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!

Flask extension that creates a simple interface to Bitmapist analytics library

Project Description

Flask extension that creates a simple interface to the Bitmapist analytics library.


Bitmapist is:

[A] Python library [that] makes it possible to implement real-time, highly scalable analytics that can answer the following questions:

  • Has user 123 been online today? This week? This month?
  • Has user 123 performed action “X”?
  • How many users have been active this month? This hour?
  • How many unique users have performed action “X” this week?
  • What % of users that were active last week are still active?
  • What % of users that were active last month are still active this month?
  • Which users performed action “X”?


$ pip install flask-bitmapist


Example app:

from flask import Flask
from flask_bitmapist import FlaskBitmapist, mark

app = Flask(__name__)

flaskbitmapist = FlaskBitmapist()

@mark('index:visited', 1)  #
def index():
    """using the mark decorator, the first argument is the event
       and the second is the id of the current_user
    return 'Hello, world!'

if __name__ == '__main__':

For documentation on the mark decorator, look at the mark_event Bitmapist function.


Name Type Description
BITMAPIST_REDIS_SYSTEM string Name of Redis System; defaults to default
BITMAPIST_REDIS_URL string URL to connect to Redis server; defaults to redis://localhost:6379
BITMAPIST_TRACK_HOURLY boolean Tells Bitmapist to track hourly; can also be passed to mark (e.g., @mark('active', 1, track_hourly=False))
BITMAPIST_DISABLE_BLUEPRINT boolean Disables registration of default Bitmapist Blueprint

Cohort Blueprint

One of the nice things about Bitmapist is its simple bit operations API and the data cohort that you get. For more information about the cohort, visit the Bitmapist README.

When you initialize the flask-bitmapist extension, a blueprint is registered with the application.

Name Path Description
index /bitmapist/ Default Bitmapist index
cohort /bitmapist/cohort Demo cohort retrieval and heatmap generation


To run the tests, ensure that you have Redis running on port 6399:

$ redis-server --port 6399

Then you can simply run:

$ python test

To seed fake data for testing, run:

$ python scripts/


The full Flask-Bitmapist documentation is available at ReadTheDocs.


If you’re interested in contributing to Flask-Bitmapist, get started by creating an issue here. Thanks!

Release History

0.1.0 (2016-03-30)

  • First release.
Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
Flask-Bitmapist-0.1.2.tar.gz (16.9 kB) Copy SHA256 Checksum SHA256 Source Sep 14, 2016

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