File size: 2,457 Bytes
cdee5aa 7901dd6 fa4b610 cdee5aa 83ef767 386b561 cdee5aa 7901dd6 6d2d0f9 cdee5aa 8cc2408 cdee5aa |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 |
---
title: Personalized Movie Recommender Assistant
emoji: 🎬
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.33.1
app_file: app.py
pinned: false
license: apache-2.0
short_description: Your Al Movie Buddy tailored to your watching habits
tags:
- agent-demo-track
---
# 🎬 Personalized Movie Recommender
A chatbot-style movie recommendation system built for the [🤖 Gradio Agents & MCP Hackathon 2025 🚀](https://huggingface.co/Agents-MCP-Hackathon).
This project leverages the powerful Google `gemma-2b-it` model (quantized to 4-bit for speed and efficiency), FastAPI for serving, and Gradio for an engaging interactive UI.
---
## 🚀 Features
✅ **Personalized Movie Recommendations**
- Understands user’s mood and genre preferences to deliver tailored suggestions.
- Fully customizable: choose the agent’s personality, expertise level, and response language.
✅ **Gemma-2B-It Integration**
- Efficient 4-bit quantized loading using `bitsandbytes`.
- Runs on H100 GPUs for blazing-fast inference.
✅ **Multilingual Support**
- Supports English, Korean, and Japanese.
---
## 🏗️ Architecture
- **Backend**: FastAPI app deployed on Modal with GPU acceleration.
- **Model**: Google’s `gemma-2b-it` with 4-bit quantization.
- **Frontend**: Gradio chatbot UI for a natural conversation experience.
- **Infrastructure**: Modal’s NetworkFileSystem for model caching and deployment.
---
## 🔧 How to Use
### Modal Deployment
1. **Set up secrets**: Store your `modal-key` secret.
2. **Deploy**:
```bash
modal deploy
Local Development
1. Install dependencies:
pip install torch transformers accelerate einops huggingface_hub bitsandbytes fastapi gradio requests
2. Run locally:
python app.py
⸻
🪄 Live Demo
A video overview of the app in action:
👉 Watch here! (replace with your video recording link)
⸻
🏷️ Hackathon Track
This project participates in the Agentic Demo Showcase.
⸻
🧑💻 Team
• Jadob
⸻
📜 License
This project is licensed under the MIT License.
⸻
🌟 Acknowledgments
• Thanks to the 🤖 Gradio Agents & MCP Hackathon 2025 🚀 team and sponsors for organizing this event.
• Huge shoutout to Hugging Face, Modal, and all the contributors to open-source tools powering this project.
⸻
💡 This project was built from scratch during the Hackathon week, following all official rules and submission guidelines.
|