| --- |
| title: Saumya Movie AI Assistant |
| emoji: 🎬 |
| colorFrom: purple |
| colorTo: pink |
| sdk: docker |
| app_port: 7860 |
| pinned: false |
| --- |
| |
| # 🎬 Saumya — AI Movie & TV Show Assistant |
|
|
| **Created by Samith Dilshan** · Supports English & Sinhala 🇱🇰 |
|
|
| Saumya is an intelligent movie and TV show assistant powered by **Mistral-7B** via HuggingFace. |
| Ask about any film or series and get AI-generated summaries, genre info, and download links — in **English or Sinhala**. |
|
|
| --- |
|
|
| ## ✨ Features |
|
|
| | Feature | Details | |
| |---|---| |
| | 🎬 Movie search | Natural language — *"I want to watch Inception"* | |
| | 📺 TV show support | Series, episodes, seasons | |
| | 🇱🇰 Sinhala support | Full bilingual (EN / SI) | |
| | 🤖 AI summaries | Emotional, engaging — not boring translations | |
| | 📥 Download links | Quality + size from movie database | |
| | 💬 General QA | Ask anything movie/show related | |
| | 🎯 Recommendations | *"Suggest a good thriller"* | |
|
|
| --- |
|
|
| ## 🔌 REST API Endpoints |
|
|
| ### GET `/api/chat` |
| ``` |
| GET /api/chat?q=Tell me about Breaking Bad |
| GET /api/chat?q=මට Inception ෆිල්ම් ගැන කියන්න |
| ``` |
|
|
| ### POST `/api/chat` |
| ```json |
| POST /api/chat |
| { "query": "Recommend a horror movie" } |
| ``` |
|
|
| ### GET `/api/movie` |
| ``` |
| GET /api/movie?user_query=Avatar |
| GET /api/movie?imdb_id=tt0499549 |
| ``` |
|
|
| ### POST `/api/movie` |
| ```json |
| POST /api/movie |
| { "user_query": "මට avatar ෆිල්ම් එක බලන්න ඕනේ" } |
| ``` |
|
|
| ### GET `/api/status` |
| Returns assistant info, version, and Gradio toggle state. |
|
|
| ### POST `/api/admin/gradio-toggle` |
| ```json |
| POST /api/admin/gradio-toggle |
| { "admin_key": "your_secret", "enabled": false } |
| ``` |
|
|
| ### Swagger UI |
| `GET /api/docs` |
|
|
| --- |
|
|
| ## 🔑 Required Secrets (HF Space Settings → Secrets) |
|
|
| | Secret | Description | |
| |---|---| |
| | `TMDB_API_KEY` | [TMDb API Key](https://www.themoviedb.org/settings/api) | |
| | `HF_TOKEN` | [HuggingFace Token](https://huggingface.co/settings/tokens) (read) | |
| | `ADMIN_KEY` | Your chosen secret for the Gradio toggle endpoint | |
|
|
| --- |
|
|
| ## 📐 Response Shape |
|
|
| ```json |
| { |
| "intent": "movie", |
| "poster": "https://...", |
| "movie_name": "Inception", |
| "categories": ["Action", "Sci-Fi", "Thriller"], |
| "download_links": [ |
| { "quality": "1080p", "url": "...", "size": "2.1 GB" } |
| ], |
| "response_language": "en", |
| "message": "Saumya's AI-generated summary..." |
| } |
| ``` |
|
|
| --- |
|
|
| *Built with FastAPI · Gradio · TMDb API · HuggingFace Inference* |
|
|
