Skip to content
Combining the power of D3.js and your Untappd checkin history, because why not?
Python JavaScript CSS
Branch: master
Clone or download
Pull request Compare This branch is 37 commits ahead of pezholio:gh-pages.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


This is a Flask app that uses Untappd's API and D3.js to visualize your Untappd history.

Running a local instance

To run a local instance of D3-Beer you'll need Python 2.7, pip, and virtualenv. Once you have those, clone this repository:

git clone
cd D3-Beer

Create and activate a virtualenv:

virtualenv flask
source flask/bin/activate # Linux/OS X
"flask/Scripts/activate" # Windows

Install the requirements:

pip install -r requirements.txt

If you're using Windows, you may get an error psycopg2. You don't need it because it's for Heroku which uses PostgreSQL instead of SQLite which is used when the app is deployed locally. If you're really annoyed by the error, then run this and it should install it without errors (If you get a 404, then visit and get the url for the latest python2.7 release):


You will need to register an new app with Untappd and copy your client id and client secret in of the Untappd directory.

Once everything is installed initiate a local db and run the app:


Deploying to Heroku

Login to Heroku in your console and create a new app:

heroku login
heroku create APP-NAME

Change the redirect url in your Untappd App's menu and in in the Untappd directory.

Push to Heroku, change the environment variable for HEROKU to 1, and create a new PostgreSQL DB:

git add -A
git commit -m "COMMIT MESSAGE"
git push heroku master

Start a free PostgreSQL db on Heroku and initiate your db:

heroku addons:add heroku-postgresql:dev
heroku run createdb

And you should be good to go!

Note: The free postgresql database will probably fill up pretty quick since it's only 10000 rows, but it should be fine if you don't plan on having more than 10 people use the app.

You can’t perform that action at this time.