srdg / goodreadsrec

A book recommender system using the Goodreads API. Deployed on heroku with Flask.

Home Page:http://goodreadsrec.herokuapp.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

goodreadsrec

Project Description

  • A book recommender system using the Goodreads API

Contributing Guidelines

Please read the contribution guidelines carefully at CONTRIBUTING.md.

About This Project

  • This is a basic web application for a book recommendation system. It uses the python wrapper of the Goodreads API to show a list of recommended books to the user, given the book ID in goodreads.

Installation

git clone https://github.com/srdg/goodreadsrec.git
cd goodreadsrec
pip3 install -r requirements.txt
python3 app.py

Start Local Server

  • Go over to the Goodreads API and register a dummy application to get your own developer token and key. (You need to create an account first, though.)

  • Use the token and the key in app.py:L5 to connect your goodreads client to the API. Alternatively, to set the token/key via command line -

Linux

export GCLIENT_TOKEN="your-goodreads-token-here"  
export GCLIENT_KEY="your-goodreads-key-here"

Windows

setx GCLIENT_TOKEN "your-goodreads-token-here"   
setx GCLIENT_KEY="your-goodreads-key-here"

Open localhost on port 5000 and you should be able to see the app deployed in your local system.

Live Demo

  • The app is currently deployed on heroku. Continuous integration is enabled.

About

A book recommender system using the Goodreads API. Deployed on heroku with Flask.

http://goodreadsrec.herokuapp.com

License:MIT License


Languages

Language:HTML 79.7%Language:CSS 12.9%Language:Python 7.4%