{"id":31751855,"url":"https://github.com/subhadipsinha722133/book-recommender-system","last_synced_at":"2025-10-09T16:33:21.430Z","repository":{"id":315626026,"uuid":"1025515499","full_name":"subhadipsinha722133/Book-Recommender-System","owner":"subhadipsinha722133","description":"🤖 Book Recommender System is a machine learning application designed to suggest books to users based on their preferences, reading history, and other relevant data. ","archived":false,"fork":false,"pushed_at":"2025-09-19T18:20:57.000Z","size":13975,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-19T18:45:23.626Z","etag":null,"topics":["clustering","data-visualization","machine-learning","recommendation-system","sklearn"],"latest_commit_sha":null,"homepage":"https://book-recommender-system-3jmjygcbcv6he9yovvmgxw.streamlit.app/","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/subhadipsinha722133.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-24T11:22:15.000Z","updated_at":"2025-09-19T18:23:21.000Z","dependencies_parsed_at":"2025-09-19T18:56:40.019Z","dependency_job_id":null,"html_url":"https://github.com/subhadipsinha722133/Book-Recommender-System","commit_stats":null,"previous_names":["subhadipsinha722133/book-recommender-system"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/subhadipsinha722133/Book-Recommender-System","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subhadipsinha722133%2FBook-Recommender-System","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subhadipsinha722133%2FBook-Recommender-System/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subhadipsinha722133%2FBook-Recommender-System/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subhadipsinha722133%2FBook-Recommender-System/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/subhadipsinha722133","download_url":"https://codeload.github.com/subhadipsinha722133/Book-Recommender-System/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subhadipsinha722133%2FBook-Recommender-System/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001776,"owners_count":26083173,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["clustering","data-visualization","machine-learning","recommendation-system","sklearn"],"created_at":"2025-10-09T16:31:57.379Z","updated_at":"2025-10-09T16:33:21.422Z","avatar_url":"https://github.com/subhadipsinha722133.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# 📚 Book Recommendation System\n\n![Streamlit](https://img.shields.io/badge/Streamlit-FF4B4B?style=for-plastic\u0026logo=Streamlit\u0026logoColor=white)\n![Python](https://img.shields.io/badge/Python-3776AB?style=for-plastic\u0026logo=python\u0026logoColor=white)\n![Machine Learning](https://img.shields.io/badge/ML-FF6F00?style=for-plastic\u0026logo=scikitlearn\u0026logoColor=white)\n![Pandas](https://img.shields.io/badge/Pandas-150458?style=for-plastic\u0026logo=pandas\u0026logoColor=white)\n\nA beautiful and interactive book recommendation system built with Streamlit that suggests books based on collaborative filtering! 🌟\n\n## ✨ Features\n\n- 🏠 **Popular Books Dashboard** - Discover trending books with ratings and reviews\n- 🔍 **Smart Recommendations** - Get personalized book suggestions\n- 📊 **Visual Interface** - Beautiful book covers and organized layout\n- ⚡ **Real-time Results** - Instant recommendations with just one click\n- 📱 **Responsive Design** - Works perfectly on desktop and mobile\n\n\n## 📺 Live Demo \n\n🔗 [Demo Link](https://book-recommender-system-3jmjygcbcv6he9yovvmgxw.streamlit.app/)\n\n- 🎬 Demo Video\n  \u003cimg src=\"https://github.com/subhadipsinha722133/Book-Recommender-System/blob/main/demo___.gif\"\u003e \n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Python 3.8+\n- pip package manager\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/subhadipsinha722133/Book-Recommender-System.git\n   cd book-recommendation-system\n   ```\n\n2. **Create virtual environment** (optional but recommended)\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # On Windows: venv\\Scripts\\activate\n   ```\n\n3. **Install dependencies**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Place your data files** in the project directory:\n   - `popular.pkl`\n   - `pt.pkl`\n   - `books.pkl`\n   - `similarity_scores.pkl`\n\n5. **Run the application**\n   ```bash\n   streamlit run main_app.py\n   ```\n\n6. **Open your browser** and go to `http://localhost:8501`\n\n## 🎯 How to Use\n\n1. **Home Page** 🏠: Browse popular books with their covers, authors, and ratings\n2. **Recommendations Page** 🔍: Select a book from the dropdown to get similar recommendations\n3. **Explore** 🔎: Click through different books and discover new reading options!\n\n## 🛠️ Technologies Used\n\n- **Frontend**: Streamlit 🎈\n- **Backend**: Python 🐍\n- **Data Processing**: Pandas, NumPy 📊\n- **Machine Learning**: Scikit-learn 🤖\n- **Image Handling**: Pillow 🖼️\n\n## 📁 Project Structure\n\n```\nbook-recommendation-system/\n├── main_app.py                 # 🎯 Main Streamlit application\n├── requirements.txt       # 📦 Python dependencies\n├── README.md             # 📖 This file\n├── popular.pkl           # 📊 Popular books data\n├── pt.pkl               # 🔢 Pivot table data\n├── books.pkl            # 📚 Books metadata\n└── similarity_scores.pkl # 💫 Precomputed similarity scores\n```\n\n## 🎨 Customization\n\nWant to customize this app? Here's what you can modify:\n\n- **Colors \u0026 Theme**: Edit Streamlit configuration in `app.py`\n- **Layout**: Adjust the column structure in the UI functions\n- **Data**: Replace the pickle files with your own dataset\n- **Styling**: Add custom CSS through Streamlit's markdown features\n\n## 🤝 Contributing\n\nWant to contribute? Awesome! 🎉\n\n1. Fork the project\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 📧 Contact\n\n**Subhadip Sinha** 👨‍💻  \n- GitHub: [@subhadipsinha722133](https://github.com/subhadipsinha722133)  \n- Email: sinhasubhadip34@gmail.com  \n\n## 🙏 Acknowledgments\n\n- Book data sources and datasets\n- Streamlit community for amazing documentation\n- Open-source contributors\n\n---\n\n⭐ **If you like this project, give it a star on GitHub!** ⭐\n\nMade with ❤️ by Subhadip Sinha\n\nThis README includes:\n\n1. **Your personal details** with username `subhadipsinha722133`\n2. **Lots of emojis** throughout the document (📚✨🚀🎯🛠️ etc.)\n3. **Comprehensive sections** covering all aspects of the project\n4. **Badges** for technologies used\n5. **Clear installation instructions**\n6. **Visual structure** with proper formatting\n7. **Customization guide** for future modifications\n8. **Contact information** section\n\nYou can customize it further by adding your actual email, portfolio link, or any other personal details you'd like to share!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubhadipsinha722133%2Fbook-recommender-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsubhadipsinha722133%2Fbook-recommender-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubhadipsinha722133%2Fbook-recommender-system/lists"}