https://github.com/ohansemmanuel/recommender-service
🍿🍿 A movie ML recommender service built with Python.
https://github.com/ohansemmanuel/recommender-service
artificial-intelligence machine-learning python3
Last synced: 11 months ago
JSON representation
🍿🍿 A movie ML recommender service built with Python.
- Host: GitHub
- URL: https://github.com/ohansemmanuel/recommender-service
- Owner: ohansemmanuel
- Created: 2018-03-16T02:39:58.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2018-04-02T09:22:02.000Z (about 8 years ago)
- Last Synced: 2025-07-25T10:55:59.382Z (11 months ago)
- Topics: artificial-intelligence, machine-learning, python3
- Language: Python
- Homepage:
- Size: 43.3 MB
- Stars: 14
- Watchers: 1
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Introduction
You see the 'P2EM' in the Logo above? Do you have any idea what that means?
Let me help you.
P2EM refers to _"Plan to Embarass Myself"_
To understand the background story, read my article, \*
How I Plan to Embarass Myself ...
Hey, read it :)
What does this do?
If you read the article above, you should get a sense of what this is about.
The service (largely written in Python) recommends movies based on a user's previous movie ratings using Machine Learning.
Oops. That was a mouthful.
Where can I try this out?
I'm currently building out a web client where you can try this.
I'll have the link here, when there's something pretty for you to see :)
How do I run the app locally?
Yeah, I've got your back.
1. Clone the repo
```bash
git clone https://github.com/ohansemmanuel/recommender-service.git
```
2. Create a .env file
```bash
cd recommender-service
touch .env
```
3. The env file requires 4 important variables
```env
JWT_SECRET_KEY
USERNAME
PASSWORD
USER_ID
```
* JWT_SECRET_KEY is required by Flask-JWT for some encryption.
* USERNAME and PASSWORD will be used to access authorized resources. These should be **unique strings**.
* USER_ID is required, just like the username and password. This should be an **Integer**
4. Install the app dependencies
```bash
pip install
```
5. If you have some experience with Python development, you may need to have the app loaded from a virtual environment.
Where is this currently deployed?
Heroku, baby!
I should move this over to Digital Ocean for some customized control later.
If you wanna try something out, here's the endpoint for retrieving a list of movies 👉 /movies
Does this explanation suck?
I'll refactor pretty soon. Still writing out the code. It never gets completed, does it? :(
Catch you later! 👊