Librai

Librai is a progressive web app that runs on machine learning and AI.

• It adjusts to user preferences and offers intelligent, evolving book recommendations that users will genuinely like.
• While browsing in a book store or just feeling lazy, users can scan a book cover with the Smart Camera feature and get immediate results with a personalised compatability score every time.

Available at librai.netlify.app

App demo video

Here is the original app demo video on Youtube:

Getting started

1. Clone this repo

git clone https://github.com/geroalexander/librai

2. Navigate into both client and server folders and install dependencies

npm install

3. Refer to the below section Setup Prequisites for instructions on how to configure environment variables

• See client/.env.example and server/.env.example for an example of how the variables should be named

4. After the setup, start the app!

• Navigate into client and run npm start
• Navigate into server and run nodemon or node index.js

Optional

• Populate the DB by running npm run populate from the server folder.
• Log into the app with 'pams@hollywood.com' as the email and 'password' as the password.
• Enjoy!

Setup Prerequisites

First, create a .env in both client and server

Database

• Ensure you have docker installed and run the following command

docker-compose up -d

• Refer to server/.env.example to configure local environment variables such as DB_NAME, DB_PORT, etc.

APIs

Setup an account and get an API key from the following sources:

• Google Books
• Google Cloud Vision AI
• Recombee
• Cloudinary

OAuth

• Configure an OAuth consent screen and get a client ID from Google Cloud Platform

Tech Stack

Frontend

• React (PWA setup)
• Typescript
• Redux
• Sass
• Lottie

Backend

• Node.js
• Express
• Sequelize
• PostgreSQL
• Docker

CI/CD

• Github Actions

Deployment

• Heroku (server)
• Netlify (client)

Authentication

• Google OAuth

APIs

• Google Books
• Google Cloud Vision AI
• Recombee
• Cloudinary

Contributors ✨

Github's and LinkedIn's linked below! (emoji key)

Pamela Chen 💻 🤔 📆 🎨

Andras Varadi 💻 🔣 🔧

Ben Pearce 💻 🚇⚠️

Gero Kassing 💻 🚇🛡️ 📹

Big thanks to Team Librai.