/Ctrl_Intelligence

Ctrl Intelligence, the major group project for SEG.

Primary LanguagePythonMIT LicenseMIT

Ctrl Intelligence

Ctrl Intelligence, the major group project for SEG.

Bookwise

Link to deployed version: https://whispering-bastion-83257.herokuapp.com/

Link to deployed version (administrators): https://whispering-bastion-83257.herokuapp.com/admin/

Use the following details:

Project Structure

The main project is called system and it consists of two key applications, bookclub being the social-network side of Bookwise and recommender dealing with the dataset preprocessing.

Team Members

  • Fathima (JD) Jamal-Deen (K1922032)
  • Emma Conteh (K20045772)
  • Surma Begum (K19025208)
  • Zishan Rahman (K20071291)
  • Raisa Ahmed (K20056465)
  • Zakariya Ahmed Mohamed (K20008985)
  • Lorenzo Bonara (K20068878)
  • Yiğit Cengiz (K20077068)
  • Suhayb Yones (K20044202)
  • Brendon Zoto (K19011443)

Installation Instructions

We recommend you use Python 3.8 to run Bookwise due to a dependency (psycopg2) that fails to install in later versions of Python.

First, set up a Python virtual environment from the root of this project:

$ virtualenv venv
$ source venv/bin/activate

Then install all the required libraries needed to run Bookwise in your virtual environment:

(venv) $ pip3 install -r requirements.txt

Set up the recommender system pickle files:

(venv) $ python3 manage.py recommender

Migrate your database, then seed it to get all the data:

(venv) $ python3 manage.py makemigrations
(venv) $ python3 manage.py migrate
(venv) $ python3 manage.py seed

Finally, run the local server:

(venv) $ python3 manage.py runserver

To run the automated test suite:

(venv) $ python3 manage.py test

To see the results of the machine-learning models evaluator:

(venv) $ python3 manage.py evaluator

Sources used