metadata
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
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
POST /api/movie
{ "user_query": "මට avatar ෆිල්ම් එක බලන්න ඕනේ" }
GET /api/status
Returns assistant info, version, and Gradio toggle state.
POST /api/admin/gradio-toggle
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 |
HF_TOKEN |
HuggingFace Token (read) |
ADMIN_KEY |
Your chosen secret for the Gradio toggle endpoint |
📐 Response Shape
{
"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