---
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.