Skip to content

HarshitKumar9030/anime_recommendation_model

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎬 Anime Recommendation System

📅 Data as of 1st September 2024

This project is an Anime Recommendation System that leverages a combination of content-based filtering and collaborative filtering to suggest anime based on user preferences. Built with Flask for the backend API and a sleek front end using Tailwind CSS and JavaScript. 🌟

📁 Project Structure

  • main.py: 🧠 Script for training the anime recommendation model and generating required data files.
  • app.py: 🚀 Flask API providing endpoints for anime recommendations.
  • index.html: 🌐 Front-end interface designed with Tailwind CSS and JavaScript.
  • /: 📂 Directory containing the raw anime dataset used for model training.
  • anime_dataset: 📊 Explore anime_dataset_extended_final.csv for insights!
  • .gitignore: 🗂️ Configuration to ignore generated files from version control.

⚙️ Setup Instructions

Prerequisites

Ensure you have the following installed:

  • 🐍 Python 3.7+
  • 📦 pip (Python package manager)

Install Dependencies

Run the following command to install the required Python libraries:

pip install -r requirements.txt

Run the Flask API

Start the Flask server with:

python app.py

The server will be live at http://127.0.0.1:5000 🌍

Front-End Interface

Open index.html in your web browser to interact with the recommendation system. To avoid CORS issues, use a local HTTP server:

python -m http.server 8000

Then navigate to http://localhost:8000/index.html in your browser. 🚀

🧑‍💻 Usage

New User Recommendations

  1. Preferred Genres: Enter genres like "Action, Adventure, Romance".
  2. Liked Anime Titles: Provide a list of anime you enjoyed, such as "Attack on Titan, Black Clover, Kimi no Todoke, Horimiya, Mashle, Vinland Saga, Berserk".
  3. Click Get Recommendations to see your personalized anime list! 🎉

Existing User Recommendations

⚠️ Note: The "Existing User" recommendation feature is currently under maintenance. Please use the "New User" option for now. 🔧

🚫 Files Ignored by Version Control

Files generated during the model training process and ignored by version control (.gitignore):

  • anime_model_data.csv
  • collab_sim.npy
  • tfidf_vectorizer.pkl
  • content_sim.npy
  • simulated_user_data.csv

🚧 Current Limitations

  • The Existing User recommendation feature is under maintenance. Please use the New User option.
  • The app relies on the dataset in the / directory; model training is required before use.

🚀 To-Do

  • Fix the existing user recommendation functionality.
  • Enhance dataset quality and filtering for more accurate results.
  • Add features like user authentication and personalized profiles.

🤝 Contributing

Contributions are welcome! Feel free to submit a Pull Request to Model Repo.

📜 License

This project is licensed under the MIT License.

📬 Contact

For any inquiries or support, please contact Harshit Kumar, reach out on Instagram, or visit leoncyriac.me 🌐.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published