• Official page: http://whiskyton.herokuapp.com/
• Authors: Eduardo Cuducos and Gabriel Vicente

This web based app uses an open database about whisky to help you find whiskys you'd probably like. It uses mathematics to run through the tastes classified in that database, and to find the best matches. We were inspired by this data visualization shared on Reddit.

This is our very first project in Python (and we are not professional coders) -- so all feedback is important to help us through our learning process. Don't hesitate to criticize our code and software design! To be true, that is what we are expecting :)

1. Get your virtualenv and PostgreSQL running.

2. Install the dependencies: $ pip install -r requirements.txt (If you have any trouble installing psycopg2 I assume it is just normal. I had a couple of them. I recommend instaling it from the source.)

3. The code is set to use SQLite locally. If you're using PostgreSQL instead, you might need to create the Whiskyton database $ sudo -u postgres createdb whiskyton (It is a good time to check if the PostgreSQL user and password are correct in the config.py file.)

4. If you already have an old version of Whiskython database, drop it $ ./db_drop_tables.py

5. Then run the following commands (you might have to give the right permissions to each file by typing chmod a+x [filename], otherwise you won't be able to execute them):

$ ./db_create.py
$ ./db_migrate.py
$ ./db_add_whisky_data.py
$ ./db_add_correlations.py

Finally ./run.py to start your server.

If you want to get rid of an older version of the cache for SVG charts, just run ./clean_chart_cache.py.

We had a lot of Python teachers, we are so glad we could count on you, guys:

• Joe Warren, Scott Rixner, John Greiner and Stephen Wong, from the An Introduction to Interactive Programming in Python course at Coursera
• Allen B. Downey and Jeff Elkner, authors of Think Python: How to Think Like a Computer Scientist
• Miguel Grinberg and his The Flask Mega-Tutorial
• Everyone who have ever contributed to The Hitchhiker’s Guide to Python!
• Everyone who helped at Reddit, mainly these guys here and here

In sum, we had the best teachers of the world in Python. Any mistake here is completely our fault.

Copyright (c) 2014 Eduardo Cuducos and Gabriel Vicente

Licensed under the MIT license (see MIT-LICENSE file)