DevMubarak1/naija-review-ai

LLM Agent for User Modeling & Personalized Recommendation - DSN x BCT Hackathon 3.0 # NaijaReview AI **LLM Agent for User Modeling & Personalized Recommendation** > Team Cerebral — DSN × BCT Data & AI Summit Hackathon 3.0 --- ## Overview NaijaReview AI is an agentic AI system that deeply understands users as dynamic, context-sensitive individuals and generates culturally-aware reviews and hyper-personalized recommendations. The system is contextualized for Nigerian users, incorporating Nigerian English (Pidgin), cultural references, and local preferences. ### Key Features - **Task A — User Modeling**: Generates realistic reviews and ratings by learning each user's writing style, tone, and rating behavior - **Task B — Recommendation**: Delivers personalized recommendations using RAG, agentic reasoning, and cross-domain understanding - **Nigerian Contextualization**: Authentic Nigerian English/Pidgin adaptation with cultural references - **Multi-turn Conversation**: Interactive chat interface for discovering recommendations - **Cold-Start Handling**: Works even for new users with minimal history ## Architecture ``` ┌─────────────────────────────────────────────────┐ │ Streamlit Web UI │ ├─────────────────────────────────────────────────┤ │ FastAPI Backend │ ├────────────────────┬────────────────────────────┤ │ Task A Agent │ Task B Agent │ │ ┌──────────────┐ │ ┌──────────────────────┐ │ │ │Persona Builder│ │ │Preference Extractor │ │ │ │Review Generator│ │ │Candidate Retriever │ │ │ │Rating Predictor│ │ │Reasoning Re-Ranker │ │ │ │Naija Localizer│ │ │Cold-Start Handler │ │ │ └──────────────┘ │ │Conversational Engine │ │ │ │ └──────────────────────┘ │ ├────────────────────┴────────────────────────────┤ │ Shared Infrastructure │ │ ChromaDB │ Embeddings │ Memory │ LLM Client │ └─────────────────────────────────────────────────┘ ``` ## Quick Start ### Option 1: Docker (Recommended) …