ProgressAyere/naija-review-agent

This is a Multi-agent AI system simulating Nigerian personas to generate culturally authentic reviews and provide personalized recommendations across 5 categories using LangChain and Groq LLMs. # 🇳🇬 Naija Review Agent > **AI-Powered Nigerian Review Simulator & Recommendation Engine** > Generate authentic Nigerian-style reviews and personalized recommendations using culturally-aware LLM agents. --- ## 📋 Table of Contents - Overview - Architecture - Features - Tech Stack - Project Structure - Getting Started - API Documentation - Agentic Workflows - Cultural Context System - Development - Deployment - Contributing - License --- ## 🎯 Overview **Naija Review Agent** is a multi-agent AI system that understands and generates authentic Nigerian-style content. The system consists of two specialized agents: ### **Agent A: Review Simulator** 🎭 Generates culturally authentic Nigerian reviews using persona-based prompting and Nigerian English patterns (including Pidgin). Perfect for: - Testing review systems with realistic Nigerian user data - Understanding Nigerian consumer sentiment patterns - Training models on Nigerian English and cultural expressions ### **Agent B: Recommendation Engine** 💡 Provides personalized recommendations using ReAct (Reasoning + Acting) agent architecture with Nigerian cultural context. Features: - Cold-start recommendations for new users - Multi-turn conversational recommendations - City-specific and persona-aware suggestions --- ## 🏗️ Architecture ``` ┌─────────────────────────────────────────────────────────────┐ │ Frontend (React) │ │ Vite + TailwindCSS + React Router │ └────────────────┬────────────────────────────────────────────┘ │ │ HTTP/REST │ ┌────────────┴────────────┐ │ │ ▼ ▼ ┌─────────────┐ ┌─────────────┐ │ Agent A │ │ Agent B │ │ (Port 3001)│ │ (Port 3002)│ │ │ │ │ │ Review │ │ Recommend │ │ Simulator │ │ Engine │ └──────┬──────┘ └──────┬──────┘ │ │ │ ┌──────────── …