🎞️ Sum A Film

The ultimate agentic RAG platform for cinematic deep dives and narrative analysis.

Demo Video • Features • Tech Stack • Setup • Contributing

---

📽️ The Vision

Sum A Film isn't just another movie database. It's an Agentic AI Playground designed for film buffs, researchers, and casual viewers alike. By combining state-of-the-art Retrieval-Augmented Generation (RAG) with multi-agent orchestration, Sum A Film allows you to dissect narratives, compare cinematic structures across multiple films, and uncover hidden subtexts with the help of specialized AI personas.

"Film is a reflection of society, and Sum A Film is the magnifying glass." — The Architect

---

📺 Demo

🎞️ Platform Walkthrough

Click the image above to watch the deep-dive walkthrough on YouTube.

---

✨ Key Features

🧠 Agentic Deep Dives

Engage with specialized AI personas like The Critic, The Philosopher, and The Scene Creator. Each persona utilizes a unique retrieval strategy to provide insights tailored to their specific expertise.

🔍 Comparative RAG

Analyze and compare multiple films in a single session. Our RAG engine cross-references vector embeddings from different cinematic titles to highlight structural parallels and thematic contrasts.

📚 Intelligent Research Crawler

Automated agents crawl the web (including YouTube) to find high-quality video essays and archival critiques, enriching the context available for the RAG pipeline.

🎞️ Citation Highlighting

Every insight is backed by evidence. The platform highlights exact "Scene Evidence" from the transcript archive, complete with source footnotes for unverifiable claims.

---

📸 Screenshots

---

🛠️ Tech Stack

Sum A Film is built with modern, high-performance technologies:

• Frontend: Next.js 15+ (App Router), Tailwind CSS, Framer Motion
• Backend: FastAPI (Python), Uvicorn
• AI/LLM: LangGraph (Agent Orchestration), LangChain, OpenAI/Groq
• Vector DB: ChromaDB
• Database: PostgreSQL (via SQLAlchemy)
• Auth: Clerk

---

🚀 Getting Started

Prerequisites

• Node.js 18+
• Python 3.10+
• TMDB API Key
• OpenAI or Groq API Key

1. Clone the repository

git clone https://github.com/RedLordezh7Venom/FilmSumaRAG.git
cd FilmSumaRAG

2. Setup Backend

cd backend_fastapi
pip install -r requirements.txt
cp .env.example .env # Update with your API keys
python main.py

3. Setup Frontend

cd ../frontend_next
npm install
cp .env.example .env.local # Update with your Clerk & TMDB keys
npm run dev

---

🤝 Contributing

We welcome contributions! Please see our CONTRIBUTING.md for guidelines on how to get started.

---

📜 License

Distributed under the MIT License. See LICENSE.txt for more information.

---

Built with ❤️ for the love of Cinema.

Sum A Film. Analyze. Discover. Immerse.