{"id":23564098,"url":"https://github.com/aymen016/film-recommendation-engine","last_synced_at":"2026-04-09T17:07:27.076Z","repository":{"id":269693193,"uuid":"899623526","full_name":"Aymen016/Film-recommendation-engine","owner":"Aymen016","description":"A machine learning-powered movie recommender system designed to provide personalized recommendations based on user preferences and data analysis. This project includes a backend recommendation engine, a Streamlit-based interface, and a web-based frontend for an enhanced user experience.","archived":false,"fork":false,"pushed_at":"2024-12-25T11:01:44.000Z","size":32689,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-25T11:28:31.019Z","etag":null,"topics":["flask","numpy","pandas","pickle","python","scikit-learn","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Aymen016.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-06T16:48:53.000Z","updated_at":"2024-12-25T10:59:03.000Z","dependencies_parsed_at":"2024-12-25T11:39:52.348Z","dependency_job_id":null,"html_url":"https://github.com/Aymen016/Film-recommendation-engine","commit_stats":null,"previous_names":["aymen016/film-recommendation-engine"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aymen016%2FFilm-recommendation-engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aymen016%2FFilm-recommendation-engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aymen016%2FFilm-recommendation-engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aymen016%2FFilm-recommendation-engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Aymen016","download_url":"https://codeload.github.com/Aymen016/Film-recommendation-engine/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239323665,"owners_count":19620058,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flask","numpy","pandas","pickle","python","scikit-learn","streamlit"],"created_at":"2024-12-26T17:12:43.226Z","updated_at":"2025-11-01T20:30:31.023Z","avatar_url":"https://github.com/Aymen016.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎥 Movie Recommender System\n\nA machine learning-powered system for recommending movies based on user preferences and data analysis. This repository includes both a backend recommendation engine and a frontend interface for user interaction.\n\u003cbr\u003e\n\n![Untitled design (1)](https://github.com/user-attachments/assets/5053e7f4-f5f4-4284-8731-78b42c2f7ca4)\n\n---\n\n## ✨ Features\n\n- 🔮 **Recommendation Engine**: Uses machine learning models to provide personalized movie recommendations.\n- 🖥️ **Streamlit Application**: A user-friendly interface for interacting with the recommendation system.\n- 🌐 **Frontend**: Includes the web-based frontend to provide a better user experience.\n\n---\n\n## 📂 Project Structure\n\n- `frontend/` - Frontend application code\n- `streamlit-app/` - Streamlit application files\n- `.gitattributes` - Git LFS tracking for large files\n- `Recommendation System.ipynb` - Jupyter notebook for the recommendation system\n- `app.py` - Main file for running the application\n- `dataset.csv` - Dataset used for building recommendations\n- `main.py` - Core backend logic\n- `movies_list.pkl` - Serialized movie list (Pickle format)\n\n\n## 🛠️ Prerequisites\n\nTo run this project, ensure you have the following installed:\n\n- 🐍 **Python 3.8+**\n- 🧰 **Streamlit**\n- 📦 **Required Python libraries** (listed in `requirements.txt`)\n\n---\n\n## 🚀 Installation\n\n1. **Clone this repository**:\n\n   ```bash\n   git clone https://github.com/Aymen016/Film-recommendation-engine.git\n   cd Film-recommendation-engine\n   ```\n\n2. **Install dependencies**:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **Set up Git LFS** for handling large files (if not already done):\n\n   ```bash\n    git lfs install\n   ```\n\n## 🏃 Usage\n\n  ### Run the Backend:\n  Start the backend logic by executing:\n  \n  ```bash\n  python main.py\n  ```\n\n### Run the Streamlit App:\nLaunch the Streamlit interface:\n\n  ```bash\n  streamlit run app.py\n  ```\n### Access the Frontend:\nUse the files in the `frontend/` folder to set up and serve the web-based frontend.\n\n---\n\n## 📊 Dataset\n\n- 📁 The dataset (`dataset.csv`) is used for building movie recommendations.\n- 🗂️ `movies_list.pkl` contains a preprocessed list of movies for faster recommendations.\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. 🍴 Fork the repository.\n2. 🌱 Create a new branch for your feature:\n\n   ```bash\n   git checkout -b feature-name\n   ```\n3. ✍️ Commit your changes:\n\n   ```bash\n   git commit -m \"Add feature-name\"\n   ```\n4. 🚀 Push to the branch:\n   ```bash\n   git push origin feature-name\n   ```\n5. 🛠️ Create a pull request.\n   \n---\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.\n\n---\n\n## 👨‍💻 About the Author\n\n**Aymen Baig**  \nA passionate developer and aspiring Data Scientist specializing in Machine Learning and Natural Language Processing. Experienced in building lightweight and efficient chatbot systems for small businesses. Always open to collaborations and learning new technologies.\n\n- **GitHub**: [Aymen Baig](https://github.com/Aymen016/)\n- **LinkedIn**: [Aymen Baig](https://www.linkedin.com/in/aymen-baig-700a06284/)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faymen016%2Ffilm-recommendation-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faymen016%2Ffilm-recommendation-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faymen016%2Ffilm-recommendation-engine/lists"}