Project Info
Find your perfect movie or TV series without endless scrolling. We've all experienced the same problem. We open Netflix, Prime Video, Disney+, or another streaming platform hoping to relax, but instead spend 20β30 minutes scrolling through hundreds of titles without deciding what to watch. Most recommendation systems rely heavily on watch history, trending content, or basic genre filtering. While useful, they often fail to understand what a user actually wants to watch at that specific moment. Sometimes you're looking for an emotional story. Sometimes you want a mind-bending thriller. Sometimes you just need a light comedy after a long day. That simple problem inspired CineMatch AI. Instead of making users search through thousands of movies and TV series, CineMatch AI tries to understand their preferences through an interactive conversation and continuously improves recommendations as more information becomes available. CineMatch AI is an intelligent entertainment discovery platform that recommends: π¬ Movies πΊ TV Series π TV Dramas πΏ Anime π Documentaries π International Content Rather than presenting users with endless filters, CineMatch AI gradually builds a preference profile by asking adaptive questions. Every answer helps refine the recommendation engine, making suggestions more accurate over time. Traditional recommendation systems usually work like this: CineMatch AI follows a different philosophy. Instead of removing movies through strict filters, every answer adjusts the ranking of all candidates. The more the user interacts, the better the recommendations become. Adaptive questionnaire instead of long static forms Real-time recommendation updates Progressive preference learning Explainable recommendations Rich movie information Responsive UI Modern user experience Dynamic ranking engine The user starts with a few basic questions. Every answer updates a continuously evolving preference profile. The recommendation engine recalculates match scores instantly. Movies and TV shows are re-ranked in real time. Users can open any recommendation to view detailed information before deciding what to watch. No unnecessary searching. No endless scrolling. Just personalized recommendations. CineMatch AI is designed around one core principle: Recommendations should become betterβnot disappearβas users answer more questions. Instead of filtering everything out, every answer contributes to a weighted recommendation score. The system evaluates factors such as: Genres Themes Mood Runtime Language Story complexity IMDb preference Emotional tone Watching context Content to avoid These signals work together to continuously improve ranking quality. Recommendations shouldn't feel random. Every recommendation includes a short explanation describing why it matches the user's preferences. Example: "This movie ranks highly because it combines psychological suspense, intelligent storytelling, and emotional depth while matching your preferred language and runtime." This makes the recommendation process transparent and easier to trust. Frontend Next.js React TypeScript Tailwind CSS Framer Motion shadcn/ui Backend Node.js REST APIs Recommendation Engine Progressive user profiling Weighted scoring Semantic matching Explainable recommendations Smart caching Building CineMatch AI involved several challenges. The biggest challenge was designing a recommendation engine that updates recommendations instantly while keeping the interface responsive. Another challenge was ensuring that recommendations become increasingly accurate without becoming too restrictive. Balancing responsiveness, scalability, and recommendation quality required multiple iterations of the recommendation pipeline. Developing CineMatch AI taught me that recommendation systems are much more than simple filters. Throughout this project I learned: Recommendation system design Progressive user profiling Scalable frontend architecture Explainable recommendation logic State management Performance optimization Modular software architecture This project is only the beginning. Planned improvements include: Semantic analysis of audience reviews AI-powered adaptive conversations Better understanding of story themes Group recommendations Personalized watchlists Streaming platform availability Voice interaction Natural language search Regional recommendations Improved multilingual support The long-term vision is to transform CineMatch AI into an intelligent entertainment companion that understands every user's unique preferences. CineMatch AI was built around one simple idea: People should spend less time searching and more time enjoying great stories. This project combines adaptive questioning, progressive recommendation ranking, explainable results, and a modern user experience to create a smarter way of discovering movies and TV shows. While this version is an MVP, it lays the foundation for a much more capable AI-powered entertainment discovery platform in the future.
π¬ CineMatch AI β OpenAI Build Week Challenge Submission
Next-Gen Interactive Movie & Show Discovery Engine powered by GPT-5.6 & Codex
π Submission Overview
| Submission Field | Details |
|---|---|
| Project Name | CineMatch AI |
| Challenge | OpenAI Build Week Challenge (July 2026) |
| Track | Apps for your life |
| Submission Category | Consumer Apps for Everyday Life β Entertainment & Decision-Fatigue Elimination |
| Code Repository | Private/Public GitHub Repository (Shared with testing@devpost.com & build-week-event@openai.com) |
| Demo Video | Watch Demo Video on YouTube (< 3 min demo video covering project workflow & Codex/GPT-5.6 usage) |
| Codex Session ID | /feedback Session ID: codex-cinematch-ai-build-week-2026 |
π What is CineMatch AI?
CineMatch AI is an intelligent, zero-scrolling movie and TV series recommendation platform engineered to end decision fatigue. Instead of endless list browsing or rigid genre filters, CineMatch AI engages users with adaptive, multi-dimensional queries (mood, thematic pacing, visual style, runtime preferences) and synthesizes personalized watch recommendations powered by semantic matching, dynamic confidence scoring, and AI explanation generation.
π Key Features
- Adaptive Preference Engine: Asks intelligent, contextual questions that adapt dynamically based on your previous answers.
- Hybrid Semantic & Scoring Algorithm: Combines direct keyword extraction, genre weightings, and real-time metadata calculation for high-confidence match scores.
- OMDb API Integration & Live Enrichment: Augments local catalog items with real-time posters, IMDb ratings, plot summaries, and awards metadata.
- AI Explanation Generation: Explains why a particular title was picked specifically for you based on your unique choices.
- Sleek, Premium Dark-Theme UI: Built with Next.js 15 App Router, Tailwind CSS, Lucide Icons, and Framer Motion micro-animations.
- Zero Cold-Start / Offline Fallback: Features a rich built-in movie dataset so judges and users can test instantly without mandatory API keys.
π― Challenge Track
Track: Apps for your life
CineMatch AI directly targets a universal everyday problem: streaming decision paralysis. By transforming title discovery into an engaging, interactive conversation and instant visual recommendation deck, it delivers a delightful everyday consumer app experience.
π οΈ How GPT-5.6 and Codex Were Used
Developing CineMatch AI end-to-end within the hackathon timeframe was made possible through deep collaboration with Codex powered by GPT-5.6.
β‘ Where Codex Accelerated Development
- Architectural Scaffolding: Rapidly generated the full Next.js 15 App Router directory layout, custom hooks, and modular service handlers (
lib/recommendation-engine.ts,lib/scoring.ts,lib/omdb.ts). - Algorithm Engineering: Formulated and refined the multi-layered score calculator (
lib/score-calculator.ts) combining base genre weights, semantic tag overlap, and confidence metrics. - API Integration & Resilience: Implemented seamless fallback mechanisms between OMDb API queries and offline JSON data (
data/movies.ts&data/movies.json). - UI Component Design: Crafted modern glassmorphism UI components with dynamic page transitions and responsive layouts (
components/hero.tsx,components/recommendation-card.tsx).
π‘ Key Decisions Made with Codex & GPT-5.6
- Adaptive vs. Fixed Questionnaires: Codex suggested switching from static multi-choice forms to an adaptive question graph (
data/adaptive-questions.ts), improving recommendation accuracy while keeping user interaction brief. - Transparent Confidence Scores: Integrated a transparent confidence meter (
lib/recommendation-confidence.ts) to build user trust in AI-curated choices. - Decoupled Data Providers: Designed modular content provider abstractions (
lib/content-provider.ts) so metadata sources can be swapped or augmented seamlessly.
ποΈ Project Architecture & Data Flow
[ User Prompt / Adaptive Quiz ]
β
βΌ
[ Preference Normalizer ] βββΊ (lib/normalizer.ts)
β
βΌ
[ Semantic Matcher & Scoring ] βββΊ (lib/semantic-matcher.ts & score-calculator.ts)
β
ββββββββββββββββββββββββββββ
βΌ βΌ
[ Local Data Fallback ] [ OMDb API Enrichment ]
(data/movies.ts) (lib/omdb.ts)
β β
ββββββββββββββ¬ββββββββββββββ
βΌ
[ AI Explanation & Confidence ] βββΊ (lib/explanation-generator.ts)
β
βΌ
[ Next.js Interactive UI ] βββΊ (app/recommendations/page.tsx)
π» Quick Start & Setup Instructions
Follow these step-by-step instructions to set up and run CineMatch AI locally.
Prerequisites
- Node.js: v18.17.0 or higher
- npm or pnpm / yarn
1. Clone & Navigate to Repository
git clone https://github.com/your-username/cinematch-ai.git
cd "CineMatch AI"
2. Install Dependencies
npm install
3. Environment Variables (Optional)
CineMatch AI works out-of-the-box using built-in sample data. To enable live OMDb movie poster and rating enrichment, create or update .env.local in the root directory:
OMDB_API_KEY=your_omdb_api_key_here
OPENAI_API_KEY=your_openai_api_key_here
4. Run Development Server
npm run dev
Open http://localhost:3000 in your browser to test the application.
5. Typecheck & Build Validation
# Verify TypeScript types
npm run typecheck
# Production Build
npm run build
π Sample Data & Testing Guidance for Judges
To facilitate effortless testing by Devpost and OpenAI judges:
- Immediate Playability: You do not need an external API key to run and evaluate CineMatch AI. The project includes high-quality sample datasets located in:
data/movies.ts&data/movies.json: Curated dataset with genres, themes, cast, and plot points.data/questions.json&data/adaptive-questions.ts: Pre-configured adaptive questionnaire tree.
- Interactive Flow:
- Navigate to the homepage at
/. - Click "Find My Match" to start the interactive quiz flow.
- Answer preference prompts regarding mood, pacing, and genre.
- Explore the personalized recommendation deck complete with confidence scores, stream matches, and personalized AI explanations.
- Navigate to the homepage at
π€ Repository Access for Judges
This repository has been configured and shared for hackathon evaluation:
- Shared with Devpost Testing Team:
testing@devpost.com - Shared with OpenAI Event Team:
build-week-event@openai.com
π License
Distributed under the MIT License. See LICENSE for more information.
Analysis
View
Metric
- 1
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- CSSIn code
- Next.jsIn code
- ReactIn code
- Tailwind CSSIn code
- TypeScriptIn code
- JavaScriptClaimed
- Node.jsClaimed
5 of 7 appear in the indexed code. 2 claimed on Devpost could not be matched to code, which may simply mean the tool leaves no trace in the repository.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
146 KB
Source files
66
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
UltraV1be/CineMatch-AI
76 files Β· 305 KB Β· @ d6556c2
Structure
Interface
20 files Β· 26%Screens, components and styles rendered to the user.
API & routing
3 files Β· 4%Request entry points: routes, handlers and controllers.
Application logic
43 files Β· 57%Domain rules, services and shared utilities.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here β open the file browser to check anything the diagram implies.
Languages
- TypeScript94%
- Markdown5%
- CSS0%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
package.json
npm Β· 17- class-variance-authority
- clsx
- framer-motion
- lucide-react
- next
- react
- react-dom
- tailwind-merge
- +9 more
Declared in the repositoryβs manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
This projectβs features have not been analysed yet.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.